API ReferenceTransactions

Get Matched Transaction Counts (Batch)

Internal-only batch endpoint that returns the number of settled (matched) transactions a given user has at a given merchant. Used by progressive offer eligibility checks that need to know how many qualifying transactions a user has accrued at each merchant. Only settled transactions are counted. Approved-but-not-yet-settled transactions do not advance progressive tiers. <b>Audience:</b> internal-sdk only.<br/> <b>Note:</b> `Maximum of 500 lookups can be queried per request`.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

organizationIdstringRequired
Your issuer organization ID, provided by Kard

Request

This endpoint expects an object.
datalist of objectsRequired

List of { issuerId, userId, merchantId } lookups (1–500 per request). Results are returned in the same order as the lookups.

Response

This endpoint returns an object.
datalist of objects

One result per lookup in the request, in the same order. settledCount is the number of SETTLED matched transactions the user has at the merchant.

Errors

400
Invalid Request
401
Unauthorized Error
500
Internal Server Error