Skip to main content
GET
Search & list instruments

Authorizations

Authorization
string
header
required

You can use an OAuth2 JWT bearer token in the Authorization header of your API requests for supported endpoints: Authorization: Bearer <YOUR_JWT_HERE>. These tokens are valid for 10 minutes and can be requested via the access token endpoint endpoint.

Query Parameters

includeHolderReference
boolean
default:false

Boolean indicating if the holder reference should be included in the response.

filter[holderReference]
string

Filter for a list of instruments by holder reference.

filter[holderId]
string

Filter for a list of instruments by holder id.

filter[status]
string

Filter for a list of instruments by latest instruments status.

filter[onlyWithTokens]
boolean

Filter for a list of instruments only ones with tokens.

filter[tokenType]
string

Filter for a list of instruments by token type.

filter[tokenStatus]
string

Filter for a list of instruments by token status.

filter[futureUsage]
string

Filter for a list of instruments by future usage.

filter[bin]
string

Filter for a list of instruments by BIN.

filter[suffix]
string

Filter for a list of instruments by suffix.

filter[network]
string

Filter for a list of instruments by card network.

filter[issuer]
string

Filter for a list of instruments by issuer.

filter[issuerCountry]
string

Filter for a list of instruments by country name.

filter[paymentMethodType]
string

Filter for a list of instruments by payment method.

filter[createdAt]
string

Filter by createdAt field using interval notation.

1973-02-03T04:32:11.596Z - exact date value

(1973-02-03T04:32:11.596Z - after the date excluding it

[1973-02-03T04:32:11.596Z - after the date including it

1973-02-03T04:32:11.596Z) - before the date excluding it

1973-02-03T04:32:11.596Z] - before the date including it

(1973-02-03T04:32:11.596Z,1973-04-03T03:20:11.436Z) - between two dates excluding both

(1973-02-03T04:32:11.596Z,1973-04-03T03:20:11.436Z] - between two dates excluding on the left

[1973-02-03T04:32:11.596Z,1973-04-03T03:20:11.436Z) - between two dates excluding on the right

[1973-02-03T04:32:11.596Z,1973-04-03T03:20:11.436Z] - between two dates including both.

Example:

"[2026-04-01T00:00:00Z,2026-05-01T00:00:00Z)"

page[cursor]
string

Search collection items from that cursor. Cursor for paging results.

page[after]
string

Search collection items after that cursor. Cursor for paging results.

page[before]
string

Search collection items before that cursor. Cursor for paging results.

page[size]
integer<int32>

Length of the collection to search.

Response

Success.

paging
object

Paging information about the results.

results
object[]

List of results for the query.

Last modified on October 5, 2026