---
title: "Get Auth Control"
method: POST
path: "/getAuthControl"
tags: ["Account-Level Controls"]
---

# Get Auth Control

`POST /getAuthControl`

Use the Get Auth Control endpoint to retrieve the velocity control details and their control IDs—at either the product level or account level, with or without MCC ranges. 

See <a href="doc:set-velocity-controls#retrieving-velocity-limits" target="_blank">Retrieving velocity limits</a> for instructions on using this endpoint.

## 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.
    - `pmt_ref_no` string — PRN. This field is populated when returning account-level velocity controls.
    - `prod_id` string — This field is populated when returning product-level velocity controls.
    - `auth_controls` object[], required — List of auth controls
      - `amount` number, float — Total transaction amount allowed per period.
      - `amount_available` number, float — Transaction amount available in the current period.
      - `amount_used` number, float — Transaction amount used in the current period.
      - `control_desc` string — Description of the velocity control.
      - `control_id` integer — The identifier for the specific velocity control.
      - `beginning_mcc` integer — The initial MCC value for the range of this control. This field is present only when MCCs are specified for the control.
      - `end_mcc` integer — The final MCC value for the range of this control. This field is present only when MCCs are specified for the control.
      - `domestic_flag` string — Whether this velocity control applies to domestic transactions, international transactions or both. **Y**—Domestic only; **N**—International only; **A**—Both
      - `start_date` string, date-time — Starting date-time of the account-level velocity control. Not populated for product-level controls.
      - `end_date` string, date-time — Ending date-time of the account-level velocity control. Not populated for product-level controls.
      - `has_pin` string — Whether the limit applies to PIN transactions, signature transactions or both. **Y**—PIN only; **N**—Signature only; **A**—Both
      - `period` string — Timespan for the velocity control. xD (x days), xM (x months), 1T (one transaction).
      - `trans_type` string — Type of transaction affected by the control: ATM, CAD, CBA, POS, VFT.
      - `transaction_count` integer — Number of allowed transactions per period.
      - `transaction_count_available` integer — Number of transactions available in the current period.
      - `transaction_count_used` integer — Number of transactions used in the current period.

---

[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/revisions/bcd728f97a18/schema)