Skip to main content
GET
Get Card Transaction

Authorizations

x-api-key
string
header
required

Your Meow API key, sent in the x-api-key header for authentication.

Headers

x-entity-id
string<uuid>

Optional entity_id to scope requests to a specific entity.

Path Parameters

transaction_id
string<uuid>
required

The transaction's identifier.

Response

Successful Response

A single movement in a card transaction's life.

A purchase produces several of these: an authorization when the merchant places the hold, then a clearing when the money actually moves, and a refund or reversal if it comes back. Entries sharing a trace_id are the same purchase.

Do not add up every entry. An authorization and the clearing that follows it are the same money: the hold, then the settlement that replaces it. Every amount is positive, and type carries the direction, so to total what was actually spent take the clearing entries minus the refund and reversal entries, and read authorization as money held but not yet taken.

Whether a state is final depends on the issuer, so do not infer it from status alone: an expired authorization can still be captured late on some networks. Treat cleared, reversed and failed as settled and re-read anything else.

id
string<uuid>
required

Meow's identifier for this entry. It is stable, but it identifies one step rather than the whole purchase, so an authorization and its later clearing have different ids.

card_id
string<uuid>
required

The card this was made on.

card_last_four
string
required

Last 4 digits of that card.

Example:

"4242"

type
enum<string>
required

Which step of the lifecycle this is.

Available options:
authorization,
clearing,
refund,
reversal,
original_credit
status
enum<string>
required

State of this step. pending and approved mean money is held but not moved; cleared means it moved; reversed and failed mean it did not. expired means the hold lapsed, which does not always rule out a later clearing.

Available options:
pending,
approved,
cleared,
reversed,
failed,
expired
description
string
required

Merchant descriptor as it was sent.

Example:

"WHISKER ROASTERS PORTLAND OR"

amount
string
required

Amount billed to the card, in the card's currency. Always positive, including on a refund or reversal, where type is what tells you the money came back. An authorization and its clearing carry the same amount, so summing both double-counts the purchase.

Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
Example:

"48.20"

currency
enum<string>
required

The card's currency.

Available options:
AED,
AFN,
ALL,
AMD,
ANG,
AOA,
ARS,
AUD,
AWG,
AZN,
BAM,
BBD,
BDT,
BGN,
BHD,
BIF,
BMD,
BND,
BOB,
BOV,
BRL,
BSD,
BTN,
BWP,
BYN,
BZD,
CAD,
CDF,
CHE,
CHF,
CHW,
CLF,
CLP,
CNY,
COP,
COU,
CRC,
CUC,
CUP,
CVE,
CZK,
DJF,
DKK,
DOP,
DZD,
EGP,
ERN,
ETB,
EUR,
FJD,
FKP,
GBP,
GEL,
GHS,
GIP,
GMD,
GNF,
GTQ,
GYD,
HKD,
HNL,
HRK,
HTG,
HUF,
IDR,
ILS,
INR,
IQD,
IRR,
ISK,
JMD,
JOD,
JPY,
KES,
KGS,
KHR,
KMF,
KPW,
KRW,
KWD,
KYD,
KZT,
LAK,
LBP,
LKR,
LRD,
LSL,
LYD,
MAD,
MDL,
MGA,
MKD,
MMK,
MNT,
MOP,
MRU,
MUR,
MVR,
MWK,
MXN,
MXV,
MYR,
MZN,
NAD,
NGN,
NIO,
NOK,
NPR,
NZD,
OMR,
PAB,
PEN,
PGK,
PHP,
PKR,
PLN,
PYG,
QAR,
RON,
RSD,
RUB,
RWF,
SAR,
SBD,
SCR,
SDG,
SLE,
SEK,
SGD,
SHP,
SLL,
SOS,
SRD,
SSP,
STN,
SVC,
SYP,
SZL,
THB,
TJS,
TMT,
TND,
TOP,
TRY,
TTD,
TWD,
TZS,
UAH,
UGX,
USD,
USN,
UYI,
UYU,
UYW,
UZS,
VED,
VES,
VND,
VUV,
WST,
XAF,
XAG,
XAU,
XBA,
XBB,
XBC,
XBD,
XCD,
XDR,
XOF,
XPD,
XPF,
XPT,
XSU,
XTS,
XUA,
XXX,
YER,
ZAR,
ZMW,
ZWG,
ZWL
Example:

