> ## Documentation Index > Fetch the complete documentation index at: https://docs.sudo.africa/llms.txt > Use this file to discover all available pages before exploring further. # Get Authorization > Fetches details about a specific authorization using the provided id. ## OpenAPI ````yaml openapi.json get /cards/authorizations/{id} openapi: 3.1.0 info: title: Sudo Sandbox API version: '1.0' servers: - url: https://api.sandbox.sudo.cards security: - sec0: [] paths: /cards/authorizations/{id}: get: summary: Get Authorization description: Fetches details about a specific authorization using the provided id. operationId: get-authorization parameters: - name: id in: path description: The `_id` of the authorization to fetch. schema: type: string required: true responses: '200': description: Authorization fetched successfully. headers: X-Powered-By: schema: type: string example: Express Access-Control-Allow-Origin: schema: type: string example: '*' X-RateLimit-Limit: schema: type: integer example: '250000' X-RateLimit-Remaining: schema: type: integer example: '249999' X-RateLimit-Reset: schema: type: integer example: '0' Content-Type: schema: type: string example: application/json; charset=utf-8 ETag: schema: type: string example: W/"2dd-sfRBgLV2BqnKnzwqFCi2UGdBgUQ" Connection: schema: type: string example: keep-alive Keep-Alive: schema: type: string example: timeout=5 content: application/json: schema: type: object properties: statusCode: type: integer description: >- Status code of the response. `200` indicates a successful request. message: type: string description: Human-readable description of the result. data: type: object description: Response payload. properties: _id: type: string description: Unique identifier of the object. business: type: string description: Identifier of the business that owns this object. customer: type: object description: >- Associated customer — an id, or a summary object on nested resources. properties: _id: type: string description: Unique identifier of the object. business: type: string description: Identifier of the business that owns this object. type: type: string description: Type of the object. name: type: string description: Display name. phoneNumber: type: string description: Customer's phone number in international format. emailAddress: type: string description: Customer's email address. status: type: string description: Current status of the object. individual: type: object description: Details for an individual customer. properties: firstName: type: string description: First name. lastName: type: string description: Last name. otherNames: type: string description: Other names, if any. dob: type: string format: date-time description: Date of birth (YYYY/MM/DD). identity: type: object description: Customer's verified identity record. properties: type: type: string description: Type of the object. number: type: string description: Identity / card number value. billingAddress: type: object description: Customer's billing address. properties: line1: type: string description: Address line 1. line2: type: string description: Address line 2. city: type: string description: City. state: type: string description: State / region. postalCode: type: string description: Postal / ZIP code. country: type: string description: Country. isDeleted: type: boolean description: Whether the object has been soft-deleted. createdAt: type: string format: date-time description: ISO 8601 timestamp of when the object was created. updatedAt: type: string format: date-time description: >- ISO 8601 timestamp of when the object was last updated. __v: type: integer description: Internal document version (Mongo). account: type: object description: >- Associated account — an id, or a summary object on nested resources. properties: _id: type: string description: Unique identifier of the object. business: type: string description: Identifier of the business that owns this object. type: type: string description: Type of the object. currency: type: string description: ISO 4217 currency code (e.g. `NGN`). accountName: type: string description: Name on the account. bankCode: type: string description: Bank / institution code. accountType: type: string description: Account product type (`Savings` or `Current`). accountNumber: type: string description: Account number (NUBAN). currentBalance: type: integer description: >- Current ledger balance, in the minor currency unit. availableBalance: type: integer description: >- Balance available for spending, in the minor currency unit. provider: type: string description: Underlying provider backing the object. providerReference: type: string referenceCode: type: string reloadable: type: boolean isDefault: type: boolean isDeleted: type: boolean description: Whether the object has been soft-deleted. createdAt: type: string format: date-time description: ISO 8601 timestamp of when the object was created. updatedAt: type: string format: date-time description: >- ISO 8601 timestamp of when the object was last updated. charges: type: array items: {} __v: type: integer description: Internal document version (Mongo). card: type: object description: >- Associated card — an id, or a summary object on nested resources. properties: failedTransactionCount: type: integer minimumBalance: type: integer version: type: string _id: type: string description: Unique identifier of the object. business: type: string description: Identifier of the business that owns this object. customer: type: string description: >- Associated customer — an id, or a summary object on nested resources. account: type: string description: >- Associated account — an id, or a summary object on nested resources. fundingSource: type: string description: >- Identifier of the funding source backing this object. program: nullable: true type: type: string description: Type of the object. brand: type: string description: Card scheme/brand (e.g. `Verve`, `MasterCard`). currency: type: string description: ISO 4217 currency code (e.g. `NGN`). maskedPan: type: string description: Masked card number (PAN). expiryMonth: type: string description: Card expiry month (MM). expiryYear: type: string description: Card expiry year (YYYY). status: type: string description: Current status of the object. is2FAEnabled: type: boolean is2FAEnrolled: type: boolean description: Whether the card is enrolled for 3-D Secure / 2FA. isDefaultPINChanged: type: boolean description: Whether the default PIN has been changed. disposable: type: boolean description: Whether the card is single-use / disposable. refundAccount: nullable: true description: Account to which refunds are routed, if any. providerReference: type: string isDigitalized: type: boolean accumulatedFees: type: integer totalFeesCharged: type: integer feeChargeDay: type: integer isDeleted: type: boolean description: Whether the object has been soft-deleted. createdAt: type: string format: date-time description: ISO 8601 timestamp of when the object was created. updatedAt: type: string format: date-time description: >- ISO 8601 timestamp of when the object was last updated. __v: type: integer description: Internal document version (Mongo). spendingControls: type: object description: >- Spending limits and channel/category controls applied to the card. properties: channels: type: object description: Channels through which the card may be used. properties: atm: type: boolean description: Whether ATM usage is allowed. pos: type: boolean description: Whether POS usage is allowed. web: type: boolean description: Whether web/online usage is allowed. mobile: type: boolean description: Whether mobile usage is allowed. allowedCategories: type: array description: >- Merchant category codes (MCC) explicitly allowed. items: {} blockedCategories: type: array description: >- Merchant category codes (MCC) explicitly blocked. items: {} spendingLimits: type: array description: Configured spending limits. items: {} amount: type: number description: Amount in the minor currency unit (e.g. kobo). fee: type: integer description: Fee charged, in the minor currency unit. vat: type: number description: VAT charged, in the minor currency unit. approved: type: boolean description: Whether the authorization was approved. currency: type: string description: ISO 4217 currency code (e.g. `NGN`). status: type: string description: Current status of the object. authorizationMethod: type: string description: How the authorization was performed. balanceTransactions: type: array items: {} merchantAmount: type: integer description: Amount in the merchant's currency. merchantCurrency: type: string description: Merchant's ISO 4217 currency code. merchant: type: object properties: category: type: string name: type: string description: Display name. merchantId: type: string city: type: string description: City. state: type: string description: State / region. country: type: string description: Country. postalCode: type: string description: Postal / ZIP code. terminal: type: object properties: rrn: type: string stan: type: string terminalId: type: string terminalOperatingEnvironment: type: string terminalAttendance: type: string terminalType: type: string panEntryMode: type: string pinEntryMode: type: string cardHolderPresence: type: boolean cardPresence: type: boolean transactionMetadata: type: object description: Channel and reference metadata for the transaction. properties: channel: type: string description: >- Channel the transaction occurred on (`web`, `pos`, `atm`). type: type: string description: Type of the object. reference: type: string description: Unique reference assigned to the object. pendingRequest: nullable: true description: Details of the amount currently being authorized. requestHistory: type: array items: type: object properties: amount: type: number description: Amount in the minor currency unit (e.g. kobo). currency: type: string description: ISO 4217 currency code (e.g. `NGN`). approved: type: boolean description: Whether the authorization was approved. merchantAmount: type: integer description: Amount in the merchant's currency. merchantCurrency: type: string description: Merchant's ISO 4217 currency code. reason: type: string description: Reason for the dispute. createdAt: type: string format: date-time description: >- ISO 8601 timestamp of when the object was created. verification: type: object properties: billingAddressLine1: type: string billingAddressPostalCode: type: string cvv: type: string expiry: type: string pin: type: string threeDSecure: type: string safeToken: type: string authentication: type: string isDeleted: type: boolean description: Whether the object has been soft-deleted. createdAt: type: string format: date-time description: ISO 8601 timestamp of when the object was created. updatedAt: type: string format: date-time description: >- ISO 8601 timestamp of when the object was last updated. feeDetails: type: array items: type: object properties: contract: type: string currency: type: string description: ISO 4217 currency code (e.g. `NGN`). amount: type: integer description: Amount in the minor currency unit (e.g. kobo). description: type: string description: Description text. __v: type: integer description: Internal document version (Mongo). example: statusCode: 200 message: Authorization fetched successfully. data: _id: 6a43ba89134c39198fe21652 business: 696edb9889c90df3bcdbe067 customer: _id: 69ba46bb734a4457f2d063f5 business: 696edb9889c90df3bcdbe067 type: individual name: Prince Muteh phoneNumber: '7030338024' emailAddress: prince.muteh@gmail.com status: active individual: firstName: Prince lastName: Muteh otherNames: '' dob: '2026-03-18T00:00:00.000Z' identity: type: BVN number: '1234567890' billingAddress: line1: University Of Maiduguri line2: '' city: Garki state: Abuja Federal Capital Territory country: Nigeria postalCode: '600211' isDeleted: false createdAt: '2026-03-18T06:31:23.112Z' updatedAt: '2026-03-18T06:31:23.112Z' __v: 0 account: _id: 69ba46d6734a4457f2d06428 business: 696edb9889c90df3bcdbe067 type: wallet currency: NGN accountName: SUDO / PRINCE MUTEH bankCode: '999240' accountType: Current accountNumber: '5010251947' currentBalance: 0 availableBalance: 0 provider: SafeHaven providerReference: 69ba46d6012c2100246f7a38 referenceCode: subacc_1773815509991 reloadable: true isDefault: true isDeleted: false createdAt: '2026-03-18T06:31:50.409Z' updatedAt: '2026-03-18T06:31:50.409Z' charges: [] __v: 0 card: failedTransactionCount: 0 minimumBalance: 0 version: v1 _id: 69ba46d8734a4457f2d06430 business: 696edb9889c90df3bcdbe067 customer: 69ba46bb734a4457f2d063f5 account: 69ba46d6734a4457f2d06428 fundingSource: 69ba4677734a4457f2d06383 program: null type: virtual brand: Verve currency: NGN maskedPan: 506321*********3111 expiryMonth: '03' expiryYear: '2029' status: active is2FAEnabled: true is2FAEnrolled: true isDefaultPINChanged: false disposable: false refundAccount: null providerReference: 69ba46d8a61d0550d690e79e isDigitalized: false accumulatedFees: 0 totalFeesCharged: 0 feeChargeDay: 1 isDeleted: false createdAt: '2026-03-18T06:31:52.457Z' updatedAt: '2026-06-30T12:55:52.640Z' __v: 0 spendingControls: channels: atm: true pos: true web: true mobile: true allowedCategories: [] blockedCategories: [] spendingLimits: [] amount: 10005.38 fee: 5 vat: 0.38 approved: true currency: NGN status: approved authorizationMethod: online balanceTransactions: [] merchantAmount: 10000 merchantCurrency: NGN merchant: category: '0742' name: SUDO SIMULATOR merchantId: SUDOSIMULATOR01 city: JAHI state: AB country: NG postalCode: '100001' terminal: rrn: '149283196621' stan: '148345' terminalId: 3SUDOSIM terminalOperatingEnvironment: on_premise terminalAttendance: unattended terminalType: ecommerce panEntryMode: keyed_in pinEntryMode: keyed_in cardHolderPresence: true cardPresence: true transactionMetadata: channel: web type: purchase reference: '5010251947149283196621' pendingRequest: null requestHistory: - amount: 10005.38 currency: NGN approved: true merchantAmount: 10000 merchantCurrency: NGN reason: webhook_approved createdAt: '2026-06-30T12:46:01.932Z' verification: billingAddressLine1: not_provided billingAddressPostalCode: not_provided cvv: match expiry: match pin: match threeDSecure: not_provided safeToken: match authentication: pin isDeleted: false createdAt: '2026-06-30T12:46:01.932Z' updatedAt: '2026-06-30T12:46:01.932Z' feeDetails: - contract: 61a18b8a4ddab599d20344a7 currency: NGN amount: 5 description: Verve Card Authorization Fee __v: 1 '400': description: Validation error. content: application/json: schema: type: object properties: statusCode: type: integer description: >- Status code of the response. `200` indicates a successful request. message: type: string description: Human-readable description of the result. data: nullable: true description: Always `null` for error responses. example: statusCode: 400 message: Invalid authorization id. data: null '401': description: Authentication failed — missing or invalid API key. content: application/json: schema: type: object properties: statusCode: type: integer description: >- Status code of the response. `200` indicates a successful request. message: type: string description: Human-readable description of the result. data: nullable: true description: Response payload. example: statusCode: 401 message: >- Unauthorized. Provide a valid API key in the Authorization header. data: null '404': description: Not found. content: application/json: schema: type: object properties: statusCode: type: integer description: >- Status code of the response. `200` indicates a successful request. message: type: string description: Human-readable description of the result. data: nullable: true description: Always `null` for error responses. example: statusCode: 404 message: Authorization not found. data: null deprecated: false components: securitySchemes: sec0: type: apiKey in: header name: Authorization x-bearer-format: bearer x-default: '{{APIKey}}' ````