Retrieve authorization

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

authorizationIdintegerRequired
Unique identifier of the authorization.

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Response

Successful request. Returns the requested authorization.
authorizationIdinteger or null
Unique identifier that we assigned to the authorization.
createdDatedate or null

Date that we received the authorization. The format of this value is YYYY-MM-DD.

lastModifiedDatedate or null

Date that the authorization was last changed. The format of this value is YYYY-MM-DD.

authorizationResponseenum or null
Response from the issuing bank for the authorization.
preauthorizationRequestAmountinteger or null
Amount that the merchant requested for the authorization. We return the value in the currency's lowest denomination, for example, cents.
currencystring or null
Currency of the authorization. The value for the currency follows the [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) standard.
batchobject or null
Object that contains information about the batch. If we can't match a dispute to a batch, we don't return 'batch' object.
cardobject or null
Object that contains information about the card.
merchantobject or null
Object that contains information about the merchant.
transactionobject or null
Object that contains summary information about the transaction that the dispute is linked to.

Errors