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

# Listar órdenes

> Obtén una lista paginada de órdenes de un solo tipo por solicitud. Filtra por estado y rango de fechas. Admite los tres tipos de orden.

Usa este endpoint para obtener una lista paginada de órdenes de un solo tipo por solicitud: `fiat_to_crypto`, `crypto_to_fiat` o `fiat_to_fiat`. Aplica filtros para acotar los resultados por estado o rango de fechas. Los resultados se ordenan por `completedTime`, de la más reciente a la más antigua. El esquema de cada registro de la respuesta varía entre las órdenes de una sola moneda y las órdenes fiat a fiat; la estructura sigue el mismo patrón que el endpoint de detalle de una orden. Úsalo para paneles de conciliación, flujos de reportes y monitoreo proactivo de órdenes que requieren acción.

## Endpoint

```text theme={null}
GET https://api.velafi.com/v2/orders
```

> [!NOTE]
>
> Usa `https://api-test.velafi.com/v2/orders` para pruebas en sandbox.

## Parámetros de consulta

**orderType** `string` *required*

Tipo de orden que quieres listar. Uno de `fiat_to_crypto`, `crypto_to_fiat` o `fiat_to_fiat`.

**orderStatus** `integer`

Filtra por código de estado de la orden. `0` (el valor predeterminado) devuelve todos los estados. Usa los códigos listados en [Estados de la orden](https://docs.velafi.com/es/docs/order-statuses.md). Para `fiat_to_fiat`, el filtro compara contra el estado almacenado y no contra el reportado: `10`, `11`, `12`, `60` y `72` coinciden exactamente, mientras que `31`, `41`, `51`, `71` y `90` no coinciden exactamente con el `orderStatus` reportado. Consulta [Filtrar por estado](https://docs.velafi.com/es/docs/order-statuses.md#filtering-by-status).

**startTime** `string`

Inicio del filtro de rango de fechas como marca de tiempo Unix en milisegundos (p. ej., `"1700000000000"`). Para órdenes `fiat_to_crypto` y `crypto_to_fiat` el rango se compara contra el `completedTime` de la orden; para órdenes `fiat_to_fiat`, contra su hora de última actualización.

**endTime** `string`

Fin del filtro de rango de fechas como marca de tiempo Unix en milisegundos (p. ej., `"1800000000000"`). Se compara contra la misma marca de tiempo que `startTime`.

**currentPage** `integer`

Número de página que quieres obtener. El valor predeterminado es `1`.

**pageSize** `integer`

Número de registros por página. El valor predeterminado es `10`. El máximo es `100`.

## Campos de la respuesta

**code** `integer`

Código de estado de la respuesta. `200` indica éxito.

**msg** `string`

Mensaje de respuesta legible.

**data** `object`

Conjunto de resultados paginado.

**campos de data**

**data.currentPage** `integer`

Número de la página devuelta.

**data.size** `integer`

Número de registros por página.

**data.total** `integer`

Total de órdenes que coinciden en todas las páginas.

**data.record** `array`

Arreglo de objetos con el resumen de cada orden. Los campos varían según `orderType`.

**Campos del registro fiat a cripto / cripto a fiat**

**orderId** `string`

ID único de la orden.

**clientId** `string`

Tu ID de referencia personalizado de la orden.

**merchantId** `integer`

ID del comercio de esta orden.

**paymentId** `integer`

ID del método de pago usado en esta orden.

**country** `string`

Nombre del país de esta orden.

**crypto** `string`

Símbolo de la criptomoneda (p. ej., `"USDT"`).

**fiat** `string`

Código de la moneda fiat (p. ej., `"MXN"`).

**orderType** `string`

Tipo de orden: `fiat_to_crypto` o `crypto_to_fiat`.

**orderPrice** `string`

Tipo de cambio al crear la orden.

**cryptoAmount** `string`

Monto en cripto de esta orden.

**fiatAmount** `string`

Monto en fiat de esta orden.

**fiatFee** `string`

Comisión cobrada en fiat.

**orderStatus** `integer`

Código de estado actual de la orden.

**hasRefund** `integer`

`1` si se emitió un reembolso para esta orden; `0` en caso contrario.

**createTime** `string`

Marca de tiempo Unix (milisegundos) de la creación de la orden.

**completedTime** `string`

Marca de tiempo Unix (milisegundos) en que la orden llegó a un estado final. Hasta entonces, es igual a `createTime`.

**Campos del registro fiat a fiat**

**orderId** `string`

ID único de la orden.

**clientId** `string`

Tu ID de referencia personalizado de la orden.

**onRampMerchantId** `integer`

ID del comercio del tramo de on-ramp.

**onRampPaymentId** `integer`

ID del método de pago del tramo de on-ramp.

**onRampCountry** `string`

País del tramo de on-ramp.

**onRampFiat** `string`

Moneda fiat recaudada en el on-ramp.

**onRampFiatAmount** `string`

Monto recaudado en el on-ramp.

**onRampFiatFee** `string`

Comisión del tramo de on-ramp.

**offRampMerchantId** `integer`

ID del comercio del tramo de off-ramp.

**offRampPaymentId** `integer`

ID del pago del beneficiario del tramo de off-ramp.

**offRampCountry** `string`

País del tramo de off-ramp.

**offRampFiat** `string`

Moneda fiat entregada en el off-ramp.

**offRampFiatAmount** `string`

Monto entregado en el off-ramp.

**offRampFiatFee** `string`

Comisión del tramo de off-ramp.

**orderPrice** `string`

Tipo de cambio entre monedas al crear la orden.

**orderStatus** `integer`

Código de estado actual de la orden.

**createTime** `string`

Marca de tiempo Unix (milisegundos) de la creación de la orden.

**completedTime** `string`

Marca de tiempo Unix (milisegundos) en que se completó la orden.

## Ejemplos

> [tab] Órdenes fiat a cripto
>
> ```bash theme={null}
> curl -X GET "https://api.velafi.com/v2/orders?orderType=fiat_to_crypto&orderStatus=60&currentPage=1&pageSize=10" \
>   -H "X-BH-TOKEN: YOUR_TOKEN"
> ```
>
> ```json theme={null}
> {
>   "code": 200,
>   "msg": "SUCCESS",
>   "data": {
>     "size": 10,
>     "currentPage": 1,
>     "total": 1,
>     "record": [
>       {
>         "orderId": "493829236956962816",
>         "clientId": "f_c_0250222004",
>         "merchantId": 3,
>         "paymentId": 0,
>         "country": "Mexico",
>         "crypto": "USDT",
>         "fiat": "MXN",
>         "orderType": "fiat_to_crypto",
>         "orderPrice": "21.4104",
>         "cryptoAmount": "5.1376",
>         "fiatAmount": "110",
>         "fiatFee": "0",
>         "orderStatus": 60,
>         "hasRefund": 0,
>         "createTime": "1740214865000",
>         "completedTime": "1740214866000"
>       }
>     ]
>   }
> }
> ```

> [tab] Órdenes fiat a fiat
>
> ```bash theme={null}
> curl -X GET "https://api.velafi.com/v2/orders?orderType=fiat_to_fiat&startTime=1740000000000&endTime=1741000000000&currentPage=1&pageSize=10" \
>   -H "X-BH-TOKEN: YOUR_TOKEN"
> ```
>
> ```json theme={null}
> {
>   "code": 200,
>   "msg": "SUCCESS",
>   "data": {
>     "size": 10,
>     "currentPage": 1,
>     "total": 1,
>     "record": [
>       {
>         "orderId": "494541042692263936",
>         "clientId": "c_f_0250224003",
>         "onRampMerchantId": 3,
>         "onRampPaymentId": 17,
>         "onRampCountry": "Mexico",
>         "onRampFiat": "MXN",
>         "onRampFiatAmount": "110",
>         "onRampFiatFee": "1",
>         "offRampCountry": "Argentina",
>         "offRampMerchantId": 4,
>         "offRampPaymentId": 134,
>         "offRampFiat": "ARS",
>         "offRampFiatAmount": "6156.3",
>         "offRampFiatFee": "1",
>         "orderPrice": "55.9664",
>         "orderStatus": 31,
>         "createTime": "1740384573000",
>         "completedTime": "1740384573000"
>       }
>     ]
>   }
> }
> ```


## Related topics

- [Crear una orden de on-ramp](https://docs.velafi.com/es/api-reference/order/create-a-fiat-to-crypto-order.md)
- [Códigos de error](https://docs.velafi.com/es/docs/error-codes.md)
- [Listar monedas fiat](https://docs.velafi.com/es/api-reference/basic-configuration/get-list-of-fiat-currencies.md)
- [Listar comercios](https://docs.velafi.com/es/api-reference/merchant/get-a-list-of-merchants.md)
- [Listar webhooks](https://docs.velafi.com/es/api-reference/webhooks/get-webhook-endpoints.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.