---
title: "Get Authorization History"
method: POST
path: "/getAuthHistory"
tags: ["Transactions"]
---

# Get Authorization History

`POST /getAuthHistory`

Use the Get Authorization History endpoint to retrieve a list of authorizations that have not settled, expired, or been reversed.
- See <a href="ref:record-set-paging" target="_blank">Record-Set Pagination</a> for instructions on using the paging parameters.
- Open the Recipe below to see a response example.

## Response `default`

- object
  - `status_code` integer, nullable, required — The response status code. May return a string for some statuses.
  - `status` string, nullable, required — The condition of a process or response
  - `processing_time` number, float, nullable, required — The time elapsed in processing the transaction
  - `echo` object, nullable, required — A structure that contains transaction ID information
    - `transaction_id` string, nullable, required — An ID that represents an API transaction
    - `provider_timestamp` string, date-time, nullable, required — Store a related timestamp for reporting and troubleshooting purposes
    - `provider_transaction_id` string, nullable, required — Secondary transaction identifier (generated by a provider)
  - `system_timestamp` string, date-time, nullable, required — A system generated timestamp
  - `rtoken` string, nullable, required — A system-generated ID used for tracking
  - `errors` string[] — A list of errors generated while the request was processed
  - `response_data` object, nullable, required — A structure for the response data. It can be empty but usually will contain information.
    - `authorizations` object[], required — List of authorizations
      - `auth_id` string, required — A system-generated identifier for an authorization.
      - `details` string, required — Description provided by the merchant about the transaction (DE043)
      - `details_formatted` string, required — The same information as in the `details` field, with formatting
      - `amount` string, required — The authorization amount, in the currency of the account
      - `timestamp` string, date-time, nullable, required — The system timestamp for the authorization, in <a href="ref:system-time" target="_blank">our system time</a>
      - `type` string, required — Reference your program's authorization <a href="ref:api-reference-transaction-types" target="_blank">transaction types</a> for possible values.
      - `mcc` string, required — Category code for the merchant that initiated the transaction (DE018)
      - `merchant_id` string, required — Network-assigned identifier for a merchant (DE042)
      - `acq_id` string, required — The identifier for the acquirer (DE032)
      - `terminal_id` string, required — Identifier for the card reader at the point of sale (DE041)
      - `can_be_expired` string, required — Whether to allow an expiration on this authorization: `1` = Allow, or `0` = Do not allow
      - `original_auth_id` string, nullable, required — The `auth_id` of the previous transaction in the sequence, if any. Maps to `prior_id` in other contexts.
      - `network_code` string, nullable, required — A system-generated code to identify the network over which the transaction took place. Maps to `network_id`.
      - `local_amt` string, nullable, required — Amount in cents of the transaction based on the currency at the point of sale (DE004). 12-digit number including leading zeros.
      - `local_curr_code` string, nullable, required — Currency code for `local_amt` (DE049)
      - `settle_amt` string, nullable, required — The transaction amount, in cents, in the settlement currency (DE005). 12-digit number including leading zeros.
      - `settle_curr_code` string, nullable, required — Currency code for `settle_amt` (DE050)
      - `billing_amt` string, nullable, required — The billing amount in cents (DE006). 12-digit number including leading zeros.
      - `billing_curr_code` string, nullable, required — Currency code for `billing_amt` (DE051)
      - `iac_tax` number, float, nullable — Impuesto al Consumo. Colombian consumption tax. Required for the Mastercard Interchange Intracountry Calculation Program.
      - `iva_tax` number, float, nullable — Impuesto al Valor Agregado. Colombian value-added tax. Required for the Mastercard Interchange Intracountry Calculation Program.
      - `latest_incremental_id` string, nullable — The `auth_id` of the previous authorization in an incremental sequence, if any. This field contains the same information as `original_auth_id` and is present only by request.
      - `original_incremental_id` string, nullable — The `auth_id` of the first authorization in an incremental sequence, if any. This field is present only by request.

---

[API](https://skmtc.net/galileo-ft/apis/program-api.md) · [All operations](https://skmtc.net/galileo-ft/apis/program-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/galileo-ft/program-api/versions/bcd728f97a18/schema)