List payers · Recuut Docs

Returns the payers that used this Recuut account in test or live data. The as_of time keeps the list unchanged while you read later pages.

GET/merchant/v1/payers

Request

Query Parameters

as_of?

Stable snapshot timestamp for this page sequence. Include a timezone; future timestamps are rejected.

order?

Show the newest or oldest records first.

page?

Page number to return. The first page is 1.

page_size?

Number of items to return on each page. Use 1 through 100.

Authentication

Authorization*Bearer <token>

Private API key for your Recuut account. A recuut_test_ key uses test payers and transactions. A recuut_live_ key uses live data. Send this key only from your server.

In: header

Response

application/json

Schema

as_of*

Time marker that keeps list pages unchanged. Omit it on the first request. Reuse the returned value on later pages.

count*

Total number of records in this unchanged list.

next*|

URL for the next page, or null after the final page.

items*PayerSchema[]

Fields on each PayerSchema

Payer activity in this account's test or live data.

created_at*

When this payer was first observed.

id*

Recuut ID for this payer.

identifier*

Payer address or identifier, stored in a consistent form.

last_transaction_at*

Time of the payer's most recent transaction.

Request example

curl --request GET \  --url "$RECUUT_API_URL/merchant/v1/payers" \  --header "Authorization: Bearer $RECUUT_API_KEY"

HTTP response examples

200 · OKapplication/json

{  "as_of": "2026-08-12T09:30:00Z",  "count": 1,  "items": [    {      "created_at": "2026-08-01T08:00:00Z",      "id": "pyr_00000000000070008000000000000000",      "identifier": "0x1111111111111111111111111111111111111111",      "last_transaction_at": "2026-08-12T09:30:00Z"    }  ],  "next": null}