Skip to main content
GET
/
customers
/
{customerID}
/
card_accounts
/
{cardAccountID}
/
transactions
/
{transactionID}
Retrieve a card transaction
curl --request GET \
  --url https://api.bridge.xyz/v0/customers/{customerID}/card_accounts/{cardAccountID}/transactions/{transactionID} \
  --header 'Api-Key: <api-key>'
{
  "id": "<string>",
  "card_account_id": "<string>",
  "customer_id": "<string>",
  "category": "adjustment",
  "amount": "<string>",
  "billing_amount": "<string>",
  "currency": "usd",
  "merchant_category_code": "<string>",
  "merchant_name": "<string>",
  "merchant_location": "<string>",
  "description": "<string>",
  "local_transaction_details": {
    "amount": "<string>",
    "currency": "<string>",
    "exchange_rate": "<string>"
  },
  "posted_at": "<string>",
  "authorized_at": "<string>"
}

Authorizations

​
Api-Key
string
header
required

Path Parameters

​
customerID
string
required

A UUID that uniquely identifies a resource

Required string length: 1 - 42
​
cardAccountID
string
required

A UUID that uniquely identifies a resource

Required string length: 1 - 42
​
transactionID
string
required

A UUID that uniquely identifies a resource

Required string length: 1 - 42

Response

Card transactions

A posted transaction

​
id
string
required

ID of the transaction

Required string length: 1 - 42
​
category
enum<string>
required

The category of the transaction

Available options:
adjustment,
fee,
purchase,
refund,
crypto_funding,
crypto_return,
crypto_withdrawal
​
amount
string
required

The amount represented as a decimal string

​
currency
enum<string>
required

The currency of the transaction

Available options:
usd,
usdc
​
description
string
required

The transaction description. It includes the merchant's name and location information for card transactions

​
posted_at
string
required

Timestamp when the transaction was posted, in ISO8601 format

​
card_account_id
string

ID of the card account associated to this transaction

Required string length: 1 - 42
​
customer_id
string

ID of the customer of the card account associated to this transaction

Required string length: 1 - 42
​
billing_amount
string

The billing amount, represented as a decimal string. The billing amount is the amount of the transaction excluding any additional hold. This amount should be present on all purchases, but will only differ from the amount field for some merchant categories in which an upcharge is involved (e.g. gas stations, hotels).

​
merchant_category_code
string

The merchant category code, if applicable (e.g., '5712'). Always returned for transactions with category purchase or refund

​
merchant_name
string

The merchant name, if applicable. Always returned for transactions with category purchase or refund

​
merchant_location
string

The merchant location, if applicable. Always returned for transactions with category purchase or refund

​
local_transaction_details
object

Details of a transaction processed in a local currency other than USD, with currency conversion applied

​
authorized_at
string

Timestamp when the transaction was authorized, in ISO8601 format. Applicable only to transactions with category purchase or refund and always returned when applicable