> ## 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.

# Obtener el estado de un pedido

> Devuelve el estado actual de un único pedido.

**orderId** `string` *required*

El ID del pedido.

### Respuesta

**response** `object`

**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, una vez aplicado el descuento del cupón, si lo hay.

**expires\_at** `string | null`

Cuándo caduca el pedido sin pagar, en ISO 8601 (72 horas después de crearse el pedido). `null` cuando
el pedido no tiene caducidad.

**allowed\_payment\_methods** `string[]`

Métodos de pago que acepta el pedido (`pix`, `card`). El plan Economy devuelve `["pix"]`.

**related\_to** `object`

El plan al que se aplica el pedido.

**Mostrar objeto**

**plan** `object`

**Mostrar objeto**

**name** `string`

El nombre del plan.

**months** `integer`

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

```json Response theme={null}
{
  "response": {
    "id": "order-abc123",
    "status": "unpaid",
    "price": 24.9,
    "expires_at": "2026-10-16T12:00:00.000Z",
    "allowed_payment_methods": ["pix"],
    "related_to": { "plan": { "name": "PRO", "months": 1 } }
  }
}
```

### 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 que no está en su lista de permitidas, o no tiene el ámbito que requiere la ruta (`403`).
* `USER_NOT_FOUND`: No se encontró el usuario autenticado.
* `ORDER_NOT_FOUND`: El pedido indicado no existe.
* `FORBIDDEN`: El pedido no pertenece al usuario autenticado.
* `INTERNAL_SERVER_ERROR`: Se produjo un error inesperado en el servidor.

```json Error Response (404) theme={null}
{
  "code": "ORDER_NOT_FOUND"
}
```

```json Error Response (403) theme={null}
{
  "code": "FORBIDDEN"
}
```


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