Skip to navigation

List authorizations for a merchant

Card authorization attempts (approvals and declines) for one merchant, newest first. Defaults to the last 30 days; maximum date span is 365 days. An empty result is normal for low-volume merchants. Coverage: TSYS merchants are served from the TSYS authorization file (history from 2024-12-30; new authorizations land once daily, typically one day behind). Merchants processed on Fiserv Omaha FSP are served from the Fiserv authorization feed (history from 2026-01-01 with a rolling 15-month floor; refreshed roughly hourly). Merchants on Fiserv North or Fiserv Omaha Retail are served from the Fiserv AccessOne authorization feed (refreshed daily; times are the processor’s wall-clock time in authorized_at_local, with authorized_at null). meta.data_coverage reports which feed answered (“tsys_only”, “fiserv_fsp” or “fiserv_accessone”; new values are added as feeds come online). Paging depth: across more than one day, pages reach the first 500,000 rows (page x page_size), or the first 50,000 with approved, card_type or card_network; deeper pages return 422. A single day (date_from equal to date_to) has no depth limit, so sync large portfolios one day at a time.

Authentication

X-Partner-API-Keystring
API Key authentication via header

Path parameters

merchant_idstringRequired1-50 characters
Merchant ID

Query parameters

date_fromdate or nullOptional

Start date (YYYY-MM-DD)

date_todate or nullOptional

End date (YYYY-MM-DD)

pageintegerOptional>=1Defaults to 1
Page number
page_sizeintegerOptional1-100Defaults to 25
Items per page
card_typestring or nullOptional<=5 characters

Filter by the raw processor card type code, passed through undecoded: the TSYS card type (e.g. 4, 5, 3, 8; proprietary extensions appear in live data) or, on the per-merchant routes, the Fiserv code: the Omaha FSP network code (e.g. 2 = Visa, 3 = Mastercard, 1 = American Express, 4 = Discover) or the AccessOne card type (e.g. 00002, 04).

card_networkstring or nullOptionalformat: "^(?:amex|debit|diners|discover|ebt|fleet|jcb|mastercard|other|paypal|private_label|visa)$"

Filter by one normalized network: amex, debit, diners, discover, ebt, fleet, jcb, mastercard, other, paypal, private_label, visa

approvedboolean or nullOptional

true = issuer-approved authorizations (TSYS response codes 00, 10, 85; Fiserv approval status 1 or AccessOne Approved); false = declines. Rows whose outcome is absent at the source (approved: null in the payload) match neither filter.

Response

Successful Response
datalist of objectsOptional
metaobjectOptional

Standard pagination meta plus the coverage flag and applied-window echo unique to the authorization endpoints.

errorslist of objectsOptional

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error