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

# Listar pedidos

> Lista los pedidos del usuario autenticado (compras de planes, renovaciones y actualizaciones).

**provider** `string`

Filtra por método de pago. Valores posibles: `pix`, `card`, `redeem_code`.

### Respuesta

**response** `array`

Un array de pedidos, del más reciente al más antiguo.

**Mostrar objeto**

**id** `string`

El ID del pedido.

**status** `string`

Estado del pedido. Valores posibles: `unpaid`, `paid`, `cancelled`, `expired`.

**price** `number`

El precio final cobrado, después de cualquier descuento del cupón.

**provider** `string`

Cómo se pagó o se pagará el pedido. Valores posibles: `pix`, `card`, `redeem_code`.

**type** `string`

Para qué es el pedido. Valores posibles: `purchase`, `renew`, `upgrade`.

**related\_to** `object`

El plan al que se aplica el pedido.

**Mostrar objeto**

**plan** `object`

**Mostrar objeto**

**name** `string`

El nombre del plan.

**duration** `integer`

Duración en meses (1, 3 o 12).

**months** `integer`

Duración en meses (mismo valor que `duration`).

**created\_at** `string`

Cuándo se creó el pedido.

**paid\_at** `string | null`

Cuándo se pagó el pedido, o `null` si todavía no se ha pagado.

**has\_receipt** `boolean`

Indica si existe un recibo de pago para este pedido. Los recibos están disponibles en el historial de facturación del panel.

```json Response theme={null}
{
  "response": [
    {
      "id": "order-abc123",
      "status": "paid",
      "price": 24.9,
      "provider": "pix",
      "type": "purchase",
      "related_to": { "plan": { "name": "PRO", "duration": 1, "months": 1 } },
      "created_at": "2026-08-01T12:00:00.000Z",
      "paid_at": "2026-08-01T12:05:00.000Z",
      "has_receipt": true
    }
  ]
}
```

### Respuestas de error

**code** `string`

El código de error que indica el motivo del fallo. Valores posibles:

* `AUTH_TOKEN_MISSING`, `API_KEY_INVALID`, `SESSION_REVOKED`: Falta la cabecera `Authorization`, la clave de API no es válida o la sesión del panel fue revocada (`401`).
* `API_KEY_IP_DENIED`, `API_KEY_SCOPE_DENIED`: La clave de API se usa desde una IP fuera de su lista de permitidas, o no tiene el scope que requiere la ruta (`403`).
* `USER_NOT_FOUND`: No se encontró el usuario autenticado.
* `INTERNAL_SERVER_ERROR`: Se produjo un error inesperado en el servidor.

```json Error Response (401) theme={null}
{
  "code": "AUTH_TOKEN_MISSING"
}
```


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