---
title: "Consultar un pedido | Documentación de Ordering.co"
description: "Usa GET /orders/{order} para obtener un pedido. La operación pública actual es Order.find.get."
canonical: https://docs.ordering.co/es/api-reference/guides/get-order/
---

# Consultar un pedido

> **API operation:** [Open the endpoint in Scalar](https://docs.ordering.co/es/api-reference/#tag/orders/GET/orders/{order})

Usa `GET /orders/{order}` para obtener un pedido. La operación pública actual es `Order.find.get`.

El acceso puede requerir autenticación, una solicitud interna o acceso UUID de invitado configurado con un valor coincidente de `X-uuid-access-X`. Las lecturas normales se limitan a los pedidos de cliente del solicitante; `mode=dashboard` aplica acceso por rol para usuarios operativos.

Nunca publiques un hash de acceso al pedido. Usa `params` solo para las relaciones compatibles con esta operación; consulta la [Expansión de relaciones de pedidos](https://docs.ordering.co/es/api-reference/guides/orders-special-request/).

```javascript
const response = await ordering.orders(orderId).get();
```

Esta sintaxis de SDK es histórica. Confirma el paquete y la versión antes de usarla.

## Referencia de OpenAPI

**Operación:** `GET /orders/{order}`

**Parámetros de ruta**

| Nombre  | Tipo              | Obligatorio | Descripción |
| ------- | ----------------- | ----------- | ----------- |
| `order` | integer \| string | Sí          | —           |

**Parámetros de consulta**

| Nombre   | Tipo   | Obligatorio | Descripción                                                                                                                                   |
| -------- | ------ | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `params` | string | No          | Lista de campos separados por comas. La lista se cruza con $fillable del modelo; si está vacía o no es válida, se devuelven todos los campos. |
| `mode`   | string | No          | —                                                                                                                                             |

**Parámetros de encabezado**

| Nombre            | Tipo   | Obligatorio | Descripción |
| ----------------- | ------ | ----------- | ----------- |
| `X-uuid-access-X` | string | No          | —           |

**Respuestas**

| Código | Descripción                                                                                                                                                                                                                                                                        |
| ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 200    | Respuesta exitosa. El contenido de `result` varía según la operación y se devuelve como JSON.                                                                                                                                                                                      |
| 400    | Respuesta de error (error=true). Los errores de validación y de negocio comparten este código.                                                                                                                                                                                     |
| 401    | Respuesta de error para el código declarado por la operación. Consulta `result` para ver los detalles disponibles. Envelope de error: el proyecto no existe o no tiene una suscripción activa.                                                                                     |
| 404    | Respuesta vacía: la versión de API solicitada no está admitida.                                                                                                                                                                                                                    |
| 429    | Envelope de error: se excedió un límite de consumo del proyecto (o el sujeto está baneado). Lleva Retry-After y X-RateLimit-Limit/Remaining/Reset/Scope/Key.                                                                                                                       |
| 500    | Respuesta de error: falló la búsqueda o inicialización del proyecto.                                                                                                                                                                                                               |
| 503    | Envelope de error: la aplicación está temporalmente en mantenimiento. Envelope de error: el proyecto está temporalmente en mantenimiento, o los límites de consumo no se pudieron evaluar y el límite aplicable está configurado con on\_error = closed (cabecera Retry-After: 1). |

[Abrir esta operación en la Referencia de la API](https://docs.ordering.co/es/api-reference/#tag/orders/GET/orders/{order})