curl --request GET \
--url https://api.gigstack.io/v2/payments/register/batch/{id}/items \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.gigstack.io/v2/payments/register/batch/{id}/items', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.gigstack.io/v2/payments/register/batch/{id}/items"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"success": true,
"data": {
"data": [
{
"index": 0,
"idempotency_key": "txn-2026-10-000123",
"status": "registered",
"payment_id": "payment_a1b2c3d4e5",
"error": null,
"attempts": 1
},
{
"index": 1,
"idempotency_key": "txn-2026-10-000124",
"status": "duplicate",
"payment_id": "payment_f6e5d4c3b2",
"error": null,
"attempts": 1
},
{
"index": 2,
"idempotency_key": "txn-2026-10-000125",
"status": "failed",
"payment_id": null,
"error": {
"code": "validation_failed",
"message": "Resource resolution failed"
},
"attempts": 1
},
{
"index": 3,
"idempotency_key": "txn-2026-10-000126",
"status": "queued",
"payment_id": null,
"error": null,
"attempts": 2
}
],
"next": "3",
"has_more": true
},
"timestamp": 1790781000000
}List the items of a payment batch
One entry per accepted item, in request order (ascending index), with its status and, once
registered, its payment. Items rejected up front are not listed; they are in the batch’s rejected.
Cursor pagination: pass data.next back as next while data.has_more is true. The cursor is the last
index of the page, so pages never overlap or skip items while statuses change. Filter with status,
for example status=failed to list only what needs fixing.
curl --request GET \
--url https://api.gigstack.io/v2/payments/register/batch/{id}/items \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.gigstack.io/v2/payments/register/batch/{id}/items', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.gigstack.io/v2/payments/register/batch/{id}/items"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"success": true,
"data": {
"data": [
{
"index": 0,
"idempotency_key": "txn-2026-10-000123",
"status": "registered",
"payment_id": "payment_a1b2c3d4e5",
"error": null,
"attempts": 1
},
{
"index": 1,
"idempotency_key": "txn-2026-10-000124",
"status": "duplicate",
"payment_id": "payment_f6e5d4c3b2",
"error": null,
"attempts": 1
},
{
"index": 2,
"idempotency_key": "txn-2026-10-000125",
"status": "failed",
"payment_id": null,
"error": {
"code": "validation_failed",
"message": "Resource resolution failed"
},
"attempts": 1
},
{
"index": 3,
"idempotency_key": "txn-2026-10-000126",
"status": "queued",
"payment_id": null,
"error": null,
"attempts": 2
}
],
"next": "3",
"has_more": true
},
"timestamp": 1790781000000
}Authorizations
Authentication Method: HTTP Bearer token.
The runtime requires the literal Bearer prefix — a bare token in the
Authorization header is rejected with 401 unauthorized.
Header Format: Authorization: Bearer YOUR_API_KEY
Your API key is a JWT. Live keys operate on live data (livemode: true);
test keys operate on isolated test data (livemode: false).
Get your key at: app.gigstack.pro/settings?tab=api
Errors: credential failures are answered by the authentication layer with a raw
{ "message": … } body, not the standardized envelope — 401 for a missing, malformed or
expired token, 403 for a revoked key or a plan without API access. See the Unauthorized
and AuthForbidden responses.
Path Parameters
Batch id.
Query Parameters
gigstack Connect: Target team ID for multi-team access.
Requires gigstack Connect enabled on your team and shared billing account.
Also requires the multipleIssuerAccounts feature on your plan. Requests targeting a
team other than the one your API key belongs to return 403 without it.
Only API keys can use it: an OAuth access token sent with another team's id is rejected with
403 Team mismatch with OAuth token.
Optional — omit it entirely unless you are acting on another team. It deliberately
carries no example value so generated snippets do not emit ?team=undefined; when the
parameter is absent, the team is derived from your API key.
Example: ?team=team_xyz789
Items per page (default 100, 1-500). Anything else is 400 invalid_limit.
1 <= x <= 500Cursor from the previous page's data.next. Omit for the first page. An invalid one is 400 invalid_cursor.
Only items in this status. queued covers every item still in flight. Any other value is
400 invalid_status. Omit for all items.
queued: waiting for, or in, a registration attempt. An attempt that failed for a temporary reason (another request holding the client, an internal error) keeps the itemqueuedand is retried, up to 6 attempts.registered: the payment was registered by this batch.payment_idis set.failed: no payment was registered.errorsays why.duplicate: a payment already existed under thisidempotency_key(an earlier batch, a singlePOST /payments/register, or a redelivery of this item).payment_idnames it; nothing was registered again.
queued, registered, failed, duplicate "registered"
Response
A page of items. Note the nesting: the array is at data.data, the cursor at data.next.
Standardized success envelope emitted by sendSuccessResponse.
true true
The operation payload.
Show child attributes
Show child attributes
Server time in epoch milliseconds (Luxon.now().toMillis()).
1767225600000
Human-readable summary. Present only when the handler supplies one.
"Operation completed successfully"