---
title: "Retrieve authorization"
method: GET
path: "/authorizations/{authorizationId}"
tags: ["Settlement"]
---

# Retrieve authorization

`GET /authorizations/{authorizationId}`

Use this method to retrieve information about an authorization.  

**Note:** To retrieve an authorization, you need its authorizationId. If you don't have the authorizationId, use our [List Authorizations](https://docs.payroc.com/api/schema/reporting/settlement/list-authorizations) method to search for the authorization.  

Our gateway returns the following information about the authorization:
- Authorization response from the issuing bank.
- Amount that the issuing bank authorized.
- Merchant that ran the authorization.
- Details about the customer's card, the transaction, and the batch.

## Path parameters

- `authorizationId` integer, required

## Headers

- `Authorization` string, required

## Response `200`

Successful request. Returns the requested authorization.

- Authorization — Object that contains information about the authorization.
  - `authorizationId` integer — Unique identifier that we assigned to the authorization.
  - `createdDate` string, date — Date that we received the authorization. The format of this value is **YYYY-MM-DD**.
  - `lastModifiedDate` string, date — Date that the authorization was last changed. The format of this value is **YYYY-MM-DD**.
  - `authorizationResponse` 'activityCountLimitExceeded' | 'alreadyReversed' | 'approved' | 'approveVip' | 'approveWithId' | 'cannotVerifyPin' | 'cardAuthenticationFailed' | 'cardTypeVerificationError' | 'cashRequestExceedsIssuerLimit' | 'cashServiceNotAvailable' | 'cidVerificationError' | 'contactCardIssuer' | 'cryptographicFailure' | 'dailyThresholdExceeded' | 'declineCvv2Failure' | 'deny' | 'denyAccountCanceled' | 'denyClosedMerchant' | 'denyNewCardIssued' | 'denyPickUpCard' | 'destinationCannotBeFoundForRouting' | 'doNotHonor' | 'duplicateTransmissionDetected' | 'error' | 'exceedsWithdrawalAmountLimit' | 'expiredCard' | 'fileTemporarilyUnavailable' | 'forceStip' | 'formatError' | 'forwardToIssuer' | 'functionNotSupported' | 'honorWithId' | 'incorrectCvv' | 'incorrectPin' | 'ineligibleForResubmission' | 'insufficientFunds' | 'invalidAccount' | 'invalidAccountNumber' | 'invalidAmount' | 'invalidAuthorizationLifeCycle' | 'invalidBillerInformation' | 'invalidCardSecurityCode' | 'invalidCurrencyCode' | 'invalidMerchant' | 'invalidResponse' | 'invalidTransaction' | 'issuerNotAvailable' | 'issuerTimeout' | 'issuerUnavailable' | 'noActionTaken' | 'noCardRecord' | 'noCheckingAccount' | 'noCreditAccount' | 'noFinancialImpact' | 'noReasonToDecline' | 'noSavingsAccount' | 'noSuchIssuer' | 'partialApproval' | 'partialAuthorization' | 'pickUpCard' | 'pickUpCardSpecialCondition' | 'pinChangeRequestDeclined' | 'pinCryptographicErrorFound' | 'pinEntryTriesExceeded' | 'pinNotChanged' | 'pleaseCallIssuer' | 'reenterTransaction' | 'referToCardIssuer' | 'referToCardIssuerSpecialCondition' | 'restrictedCard' | 'reversal' | 'reversalDataInconsistent' | 'revokeAllAuthorizationsOrder' | 'scheduledTransactionstoppedByCardholder' | 'securityViolation' | 'successful' | 'surchargeAmountNotPermitted' | 'suspectFraud' | 'systemMalfunction' | 'transactionAmountExceedsApprovalAmount' | 'transactionCannotBeCompleted' | 'transactionNotAllowedAtMerchant' | 'transactionNotAllowedAtTerminal' | 'transactionNotPermitted' | 'transactionNotPermittedToCardholder' | 'unableToGoOnline' | 'unableToLocateRecordInFile' | 'unableToVerifyPin' | 'unacceptablePin' | 'unknown' | 'unsafePin' — Response from the issuing bank for the authorization.
  - `preauthorizationRequestAmount` integer — Amount that the merchant requested for the authorization. We return the value in the currency's lowest denomination, for example, cents.
  - `currency` string — Currency of the authorization. The value for the currency follows the [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) standard.
  - `batch` BatchSummary — Object that contains information about the batch. If we can't match a dispute to a batch, we don't return 'batch' object.
    - `batchId` integer — Unique identifier of the batch.
    - `date` string, date — Date that the merchant submitted the batch.
    - `cycle` string — Indicates the cycle that contains the batch.
    - `link` Link — Object that contains HATEOAS links for the resource.
      - `rel` string, required — Indicates the relationship between the current resource and the target resource.
      - `method` string, required — HTTP method that you need to use with the target resource.
      - `href` string, required — URL of the target resource.
  - `card` CardSummary — Object that contains information about the card.
    - `cardNumber` string — Masked card number. Our gateway shows only the first six digits and the last four digits of the card number, for example, `500165******0000`.
    - `type` 'visa' | 'masterCard' | 'discover' | 'debit' | 'ebt' | 'wrightExpress' | 'voyager' | 'amex' | 'privateLabel' | 'storedValue' | 'discoverRetained' | 'jcbNonSettled' | 'dinersClub' | 'amexOptBlue' | 'fuelman' | 'unknown' — Card type, for example, Visa. **Note:** If we can’t match a dispute to a transaction, we don’t return a type object.
    - `cvvPresenceIndicator` boolean — Indicates whether the cardholder provided the Card Verification Value (CVV).
    - `avsRequest` boolean — Indicates whether the merchant used the Address Verification Service (AVS) to verify the cardholder's address.
    - `avsResponse` string — Response from the Address Verification Service (AVS).
  - `merchant` MerchantSummary — Object that contains information about the merchant.
    - `merchantId` string — Unique identifier that the processor assigned to the merchant.
    - `doingBusinessAs` string — Trading name of the business.
    - `processingAccountId` integer — Unique identifier that we assigned to the processing account.
    - `link` Link — Object that contains HATEOAS links for the resource.
      - `rel` string, required — Indicates the relationship between the current resource and the target resource.
      - `method` string, required — HTTP method that you need to use with the target resource.
      - `href` string, required — URL of the target resource.
  - `transaction` TransactionSummary — Object that contains summary information about the transaction that the dispute is linked to.
    - `transactionId` integer, nullable — Unique identifier of the transaction. If we can't match a dispute to a transaction, we don't return the transactionId or link object.
    - `type` 'capture' | 'return' — Indicates the type of transaction.
    - `date` string, date — Date of the transaction. The format of this value is **YYYY-MM-DD**.
    - `entryMethod` 'barcodeRead' | 'smartChipRead' | 'swipedOriginUnknown' | 'contactlessChip' | 'ecommerce' | 'manuallyEntered' | 'manuallyEnteredFallback' | 'swiped' | 'swipedFallback' | 'swipedError' | 'scannedCheckReader' | 'credentialOnFile' | 'unknown' — Describes how the merchant received the payment details. If we can't match a dispute to a transaction, we don't return an entryMethod object.
    - `amount` integer — Total amount of the transaction. The value is in the currency's lowest denomination, for example, cents.
    - `link` Link — Object that contains HATEOAS links for the resource.
      - `rel` string, required — Indicates the relationship between the current resource and the target resource.
      - `method` string, required — HTTP method that you need to use with the target resource.
      - `href` string, required — URL of the target resource.

## Other responses

- `400` — Invalid request
- `401` — Identity could not be verified
- `403` — Do not have permissions to perform this action
- `404` — Resource not found
- `406` — Not acceptable
- `500` — An error has occured

---

[API](https://skmtc.dev/payroc/apis/schema.md) · [All operations](https://skmtc.dev/payroc/apis/schema/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/payroc/schema/revisions/1d9d3e305945/schema)