---
title: "List All Authorize (Updated)"
method: POST
path: "/list (Updated)"
---

# List All Authorize (Updated)

`POST /list (Updated)`

## Request

- Base URL: `https://api.tap.company/v2/authorize`
- URL: `https://api.tap.company/v2/authorize/list (Updated)`
- Auth: API key in header `Authorization`

This endpoint returns a sorted list of previously created authorizations, with the most recent authorizations appearing first.

## Request body

- object
  - `period` object: The date range of the required authorizes.
    - `date` object: The from and to dates of the required authorizes.
      - `from` integer: The "from" date (created date of the authorize) in milliseconds (Unix epoch time).
      - `to` integer: The "to" date (created date of the authorize) in milliseconds (Unix epoch time).
  - `status` string: The status by which the list of authorized transactions need to be retrieved. Accepted values: INITIATED, IN_PROGRESS, ABANDONED, CANCELLED, FAILED, DECLINED, RESTRICTED, AUTHORIZED, CAPTURED, VOID, TIMEDOUT, UNKNOWN.
  - `sources` string[]: The list of source_id's that to be retrieved.
  - `payment_methods` string: The array of payment methods to be retrieved.
  - `customers` string[]: The array of customer_id's to be retrieved.
  - `authorizes` string: The array of authorize_id's to be retrieved.
  - `starting_after` string: The cursor for use in pagination which is an authorize ID that defines the place of an authorize_id in the list. For instance, if 50 authorizes are retrieved ending with cus_foo, then the subsequent call can include starting_after=cus_foo in order for the next page of the list to be retrieved.
  - `authorize_created` string: Created date (authorize created date), Measured in Unix Epoch Timestamp (milliseconds).
  - `mobile` string: Filter the results based on customer mobile number
  - `email` string: filter the results based on customer email
  - `limit` string: The maximum number of authorized transactions to return in a single call. Default: 25 Maximum: 50.
  - `order` 'chronological' | 'reverse_chronological': Sort the results Ascending or Descending by date
  - `order_by` string: Applying the sorting based on
  - `metadata` string: Filter the results based on meta data values
  - `currency` string: Filter the charges based on charge currency
  - `payouts` object
    - `payout_id` string[]: Array of payouts (you can specify the list of Payouts ID's to retrieve).
    - `payout_reference` string[]: Array of payouts references(you can specify the list of Payouts references's to retrieve).
  - `reference` object
    - `order` string[]: Array of orders references (you can specify the list of orders reference's to retrieve).
    - `transaction` string[]: Array of transactions references (you can specify the list of transactions reference's to retrieve).

## Response `200`

200

- object

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `205297cbfd7e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tap/apis/authorize/changes/list%20%28Updated%29/post.md)

---

[API](https://skmtc.dev/tap/apis/authorize.md) - [All operations](https://skmtc.dev/tap/apis/authorize/llms.txt) - [OpenAPI document](https://skmtc.dev/tap/apis/authorize/revisions/205297cbfd7e?raw)