# API · consult

> Query the status and processed amount of a single transaction.

- kind: api-operation
- status: stable
- api_version: v1
- last_verified: 2026-10-20
- url: https://tilopay.com/en/developers/api/procesos-operativos/consult

```http
POST /api/v1/consult
```

## What it does [#que-hace]

Queries a specific transaction: returns the processed amount and the status of the transaction.

## Authentication [#autenticacion]

Requires the API bearer token in the `Authorization` header — see [authentication](/en/developers/api/autenticacion).

## Parameters [#parametros]

<Param id="consult-parametro-key" name="key" type="string" required>
Tilopay integration key.
</Param>

<Param id="consult-parametro-ordernumber" name="orderNumber" type="string" required>
Order number being queried.
</Param>

<Param id="consult-parametro-merchantid" name="merchantId" type="string">
Merchant id.
</Param>

## Request example [#request]

The `<...>` values are placeholders: replace them with your own credentials and data.

```json
{
  "key": "<api_key>",
  "orderNumber": "1212122",
  "merchantId": ""
}
```

## Response [#respuesta]

```json
{
  "type": "200",
  "message": "",
  "response": [
    {
      "id_tilopay": 734312,
      "orderNumber": "1212122",
      "amount": "5.00",
      "currency": "USD",
      "merchantId": "88803956",
      "code": "1",
      "response": "Transacción aprobada",
      "auth": "123456",
      "commission": 0.18,
      "iva_commission": 0.02,
      "retention_iva": 0.27,
      "retention_rent": 0.09,
      "cost": 0.35,
      "cost_iva": 0.05,
      "net_to_liquidate": "4.04",
      "capture": "Capture",
      "card": "4021",
      "last": "5221",
      "environment": "Test",
      "type": "Payment",
      "date": "2024-07-31 16:59:20"
    }
  ]
}
```

To interpret a response that is not a success, see [how to read an error response](/en/developers/api/procesos-operativos/errors).