| Time | Status | User Agent |  |
| :-- | :-- | :-- | :-- |
| Make a request to see history. |

#### URL Expired

The URL for this request expired after 30 days.

transactionMessageId

uuid

subaccountId

uuid

cursor

string

The cursor to use for pagination. Identifies your place on the list

cardId

uuid

limit

integer

1 to 100

Defaults to 25

Maximum number of items to return

order

string

enum

Defaults to desc

ascdesc

Allowed:

`asc``desc`

accept

string

enum

Defaults to application/hal+json

Generated from available response content types

application/hal+jsonapplication/problem+json

Allowed:

`application/hal+json``application/problem+json`

# ``200      Transactions retrieved successfully

object

\_links

object

required

self

object

required

self object

next

object

next object

\_embedded

object

required

transactions

array of objects

required

transactions\*

object

\_links

object

required

\_links object

acceptor

object

required

The details relating to the acceptor (merchant) from the latest transaction message.

acceptor object

cardId

uuid | null

required

The unique identifier of the card related to this entity. Null only for bank-sourced transactions on a bank account with no linked cards (the card-less unified feed); the \_links.card link is omitted in that case.

cardholderBillingCurrency

string

required

The currency of the country of issuance following ISO 4217 alpha-3 format.

cardholderBillingHoldAmount

double

required

This amount models the hold on the cardholder account, in the card's issued currency, that occurs after an authorization and before a financial message. This amount will change as both authorization and financial messages are added to the Transaction in order to reflect the remaining hold amount.

cardholderBillingSettledAmount

double

required

The settled amount models the bottom line impact to the customer's bank statement in the card's issued currency. This amount will change as financial messages are added to the Transaction.

descriptor

string | null

required

Cleansed merchant name.

id

uuid

required

The unique identifier of this transaction entity.

network

string

required

The card network that processed this payment.

subaccountId

uuid

required

The unique identifier of the subaccount related to this entity.

supersededMessageIds

array of uuids

Message ids from \_links.messages whose financial contribution was superseded during aggregation — typically duplicate deliveries of the same clearing across network feeds, or a provisional bank-sourced settlement replaced by the network clearing. Superseded messages stay listed in \_links.messages for audit but do not count toward the settled amounts, so exclude them when deriving totals from individual messages (or better, use transactionSettledAmount / cardholderBillingSettledAmount directly). Always a subset of \_links.messages. Each payload carries the full current set (a snapshot, not a delta). Transactions last updated before this field was introduced report `[]` until their next update.

status

string

enum

required

A semantic understanding of the state of the transaction within the transaction lifecycle. [Learn More](https://docs.astrada.co/docs/transaction)

`PENDING``VOIDED``DECLINED``SETTLED`

transactionCurrency

string

required

The currency in which the transaction took place following ISO 4217 alpha-3 format.

transactionHoldAmount

double

required

This amount models the hold on the cardholder account, in the currency the transaction was conducted in, that occurs after an authorization and before a financial message. This amount will change as both authorization and financial messages are added to the Transaction in order to reflect the remaining hold amount.

transactionOccurrenceDate

date | null

required

The UTC date when the transaction took place, following ISO 8601 format (YYYY-MM-DD). This is a date-only field with no time component.

transactionSettledAmount

double

required

The settled amount models the bottom line impact to the customer's bank statement in the currency the transaction was conducted in. This amount will change as financial messages are added to the Transaction.

createdAt

date-time

required

Date and time when this resource was created, in UTC, following ISO 8601 format.

updatedAt

date-time

required

Date and time when this resource was last updated, in UTC, following ISO 8601 format.

# ``400      The server cannot or will not process the request due to something that is perceived to be a client error

# ``401      Authentication credentials were either missing or incorrect

# ``403      Authentication credentials used do not have have permissions to perform the request

# ``404      The requested resource was not found on the server

# ``500      The server encountered an unexpected condition that prevented it from fulfilling the request

Updated about 2 months ago

* * *

ShellNodeRubyPHPPython

Bearer

``

xxxxxxxxxx

curl --request GET \
 
 --url 'https://api.astrada.co/transactions?limit=25&order=desc' \
 
 --header 'accept: application/hal+json'
``

``

xxxxxxxxxx

{
  "_links": {
    "self": {
      "href": "/transactions"
    }
  },
  "_embedded": {
    "transactions": [\
      {\
        "_links": {\
          "messages": [\
            {\
              "href": "/transaction-messages/f4b24a0a-6a37-4ce3-8845-ddf0b604a9b4"\
            },\
            {\
              "href": "/transaction-messages/934f8701-53e3-4a2b-a000-6bb52195d2ea"\
            }\
          ],\
          "card": {\
            "href": "/subaccounts/f4b24a0a-6a37-4ce3-8845-ddf0b604a9b6"\
          },\
          "subaccount": {\
            "href": "/subaccounts/f4b24a0a-6a37-4ce3-8845-ddf0b604a9b5"\
          },\
          "self": {\
            "href": "/transactions/f4b24a0a-6a37-4ce3-8845-ddf0b604a9b4"\
          }\
        },\
        "acceptor": {\
          "city": "LONDON",\
          "country": "GBR",\
          "mcc": "5734",\
          "state": "LND"\
        },\
        "cardId": "4d1ff59f-4286-4209-9662-92e174193562",\
        "cardholderBillingCurrency": "GBP",\
        "cardholderBillingHoldAmount": 0,
        "cardholderBillingSettledAmount": 0.81,\
        "createdAt": "2024-05-01T06:41:43.810Z",\
        "descriptor": "Uber",\
        "id": "8697df0c-9011-47ca-a52b-8d2a7a4ad903",\
        "network": "MASTERCARD",\
        "status": "SETTLED",\
        "subaccountId": "c6d5e036-361e-4773-a514-b9496cf2d2b5",\
        "supersededMessageIds": [],\
        "transactionCurrency": "USD",\
        "transactionHoldAmount": 0,\
        "transactionOccurrenceDate": "2024-05-01",\
        "transactionSettledAmount": 1,\
        "transactionType": "DEBIT_01",\
        "updatedAt": "2024-05-02T08:41:43.810Z"\
      }\
    ]
  }
}

Updatedabout 2 months ago

* * *
