Checkout

Get Checkout Transactions By Reference

List all transaction attempts associated with a checkout identified by the Atlas checkout reference.

GET
/api/v1/checkout/{reference}/transactions

Authorization

BearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

reference*string

Checkout reference

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/checkout/CHT_ABC123/transactions"
{
  "requestId": "abcd1234-5678-90ef-1234-567890abcdef",
  "requestTimestamp": "2026-01-01 12:00:00.000",
  "message": "Checkout transactions fetched successfully.",
  "statusCode": 200,
  "data": {
    "checkoutReference": "CHT_ABC123",
    "sourceReference": "SRC_ABC123",
    "checkoutStatus": "completed",
    "paymentMethod": "bank_transfer",
    "transactionsSummary": {
      "total": 2,
      "successful": 1,
      "failed": 1,
      "pending": 0
    },
    "transactions": [
      {
        "transactionReference": "TRX_ABC123",
        "status": "successful",
        "channel": "bank_transfer",
        "amount": {
          "value": 1050,
          "currency": "NGN",
          "formatted": "NGN 1,050.00"
        },
        "feeAmount": {
          "value": 50,
          "currency": "NGN",
          "formatted": "NGN 50.00"
        },
        "senderName": "Jane Doe",
        "reason": null,
        "createdAt": "2026-01-01T12:00:00+00:00",
        "updatedAt": "2026-01-01T12:05:00+00:00"
      }
    ]
  }
}
{
  "requestId": "f006ad7b-096c-4254-8c7e-2d23a55b0b0e",
  "requestTimestamp": "2026-01-01 12:00:00.000",
  "message": "Invalid API key.",
  "statusCode": 401
}
{
  "requestId": "f006ad7b-096c-4254-8c7e-2d23a55b0b0e",
  "requestTimestamp": "2026-01-01 12:00:00.000",
  "message": "Checkout with reference CHT_ABC123 not found",
  "statusCode": 404
}

How is this guide?