Retrieve authorizations

Airwallex APIs allow you retrieve authorizations processed against a single card or all cards associated with your account.

Retrieve all authorizations

Use Get authorization status API to retrieve authorizations associated with your account, for a specific card or all cards. You can refine the list using the following query parameters:

• card_id: Returns authorizations specific to this card.
• from_created_date, to_created_date: Returns authorizations between the specified time period, inclusive of start and end dates. If you do not specify either of the fields, defaults to a 30 day period.
• page_num, page_size: Breaks down the authorizations list as per the specified pagination parameters.
• billing_currency: The 3-letter ISO-4217 currency code in which the authorization was billed.
• retrieval_ref: A unique identifier for the transaction assigned by the acquirer.

Example request

Shell
1curl --request GET \
2--url 'https://api-demo.airwallex.com/api/v1/issuing/authorizations'
3--header 'Authorization: Bearer <your_bearer_token>'

Example response

JSON
1{
2   "has_more": false,
3   "items": [
4       {
5           "auth_code": "248723",
6           "billing_amount": -1,
7           "billing_currency": "USD",
8           "card_id": "841e1115-b092-49ac-8186-d2e00196bf22",
9           "card_nickname": "Postman Test Card",
10           "create_time": "2021-12-10T11:09:05.523+0000",
11           "expiry_date": "2021-12-17T11:09:05.662+0000",
12           "masked_card_number": "************3725",
13           "merchant": {
14               "category_code": "7531",
15               "city": "MELB TEST1",
16               "country": "AUS",
17               "name": "CARD_TX_GENERATOR"
18           },
19           "network_transaction_id": "6821237754268198",
20           "retrieval_ref": "115277031202",
21           "status": "PENDING",
22           "transaction_amount": -1,
23           "transaction_currency": "USD",
24           "transaction_id": "ca7cdecc-6fca-4a99-b593-471824211471"
25       },
26       {
27           "auth_code": "278941",
28           "billing_amount": -2,
29           "billing_currency": "USD",
30           "card_id": "841e1115-b092-49ac-8186-d2e00196bf22",
31           "card_nickname": "Postman Test Card",
32           "create_time": "2021-12-10T11:09:23.073+0000",
33           "expiry_date": "2021-12-17T11:09:23.157+0000",
34           "masked_card_number": "************3725",
35           "merchant": {
36               "category_code": "7531",
37               "city": "MELB TEST1",
38               "country": "AUS",
39               "name": "CARD_TX_GENERATOR"
40           },
41           "network_transaction_id": "2612193580965623",
42           "retrieval_ref": "414555052604",
43           "status": "PENDING",
44           "transaction_amount": -2,
45           "transaction_currency": "USD",
46           "transaction_id": "6f84b971-892a-41fc-b5e2-22e5599628b7"
47       }
48   ]
49}

Retrieve a single authorization

If you want to retrieve details of a specific authorization, call Get single authorization API by specifying the unique identifier of the authorization in the endpoint URL. You can retrieve the transaction_id from Get transactions API.

Example request

Shell
1curl --request GET \
2--url 'https://api-demo.airwallex.com/api/v1/issuing/authorizations/<transaction_id>'
3--header 'Authorization: Bearer <your_bearer_token>'

Example response

JSON
1{
2           "auth_code": "248723",
3           "billing_amount": -1,
4           "billing_currency": "USD",
5           "card_id": "841e1115-b092-49ac-8186-d2e00196bf22",
6           "card_nickname": "Postman Test Card",
7           "create_time": "2021-12-10T11:09:05.523+0000",
8           "expiry_date": "2021-12-17T11:09:05.662+0000",
9           "masked_card_number": "************3725",
10           "merchant": {
11               "category_code": "7531",
12               "city": "MELB TEST1",
13               "country": "AUS",
14               "name": "CARD_TX_GENERATOR"
15           },
16           "network_transaction_id": "6821237754268198",
17           "retrieval_ref": "115277031202",
18           "status": "PENDING",
19           "transaction_amount": -1,
20           "transaction_currency": "USD",
21           "transaction_id": "ca7cdecc-6fca-4a99-b593-471824211471"
22       }