---
title: "preauthTransactions"
method: GET
path: "/v2/preauthTransactions"
tags: ["Create & Manage Transactions"]
---

# preauthTransactions

`GET /v2/preauthTransactions`

Fetch array of the preauthorized transactions for the authorized merchant.

If the optional `id` query parameter is specified, fetches only that preauthorized transaction. If the optional `level` query parameter is specified, fetches the preauthorized transactions for that level.

<details>
<summary><strong>Error Glossary</strong> (click to expand)</summary>

| Code | HTTP Status | Message |
|------|-------------|-------------|
| `AP009` | 401 | Unauthorized |
| `AP101` | 401 | No authenticated user |
| `AP313` | 200 | Preauth ineligible for capture |
| `AP700` | 400 | Missing or invalid required parameter |
| `AP701` | 400 | Improperly formatted parameter |

</details>

## Query parameters

- `uuid` string
- `level` string
- `dateStart` string
- `dateEnd` string
- `timezone` string
- `page` integer
- `perPage` integer
- `sortBy` string
- `orderBy` string

## Headers

- `Content-Type` string, required
- `authorization` string, required

## Response `200`

Success

- object
  - `paging` object
    - `totalPages` integer
    - `totalItems` integer
    - `currentPage` integer
    - `itemsPerPage` integer
  - `transactions` PreauthTransactionResponse[]
    - `transaction` object
      - `id` string
      - `amount` object
        - `currency` string
        - `amount` integer
      - `status` string
      - `userId` string
      - `description` string
      - `attributes` object
      - `createdDate` string, date-time
      - `expiryDate` string, date-time
      - `userName` string
      - `userEmail` string, email
      - `merchantId` integer
      - `userAccountId` integer
      - `locationId` integer
      - `referenceId` string

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/aero/apis/aeropay-v2-api.md) · [All operations](https://skmtc.net/aero/apis/aeropay-v2-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aero/aeropay-v2-api/revisions/4700c4ceeaad/schema)