Get Card Authorizations

get

https://example.com/v1/cards/{token}/authorization

Use this API to retrieve the list of authorization requests associated with a specific card. Each authorization record includes details such as the transaction amount, merchant, and current status — giving you a full view of pending and historical card activity.

Pass the card_token as a path parameter to scope results to a specific card. Use the available query parameters to filter, paginate, and sort the results:

status — Filter by authorization status (ACTIVE, COMPLETED, REJECTED, EXPIRED, RELEASED, REVERSED, or ALL). Takes precedence over isActiveCardAuthorizations when both are provided.
isActiveCardAuthorizations — A boolean shorthand to return only active (true) or inactive (false) authorizations. Applies only when status is not set.
offset and limit — Control pagination by skipping a number of records and capping the result set size.
orderBy and sortOrder — Sort results by createdAt in ascending (asc) or descending (desc) order.

A successful response returns a paginated list of card authorizations for the specified card.

Path Params

token

string

required

Defaults to 2586c4ba-1254-41ae-b7b8-dcb81d7a04dd

The unique token associated with the card for which you want to retrieve authorizations.
Example: 2586c4ba-1254-41ae-b7b8-dcb81d7a04dd

Query Params

offset

int64

The number of records to skip before starting to return results. This is useful for pagination.
Example: 0

limit

int32

The maximum number of records to return in the response. This is useful for pagination.
Example: 15

orderBy

string

enum

The field by which to sort the results. This determines the order in which records are returned.
Example: createdAt

Allowed:

sortOrder

string

enum

The sort order for the results. This can be either asc for ascending order or desc for descending order.
Example: desc

Allowed:

isActiveCardAuthorizations

boolean

Filter to return only active or inactive card authorizations.
Example: true for active, false for inactive.

status

string

enum

Filter card authorizations by their status. Use this parameter to retrieve authorizations in a specific state.
**Note: this query parameter takes precedent over isActiveCardAuthorizations query parameter.
If this query parameter is not provided the default value or the set value of isActiveCardAuthorizations query parameter will take over. **

Available options:

ALL - Return all authorizations regardless of status
ACTIVE - Return only active authorizations
COMPLETED - Return only completed authorizations
REJECTED - Return only rejected authorizations
EXPIRED - Return only expired authorizations
RELEASED - Return only released authorizations
REVERSED - Return only reversed authorizations

Example: ACTIVE

Allowed:

Headers

tenantId

string

required

Defaults to z01j3e71zd6zkq908vyf5861a8

The ID of your banking instance visible in the MBANQ Console.

Response

Language

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200The card authorizations fetched successfully.