GET /relay/:id — Relay Transaction Details

Use this endpoint to inspect the relay transaction associated with an approved sponsorship request. A relay transaction is created when a sponsorship moves from approved to relayed status. You can use it to track whether the on-chain transaction has been broadcast and confirmed.

Request

GET /relay/:id

string

required

UUID of the relay transaction record. This is distinct from the sponsorship request ID — obtain it from the relay record linked to your sponsorship.

Response

string

required

UUID of this relay transaction record.

string

required

UUID of the sponsorship request that triggered this relay. Use this to correlate the relay with the originating request.

string

required

Current status of the relay transaction. See the status table below.

integer

required

Number of times relay submission has been attempted for this record. Starts at 1 on first submission.

string

On-chain transaction hash once the transaction has been broadcast, or null if it has not been submitted yet.

string

ISO 8601 timestamp of when the transaction was first broadcast to the network, or null if not yet submitted.

string

ISO 8601 timestamp of when the transaction was mined and confirmed, or null if not yet confirmed.

string

ISO 8601 timestamp of when the relay entered a failed state, or null if it has not failed.

string

Human-readable description of why the relay failed, or null if there is no failure.

Relay status values

Status	Meaning
`queued`	The relay is waiting to be submitted on-chain. The transaction has not been broadcast yet.
`submitted`	The transaction has been broadcast to the network and is awaiting mining.
`confirmed`	The transaction has been mined and confirmed on-chain.
`failed`	The relay encountered an error. Check `failureReason` and `failedAt` for details.

Errors

Status	Cause
`400`	The `:id` is not a valid UUID format.
`404`	No relay transaction found with the given ID.

curl --request GET \
  --url https://api.arcpass.io/relay/c9d8e7f6-b5a4-3210-fedc-ba9876543210

{
  "id": "c9d8e7f6-b5a4-3210-fedc-ba9876543210",
  "sponsorshipRequestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "submitted",
  "relayAttempt": 1,
  "transactionHash": "0xdeadbeefcafe1234567890abcdef1234567890abcdef1234567890abcdef1234",
  "submittedAt": "2025-05-11T10:31:05.000Z",
  "confirmedAt": null,
  "failedAt": null,
  "failureReason": null
}

{
  "id": "c9d8e7f6-b5a4-3210-fedc-ba9876543210",
  "sponsorshipRequestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "confirmed",
  "relayAttempt": 1,
  "transactionHash": "0xdeadbeefcafe1234567890abcdef1234567890abcdef1234567890abcdef1234",
  "submittedAt": "2025-05-11T10:31:05.000Z",
  "confirmedAt": "2025-05-11T10:31:18.000Z",
  "failedAt": null,
  "failureReason": null
}

{
  "id": "c9d8e7f6-b5a4-3210-fedc-ba9876543210",
  "sponsorshipRequestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "failed",
  "relayAttempt": 2,
  "transactionHash": null,
  "submittedAt": null,
  "confirmedAt": null,
  "failedAt": "2025-05-11T10:32:00.000Z",
  "failureReason": "Insufficient funds in relay wallet"
}

Overview

Wallets

Sponsorship

System

GET /relay/:id — Relay Transaction Details

Request

Response

Relay status values

Errors

​Request

​Response

​Relay status values

​Errors

Request

Response

Relay status values

Errors