Skip to main content
GET
/
v1
/
cards
/
{cardId}
/
transactions
curl --request GET \
  --url 'https://api.havn.finance/v1/cards/crd_8f7b2c9a1e3d4f5b/transactions?limit=2' \
  --header 'Authorization: Bearer havn_live_abc123def456'

{
  "data": [
    {
      "id": "txn_84jf902nf4kd",
      "amount": 14.99,
      "merchant": "NETFLIX.COM",
      "status": "settled",
      "createdAt": "2026-02-15T08:12:44Z"
    },
    {
      "id": "txn_1nfb9g48dbk7",
      "amount": 298.50,
      "merchant": "APPLE STORE R102",
      "status": "pending",
      "createdAt": "2026-02-18T14:30:11Z"
    }
  ],
  "hasMore": true
}

​
Authorization

​
Authorization
string
required
Bearer token. Format: Bearer <token>

​
Path Parameters

​
cardId
string
required
The unique identifier of the virtual card (returned during the POST /v1/cards provisioning call). Format: crd_<16 chars>

​
Query Parameters

​
limit
number
default:"20"
Maximum number of transactions to return per page. Max: 100.
​
startingAfter
string
A cursor for use in pagination. startingAfter is an object ID that defines your place in the list.

​
Response

​
data
array
List of transaction objects.
​
hasMore
boolean
Whether there are more transactions available beyond this page.

​
Transaction Object Attributes

​
id
string
Unique transaction identifier. Format: txn_<12 chars>
​
amount
number
The USD fiat amount authorized/settled.
​
merchant
string
The merchant descriptor from the Visa® or Mastercard® network.
​
status
string
Status of the transaction. Values: pending, settled, declined, refunded
​
createdAt
string
ISO 8601 timestamp of the authorization.
curl --request GET \
  --url 'https://api.havn.finance/v1/cards/crd_8f7b2c9a1e3d4f5b/transactions?limit=2' \
  --header 'Authorization: Bearer havn_live_abc123def456'

{
  "data": [
    {
      "id": "txn_84jf902nf4kd",
      "amount": 14.99,
      "merchant": "NETFLIX.COM",
      "status": "settled",
      "createdAt": "2026-02-15T08:12:44Z"
    },
    {
      "id": "txn_1nfb9g48dbk7",
      "amount": 298.50,
      "merchant": "APPLE STORE R102",
      "status": "pending",
      "createdAt": "2026-02-18T14:30:11Z"
    }
  ],
  "hasMore": true
}