Get Card Transaction
Returns one entry from a card’s transaction history, by the id returned in List Card Transactions or in Get Card Spending Insights. An entry is one step of a purchase, so to see the whole purchase filter List Card Transactions by this entry’s trace_id.
Authorizations
Your Meow API key, sent in the x-api-key header for authentication.
Headers
Optional entity_id to scope requests to a specific entity.
Path Parameters
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.
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.
The card this was made on.
Last 4 digits of that card.
"4242"
Which step of the lifecycle this is.
authorization, clearing, refund, reversal, original_credit 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.
pending, approved, cleared, reversed, failed, expired Merchant descriptor as it was sent.
"WHISKER ROASTERS PORTLAND OR"
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.
^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$"48.20"
The card's currency.
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 "USD"
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.
^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$"44.15"
The currency the merchant charged in.
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 "EUR"
When the purchase was made, as reported by the network.
When Meow recorded this step.
The merchant, when Meow could identify it.
Spend category, when known.
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 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.
"card_24692111234567890123456"
Why this was declined, when it was.
When Meow last updated this step.