> ## Documentation Index
> Fetch the complete documentation index at: https://docs.en.amplopay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Search transactions

> Query transactions created through the API

Queries created transactions.

<Warning>
  Do not use this endpoint for frequent polling. Configure webhooks to receive real-time status updates.
</Warning>

## Query parameters

<ParamField query="id" type="string">
  Transaction ID returned by the API.
</ParamField>

<ParamField query="clientIdentifier" type="string">
  Identifier you sent when creating the transaction.
</ParamField>

## Request example

<RequestExample>
  ```bash theme={null}
  curl --request GET \
    --url 'https://app.amplopay.com/api/v1/gateway/transactions?clientIdentifier=5286-412312-asd-123' \
    --header 'x-public-key: SUA_CHAVE_PUBLICA_AQUI' \
    --header 'x-secret-key: SUA_CHAVE_PRIVADA_AQUI'
  ```
</RequestExample>

## Response

<ResponseField name="id" type="string" required>
  Transaction ID.
</ResponseField>

<ResponseField name="clientIdentifier" type="string" required>
  Identifier sent by your application when creating the transaction.
</ResponseField>

<ResponseField name="currency" type="string" required>
  Transaction currency.
</ResponseField>

<ResponseField name="amount" type="number" required>
  Transaction amount.
</ResponseField>

<ResponseField name="chargeAmount" type="number" required>
  Amount charged to the customer.
</ResponseField>

<ResponseField name="status" type="string" required>
  Transaction status.
</ResponseField>

<ResponseField name="paymentMethod" type="string" required>
  Payment method used for the transaction.
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "id": "cmry2h8332sgs3ub44fh7",
    "clientIdentifier": "5286-412312-asd-123",
    "currency": "BRL",
    "amount": 49.8,
    "chargeAmount": 49.8,
    "exchangeRate": 1,
    "producerExtraAmount": 0,
    "status": "FAILED",
    "statusDescription": null,
    "purchaseType": "ONCE",
    "paymentMethod": "PIX",
    "details": null,
    "errorDescription": "Transaction denied by anti-fraud",
    "webhookUrl": null,
    "availableAt": null,
    "createdAt": "2026-08-20T00:00:00.000Z",
    "refundedAt": null,
    "payedAt": null,
    "boletoInformation": null,
    "pixInformation": {
      "qrCode": "00020101065465468949845BR.GOV.BCB.PIX...",
      "image": "https://upload.wikimedia.org/wikipedia/commons/f/fa/Link_pra_pagina_principal_da_Wikipedia-PT_em_codigo_QR_b.svg",
      "base64": ""
    },
    "pixMetadata": {
      "payerBankName": "Caixa Economica Federal",
      "payerDocument": "123.456.789-00",
      "payerName": "João da Silva",
      "receiverBankName": "Banco do Brasil",
      "receiverDocument": "987.654.321-00",
      "receiverName": "Maria da Silva",
      "receiverPixKey": "98765432100"
    }
  }
  ```
</ResponseExample>