--- title: "List customer orders" method: GET path: "/ordering/customers/{externalCustomerId}/orders" tags: ["Ordering API"] --- # List customer orders `GET /ordering/customers/{externalCustomerId}/orders` ## Request - Base URL: `https://api.service.getjusto.com/v3` - URL: `https://api.service.getjusto.com/v3/ordering/customers/{externalCustomerId}/orders` - Auth: HTTP bearer Lista órdenes creadas por la app autenticada para el customer. ## Path parameters - `externalCustomerId` string, required ## Query parameters - `page` number - `limit` number ## Response `200` List customer orders - object - `success` boolean, required - `data` OrderingOrdersPage, required: Página de pedidos de un customer. - `items` OrderingOrder[]: Pedidos de la página. - `_id` string: ID del pedido. - `orderStatus` 'pending' | 'waiting' | 'preparing' | 'delivering' | 'done' | 'cancelled': Estado operacional del pedido. - `paymentStatus` 'pending' | 'done' | 'error' | 'blocked' | 'inReview' | 'waitingForAdditionalPayment': Estado del pago del pedido. - `isScheduled` boolean: Indica si el pedido es programado. - `isConfirmed` boolean: Indica si el pedido programado fue confirmado. - `websiteId` string: ID de la marca. - `storeId` string: ID del local. - `code` string: Código único del pedido en Justo. - `fullCode` string: Código del pedido con el correlativo diario de la marca. - `userId` string: ID del usuario que creó el pedido. - `createdAt` string, date-time: Fecha de creación del pedido. - `address` ApiOrderAddress: Dirección de entrega del pedido. - `_id` string: ID de la dirección. - `placeId` string: ID del lugar asociado a la dirección. - `address` string: Dirección principal en formato legacy. - `addressLine2` string: Departamento, oficina u otra información complementaria. - `addressSecondary` string: Comuna, ciudad o referencia secundaria de la dirección. - `location` object: Coordenadas geográficas. - `lat` number: Latitud. - `lng` number: Longitud. - `menuId` string: ID del menú desde el que se creó el pedido. - `deliveryType` 'delivery' | 'go' | 'serve': Tipo de entrega del pedido. - `deliverAt` string, date-time: Fecha en que el pedido debe ser entregado o retirado. - `timeText` string: Texto legible con la ventana estimada de entrega. - `paymentType` string: Medio de pago seleccionado. - `paymentTypeLabel` string: Nombre legible del medio de pago. - `paymentTypeIsIntegration` boolean: Indica si el medio de pago viene de una integración. - `tipAmount` number: Monto de propina. - `amountToPay` number: Monto total a pagar por el cliente, incluyendo propina. - `deliveryFee` number: Precio del despacho cobrado al cliente. - `deliveryFeeWithoutDiscount` number: Precio original del despacho antes de descuentos aplicados sobre el costo de entrega. Es un campo opcional de compatibilidad y solo se informa para integraciones legacy específicas. - `serviceFee` number: Cargo de servicio cobrado al cliente. - `itemsPrice` number: Precio de los productos, sin propina ni despacho. - `totalPrice` number: Monto del pedido sin propina. - `baseItemsPrice` number: Precio original de los productos antes de descuentos de producto, promociones, cupón, puntos o Justo Coins. Corresponde a la suma de amount * baseUnitPrice de los items. - `baseTotalPrice` number: Total original del pedido antes de descuentos, sin propina. Se calcula como baseItemsPrice + deliveryFee + serviceFee, usando el deliveryFee ya neto si el cupón descontó el despacho. - `itemsPriceBeforeDiscountsAfterProductDiscount` number: Precio de los productos después de descuentos propios del producto o promociones de producto, pero antes de cupón, puntos, Justo Coins y otros descuentos posteriores. - `totalPriceBeforeDiscountsAfterProductDiscount` number: Total del pedido después de descuentos propios del producto o promociones de producto, pero antes de cupón, puntos, Justo Coins y otros descuentos posteriores. Se calcula como itemsPriceBeforeDiscountsAfterProductDiscount + deliveryFee + serviceFee. - `discountedAmountAfterProductDiscount` number: Monto descontado después de aplicar descuentos propios del producto o promociones de producto y antes de separar quién financia el descuento. Se calcula como totalPriceBeforeDiscountsAfterProductDiscount - totalPrice e incluye descuentos posteriores como cupón, puntos de la marca y Justo Coins. - `justoCoinsDiscount` number: Monto descontado usando Justo Coins. Se limita al precio disponible del carrito después de cupón y otros descuentos aplicables, para evitar descontar más que el saldo pagable. - `websiteCoinsDiscount` number: Monto descontado usando puntos o coins del programa de fidelidad de la marca. Se limita al precio disponible del carrito después de cupón, Justo Coins y otros descuentos aplicables. - `totalDiscount` number: Monto total descontado del pedido frente al precio base. Es un campo derivado y se calcula como baseTotalPrice - totalPrice. - `amountFinancedByWebsite` number: Parte del descuento total financiada por la marca. Se calcula desde discountedAmountAfterProductDiscount restando la parte financiada por Justo. - `amountFinancedByJusto` number: Parte del descuento total financiada por Justo. Incluye Justo Coins y la porción del cupón financiada por Justo cuando aplica. - `expectedPreparationDuration` number: Tiempo estimado de preparación en minutos. - `deliveryDuration` number: Tiempo estimado de despacho en minutos. - `cashAmount` number: Monto que el cliente declara pagar si el medio de pago es efectivo. - `source` string: Origen del pedido. - `buyerName` string: Nombre del cliente. - `phone` string: Teléfono del cliente. - `email` string: Email del cliente. - `couponId` string: ID del cupón usado. - `couponName` string: Nombre del cupón usado. - `couponCode` string: Código del cupón usado. - `couponExternalId` string: ID externo del cupón usado, si el cupón lo tiene configurado. - `couponDiscount` number: Monto descontado por cupón. Puede incluir descuento sobre productos y, según el tipo de cupón, descuento sobre el despacho. - `couponPercentageOff` number: Porcentaje de descuento configurado en el cupón, cuando el cupón es porcentual. - `couponType` string: Tipo de cupón usado para calcular el descuento. - `promotionDiscount` number: Monto total descontado por promociones aplicadas a productos del pedido. Se calcula sumando items[].promotionDiscount. - `promotionIds` string[]: IDs únicos de las promociones aplicadas a los items del pedido. - `flagColor` string: Color de la bandera del pedido en POS. - `items` ApiOrderItem[]: Detalle de los productos vendidos en el pedido. - `_id` string: ID del item del pedido. - `product` object: Producto asociado al item. - `_id` string: ID Justo del producto. - `name` string: Nombre del producto al momento de la compra - `externalId` string: ID externo del producto configurado por la marca. - `metadata` object: Metadata del producto escrita por API v3. - `priceMetadata` object: Metadata del precio/disponibilidad escrita por API v3. - `unitPrice` number: Precio unitario con descuento, sin incluir descuento de cupón. - `baseUnitPrice` number: Precio unitario original antes de descuentos. - `productPrice` number: Precio del producto con descuento. - `baseProductPrice` number: Precio original del producto antes de descuentos. - `amount` number: Cantidad de este producto en el pedido. - `isReward` boolean: Indica si el item es una yapa (premio): un producto gratis que el cliente agregó al alcanzar el monto mínimo del pedido. Su precio siempre es 0. - `comment` string: Instrucciones adicionales para este producto. - `description` string: Resumen en texto de los modificadores e instrucciones del item. - `promotionId` string: ID de la promoción aplicada al item. - `promotionDiscount` number: Monto descontado por promoción en el item. - `promotionType` string: Tipo de promoción aplicada al item. - `promotionLabel` string: Etiqueta visible de la promoción aplicada al item. - `modifiers` ApiOrderItemModifier[]: Modificadores seleccionados para el item. - `modifierId` string: ID Justo del modificador. - `externalId` string: ID externo del modificador configurado por la marca. - `name` string: Nombre del modificador. - `shortName` string: Nombre corto del modificador. - `metadata` object: Metadata del modificador escrita por API v3. - `description` string: Resumen en texto de las opciones seleccionadas. - `countById` object: Cantidad seleccionada por ID Justo de opción. - `countByExternalId` object: Cantidad seleccionada por ID externo de opción. - `options` object[]: Opciones seleccionadas para este modificador. - `optionId` string: ID Justo de la opción. - `name` string: Nombre de la opción. - `price` number: Precio pagado por la opción. - `externalId` string: ID externo de la opción configurado por la marca. - `metadata` object: Metadata de la opción escrita por API v3. - `priceMetadata` object: Metadata del precio/disponibilidad escrita por API v3. - `transaction` ApiOrderTransaction: Transacción de pago asociada al pedido. - `_id` string: ID de la transacción. - `totalPrice` number: Monto total de la transacción. - `paymentType` string: Medio de pago usado en la transacción. - `cardType` string: Tipo de tarjeta usada, si aplica. - `cardLast4` string: Últimos cuatro dígitos de la tarjeta, si aplica. - `status` string: Estado de la transacción. - `deliveries` ApiOrderDelivery[]: Despachos asociados al pedido. - `_id` string: ID del despacho. - `price` number: Precio del despacho. - `status` 'active' | 'canceled' | 'cancelled' | 'done' | 'error' | 'pending' | 'scheduled' | 'delivering' | 'waiting' | 'unconfirmed': Estado del despacho. - `placeName` string: Nombre del lugar de destino. - `isCash` boolean: Indica si el despacho se paga en efectivo. - `instructions` string: Instrucciones para el despacho. - `driverPassword` string: Código que debe presentar el repartidor al retirar el pedido. - `fromLocation` object: Coordenadas geográficas. - `lat` number: Latitud. - `lng` number: Longitud. - `toLocation` object: Coordenadas geográficas. - `lat` number: Latitud. - `lng` number: Longitud. - `trackingURL` string: URL de seguimiento del despacho. - `orderId` string: ID del pedido asociado al despacho. - `activatesAt` string, date-time: Fecha en que se activa el despacho. - `createdAt` string, date-time: Fecha de creación del despacho. - `forDate` string, date-time: Fecha objetivo del despacho. - `nearStoreAt` string, date-time: Fecha en que el repartidor llegó cerca del local. - `pickupAt` string, date-time: Fecha de retiro del pedido. - `nearClientAt` string, date-time: Fecha en que el repartidor llegó cerca del cliente. - `completedAt` string, date-time: Fecha en que se completó el despacho. - `canceledAt` string, date-time: Fecha de cancelación del despacho. - `deliveryExpectedAt` string, date-time: Fecha estimada de entrega. - `estimatedArrivalAtStoreAt` string, date-time: Fecha estimada de llegada del driver al local. - `driverReceivedAt` string, date-time: Fecha en que el driver recibió el pedido, si aplica. - `driverInformation` object: Información del driver asignado, si está disponible. - `deliveryInformation` object: Información adicional del despacho, si está disponible. - `externalId` string: ID externo del despacho, si existe. - `specialCode` string: Código externo o especial del despacho, si existe. - `orderParams` object: Parámetros adicionales del pedido. - `hasManagedDelivery` boolean: Indica si el despacho es gestionado por Justo. - `gift` object: Información de regalo, si el pedido fue marcado como regalo. - `billing` object: Información de facturación del cliente. - `cancellationInfo` object: Información de cancelación del pedido. - `deliveryZoneName` string: Nombre de la zona de despacho aplicada al pedido. - `paymentGatewayUrl` string, nullable: URL donde el cliente paga el pedido con el medio de pago online seleccionado (ej. tarjeta o PSE). El link es válido por 2 horas desde la creación del pedido; si vence sin pago, el pedido no se cobra y hay que crear uno nuevo. Es null si el pago ya se hizo, si el link venció, si el pedido fue cancelado o si el medio de pago no genera link. - `totalCount` number: Total de pedidos. - `totalPages` number: Total de páginas. - `hasNextPage` boolean: Indica si existe una página siguiente. - `hasPreviousPage` boolean: Indica si existe una página anterior. ## Other responses - `400`: Invalid request - `401`: Invalid bearer token - `404`: Resource not found ## Changes - **2026-10-31** `4ad06bd631ce`: 1 breaking, 62 warning, 1 info - the `data/items/items/` response's property type changed from `object` to no type for status `200` - removed the optional property `data/items/items/_id` from the response with the `200` status - removed the optional property `data/items/items/address` from the response with the `200` status - removed the optional property `data/items/items/amountFinancedByJusto` from the response with the `200` status - …60 more - **2026-06-17** `cc5462313ceb`: 6 warning - removed the optional property `data/items/items/deliveries/items/driverInformation/categoryId` from the response with the `200` status - removed the optional property `data/items/items/deliveries/items/driverInformation/code` from the response with the `200` status - removed the optional property `data/items/items/deliveries/items/driverInformation/image` from the response with the `200` status - removed the optional property `data/items/items/deliveries/items/driverInformation/name` from the response with the `200` status - …2 more - …earlier changes not shown [Operation history](https://skmtc.dev/getjusto/apis/justo-api/changes/ordering/customers/:externalCustomerId/orders/get.md) --- [API](https://skmtc.dev/getjusto/apis/justo-api.md) - [All operations](https://skmtc.dev/getjusto/apis/justo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getjusto/apis/justo-api/revisions/c810bd8246fd?raw)