Skip to content
GLORESEND

API reference

List card transactions

GET/cards/{id}/transactions

Lists purchases, refunds, top-ups and fees on a card, newest first. Use page to paginate.

Required scope
cards:read
Idempotency-Key
Not used
Environments
Sandbox and Live

Parameters

  • idstring · pathrequired

    max length 64

  • pageinteger · queryoptional

    min 1 · max 1,000 · default 1

Example request

curl "https://api.gloresend.com/sandbox/v1/cards/card_9f8e7d6c5b4a3f2e1d0c/transactions?page=1" \
  -H "Authorization: Bearer $GLORESEND_TEST_KEY"

Response · 200

200 · application/json
{
  "object": "list",
  "data": [
    {
      "id": "ctx_1a2b3c4d5e6f7g8h9i0j",
      "object": "card_transaction",
      "card_id": "card_9f8e7d6c5b4a3f2e1d0c",
      "type": "authorization",
      "status": "succeeded",
      "amount": 1299,
      "currency": "USD",
      "merchant": {
        "name": "Test Merchant",
        "mcc": "5734",
        "country": "US"
      },
      "created_at": "2026-10-15T09:31:00.000Z",
      "test_data": true
    }
  ],
  "has_more": false
}
Response fields
  • objectenumrequired

    "list"

  • dataarray of objectrequired
  • data[].idstringrequired
  • data[].objectenumrequired

    "card_transaction"

  • data[].card_idstringrequired
  • data[].typestringrequired
  • data[].statusstringrequired
  • data[].amountintegerrequired

    Amount in USD cents.

  • data[].currencystringrequired
  • data[].merchantobjectrequired
  • data[].merchant.namestring | nullrequired
  • data[].merchant.mccstring | nullrequired
  • data[].merchant.countrystring | nullrequired
  • data[].created_atstringrequired
  • data[].test_databooleanrequired
  • has_morebooleanrequired

Errors

  • 401authentication_requiredNo credentials were supplied. Send Authorization: Bearer <api key>.
  • 401invalid_api_keyThe API key is unknown, revoked or expired.
  • 401environment_mismatchThe API key belongs to a different environment than the base URL you called. Sandbox keys (gs_test_) only work against the Sandbox base URL, Live keys (gs_live_) only against the Live base URL.
  • 429rate_limitedToo many requests. Wait for the number of seconds in the Retry-After header.
  • 403insufficient_scopeThe API key does not have the scope required for this endpoint.
  • 404not_foundThe requested resource does not exist or is not visible to this API key.
  • 400validation_errorThe request body, query or headers failed validation. param points at the first invalid field.
  • 502provider_errorThe downstream provider returned an error. The transfer was marked as failed and reserved funds were released.
  • 504provider_timeoutThe downstream provider did not answer in time. The transfer was marked as failed and reserved funds were released.