Ask Moov Beta
Generative AI is experimental and can make mistakes.
Guides Use cases API Changelog
  1. API reference
  2. Money movement
  3. Card issuing

Get authorization

Retrieves details of an authorization associated with a specific Moov account.

To use this endpoint from the browser, you’ll need to specify the /accounts/{accountID}/issued-cards.read scope when generating a token.

GET
/issuing/{accountID}/authorizations/{authorizationID}
cURL 
1
2

curl -X GET "https://api.moov.io/issuing/{accountID}/authorizations/{authorizationID}" \
  -H "Authorization: Bearer {token}" \
200 404 429
Successfully retrieved issued card authorization.
{
  "authorizationID": "ec7e1848-dc80-4ab0-8827-dd7fc0737b43",
  "authorizedAmount": "-14.89",
  "cardTransactions": [
    "ec7e1848-dc80-4ab0-8827-dd7fc0737b43"
  ],
  "createdOn": "2019-08-24T14:15:22Z",
  "fundingWalletID": "ec7e1848-dc80-4ab0-8827-dd7fc0737b43",
  "issuedCardID": "ec7e1848-dc80-4ab0-8827-dd7fc0737b43",
  "merchantData": {
    "city": "San Francisco",
    "country": "US",
    "mcc": "7298",
    "name": "Whole Body Fitness",
    "networkID": "1234567890",
    "postalCode": "94107",
    "state": "CA"
  },
  "network": "discover",
  "status": "pending"
}
No authorization with the specified authorizationID was found for the account with the specified accountID.
Request was refused due to rate limiting.

Response headers

Retry-After

number

Path parameters

accountID

string <uuid> required
ID of the account.

authorizationID

string <uuid> required
ID of the authorization.

Response

application/json

authorizationID

string<uuid> <=36 characters required
UUID

authorizedAmount

string required Pattern
A decimal-formatted signed numerical string that represents up to 9 decimal place precision.

createdOn

string<date-time> <=24 characters required

fundingWalletID

string<uuid> <=36 characters required
UUID

issuedCardID

string<uuid> <=36 characters required
UUID

merchantData

object required
right_key Show child attributes

country

string required
Two-letter code of the merchant country.

city

string
Location of merchant.

mcc

string
Merchant category code.

name

string
Name of merchant or company.

networkID

string
External identifier used to identify the merchant with the card brand.

postalCode

string
Five digit postal code.

state

string
Two-letter code of merchant state.

network

string<enum> required
The name of the network a card transaction is routed through.
Possible values: discover, shazam, visa

status

string<enum> required
Status of the authorization.
Possible values: pending, declined, canceled, cleared, expired

cardTransactions

array
List of card transaction IDs associated with this authorization.