"USD"

merchant_amount
string
required

Amount in the currency the merchant charged in, always positive. Differs from amount on a foreign-currency purchase; divide the two to get the rate applied.

Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
Example:

"44.15"

merchant_currency
enum<string>
required

The currency the merchant charged in.

Available options:
AED,
AFN,
ALL,
AMD,
ANG,
AOA,
ARS,
AUD,
AWG,
AZN,
BAM,
BBD,
BDT,
BGN,
BHD,
BIF,
BMD,
BND,
BOB,
BOV,
BRL,
BSD,
BTN,
BWP,
BYN,
BZD,
CAD,
CDF,
CHE,
CHF,
CHW,
CLF,
CLP,
CNY,
COP,
COU,
CRC,
CUC,
CUP,
CVE,
CZK,
DJF,
DKK,
DOP,
DZD,
EGP,
ERN,
ETB,
EUR,
FJD,
FKP,
GBP,
GEL,
GHS,
GIP,
GMD,
GNF,
GTQ,
GYD,
HKD,
HNL,
HRK,
HTG,
HUF,
IDR,
ILS,
INR,
IQD,
IRR,
ISK,
JMD,
JOD,
JPY,
KES,
KGS,
KHR,
KMF,
KPW,
KRW,
KWD,
KYD,
KZT,
LAK,
LBP,
LKR,
LRD,
LSL,
LYD,
MAD,
MDL,
MGA,
MKD,
MMK,
MNT,
MOP,
MRU,
MUR,
MVR,
MWK,
MXN,
MXV,
MYR,
MZN,
NAD,
NGN,
NIO,
NOK,
NPR,
NZD,
OMR,
PAB,
PEN,
PGK,
PHP,
PKR,
PLN,
PYG,
QAR,
RON,
RSD,
RUB,
RWF,
SAR,
SBD,
SCR,
SDG,
SLE,
SEK,
SGD,
SHP,
SLL,
SOS,
SRD,
SSP,
STN,
SVC,
SYP,
SZL,
THB,
TJS,
TMT,
TND,
TOP,
TRY,
TTD,
TWD,
TZS,
UAH,
UGX,
USD,
USN,
UYI,
UYU,
UYW,
UZS,
VED,
VES,
VND,
VUV,
WST,
XAF,
XAG,
XAU,
XBA,
XBB,
XBC,
XBD,
XCD,
XDR,
XOF,
XPD,
XPF,
XPT,
XSU,
XTS,
XUA,
XXX,
YER,
ZAR,
ZMW,
ZWG,
ZWL
Example:

"EUR"

authorized_at
string<date-time>
required

When the purchase was made, as reported by the network.

created_at
string<date-time>
required

When Meow recorded this step.

merchant
CardTransactionMerchant · object | null

The merchant, when Meow could identify it.

category
enum<string> | null

Spend category, when known.

Available options:
Advertising,
Airlines,
Books and Newspapers,
Car Rental,
Charity,
Clothing,
Electronics,
Entertainment,
Facilities Expenses,
Financial Institutions and Fees,
Fuel,
Furniture,
Government Services,
Grocery,
Ground Transportation,
Insurance,
Legal,
Lodging,
Meals,
Medical,
Office Supplies,
Parking,
Political,
Professional Services,
Recruiting,
Rent,
Restaurants,
Shipping,
Software,
Taxes,
Taxis and Rideshare,
Technology Infrastructure,
Training and Education,
Utilities,
Vehicle Expenses
trace_id
string | null

Identifier for the purchase this entry belongs to. Entries sharing one are the same purchase, so filter List Card Transactions by it to tie an authorization to its later clearing or refund. It is the same trace_id the rest of Meow shows for this transaction. Absent on an entry the network gave no identifier for, which then stands alone.

Example:

"card_24692111234567890123456"

decline_reason
string | null

Why this was declined, when it was.

updated_at
string<date-time> | null

When Meow last updated this step.