List transactions · Recuut Docs

Returns payment records for this Recuut account and its test or live data. The page controls keep the list unchanged while you read later pages.

GET/merchant/v1/transactions

Request

Query Parameters

as_of?

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

status?|

Filter by transaction lifecycle status.

payer_id?|

Filter by server-issued payer identifier.

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*TransactionSchema[]

Fields on each TransactionSchema

Summary of one payment transaction.

authorized_at*|

When payment authorization completed, when applicable.

authorized_atomic*|

Authorized amount in the payment asset's smallest unit.

created_at*

When the transaction was created.

id*

ID of this transaction.

payer*|

Payer address, when known.

payment_request_id*

ID of the payment request that created this transaction.

settled_at*|

When settlement completed, when applicable.

settled_atomic*|

Paid amount in the payment asset's smallest unit.

status*

Current payment status.

transaction_hash*|

Transaction hash from the payment network, when available.

Request example

curl --request GET \  --url "$RECUUT_API_URL/merchant/v1/transactions?payer_id=pyr_00000000000070008000000000000000" \  --header "Authorization: Bearer $RECUUT_API_KEY"

HTTP response examples

200 · OKapplication/json

{  "as_of": "2026-08-12T09:30:00Z",  "count": 1,  "items": [    {      "authorized_at": "2026-08-12T09:29:57Z",      "authorized_atomic": "1000000",      "created_at": "2026-08-12T09:29:55Z",      "id": "txn_00000000000070008000000000000000",      "payer": "0x1111111111111111111111111111111111111111",      "payment_request_id": "prq_00000000000070008000000000000000",      "settled_at": "2026-08-12T09:30:00Z",      "settled_atomic": "1000000",      "status": "succeeded",      "transaction_hash": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"    }  ],  "next": null}