GET /wallets/:address/history — Sponsorship History

Use this endpoint to retrieve the full sponsorship history for a registered wallet address. Results are returned in pages using cursor-based pagination. Each page includes a cursor value you can pass to the next request to retrieve the following page.

Request

GET /wallets/:address/history

string

required

The Ethereum address whose history you want to retrieve. Must match ^0x[0-9a-fA-F]{40}$ and be at most 42 characters.

string

UUID of the last item from the previous page. Omit this parameter to start from the beginning of the history. Pass the cursor value returned in the previous response to fetch the next page.

integer

default:"50"

Number of results to return per page. Accepts integers between 1 and 100 inclusive. Defaults to 50 if not provided.

Response

The response is a paginated object containing a list of sponsorship request records and a cursor for fetching the next page.

array

required

Array of sponsorship request records for this wallet. Each record includes the following fields:

Show Sponsorship request fields

string

UUID of the sponsorship request.

string

UUID of the wallet that submitted this request.

string

Current lifecycle status: pending, approved, relayed, completed, rejected, or failed.

string

ISO 8601 timestamp of when the request was created.

string

ISO 8601 timestamp when the request was approved, or null.

string

ISO 8601 timestamp when the sponsorship completed, or null.

string

ISO 8601 timestamp when the request failed, or null.

string

ISO 8601 timestamp when the request was rejected, or null.

string

UUID cursor to pass as the cursor query parameter to fetch the next page of results. null if there are no more pages.

If the wallet address is not registered in ArcPass, this endpoint returns 404 Not Found. Register the wallet first using POST /wallets/register before querying its history.

Errors

Status	Cause
`400`	The `:address` path parameter does not match the required hex pattern.
`404`	No wallet with this address is registered in ArcPass.
`422`	The `cursor` is not a valid UUID, or `limit` is outside the 1–100 range.

curl --request GET \
  --url "https://api.arcpass.io/wallets/0xAbC1234567890dEF1234567890aBcDeF12345678/history?limit=10&cursor=3f2a1c8e-9b4d-4e7f-a1d2-0c6f8e3b5a9d"

200

{
  "requests": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "walletId": "3f2a1c8e-9b4d-4e7f-a1d2-0c6f8e3b5a9d",
      "status": "completed",
      "requestedAt": "2025-05-11T10:30:00.000Z",
      "approvedAt": "2025-05-11T10:30:08.000Z",
      "completedAt": "2025-05-11T10:30:22.000Z",
      "failedAt": null,
      "rejectedAt": null
    }
  ],
  "nextCursor": null
}

Overview

Wallets

Sponsorship

System

GET /wallets/:address/history — Sponsorship History

Request

Response

Errors

​Request

​Response

​Errors

Request

Response

Errors