Get Card Authorizations

get

https://api.cloud.mbanq.com/v1/cards/{card_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

card_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

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:

offset

integer

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

limit

integer

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.

Headers

tenantId

string

required

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

Responses

Language

Credentials

Bearer

JWT

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.

400The request failed validation. Common causes include missing tenant ID or invalid pagination parameters.

401Authentication credentials were missing or incorrect.

403The authenticated user does not have permission to view card authorizations.

404The request fails if the card token is incorrect.