Method Summary: Get Orders

The Get Orders method (GET /physical-products/sale/orders/{terminalId}/{initialDate}/{endDate}) is used to retrieve a list of order headers (summary information) for physical products associated with a specific sales terminal (terminalId) within a defined date range (initialDate and endDate).

In short, its purpose is to fetch the transaction history headers for a Point of Sale (POS) terminal over a specific period.

Key Usage Details

This method requires the following mandatory parameters to execute successfully:

Parameter	Type	Location	Purpose
`terminalId`	`string`	Path	The unique identifier of the terminal or Point of Sale (POS) for which orders are to be retrieved.
`initialDate`	`string` (`date`)	Path	The start date of the time range used to filter the orders.
`endDate`	`string` (`date`)	Path	The end date of the time range used to filter the orders.
`U`, `SH`, `ST`	`string`	Header	Security or authentication tokens required to authorize the request.

Expected Response (200 OK)

If the request is successful, the API returns an array of order objects. Each object provides the essential header information for an order:

Field	Description	Example Value
`idCart`	Order/Cart unique identifier.	`22852`
`productName`	Name of the product sold (or the main product in the order).	`TELEFONO 2COMBO 1`
`price`	Total price of the order.	`4065.744`
`orderDate`	The date the order was placed.	`2025-07-03`
`status`	Current status of the order (e.g., `PENDING`, `DELIVERED`, `CANCELED`).	`PENDING`
`localReference`	Local reference or authorization code.	`7N6UBAYCTF`
`terminalId`	The ID of the terminal that generated the order.	`8127499132`
`countryName`	Country associated with the order.	`El Salvador`

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

Examples

Example 1 Return DataExample All Orders From July

[
    {
        "idCart": 22852,
        "productName": "TELEFONO 2COMBO 1",
        "price": 4065.744,
        "orderDate": "2025-07-03",
        "status": "PENDING",
        "localReference": "7N6UBAYCTF",
        "terminalId": "8127499132",
        "countryName": "El Salvador"
    },
    {
        "idCart": 17237,
        "productName": "COMBO NAVIDEÑOCOMBO 1",
        "price": 469.969,
        "orderDate": "2026-07-08",
        "status": "DELIVERED",
        "localReference": "3B80GRDUUM",
        "terminalId": "2515943882",
        "countryName": "Senegal"
    },
    {
        "idCart": 57070,
        "productName": "COMBO 3COMBO 1",
        "price": 4946.269,
        "orderDate": "2024-11-29",
        "status": "PENDING",
        "localReference": "ADI0KDD6JT",
        "terminalId": "6268852241",
        "countryName": "Antigua and Barbuda"
    },
    {
        "idCart": 38762,
        "productName": "SIM 2COMBO 1",
        "price": 1306.316,
        "orderDate": "2026-01-26",
        "status": "PENDING",
        "localReference": "6A7S2KX4ZD",
        "terminalId": "4304962075",
        "countryName": "Anguilla"
    },
    {
        "idCart": 40912,
        "productName": "COMBO 2COMBO 1",
        "price": 8617.779,
        "orderDate": "2025-05-11",
        "status": "CANCELED",
        "localReference": "5657BYV8JW",
        "terminalId": "9499782553",
        "countryName": "Iraq"
    },
    {
        "idCart": 16084,
        "productName": "COMBO 2COMBO 1",
        "price": 6170.529,
        "orderDate": "2024-12-22",
        "status": "PENDING",
        "localReference": "74T3T87M2S",
        "terminalId": "8816924671",
        "countryName": "Myanmar"
    },
    {
        "idCart": 40109,
        "productName": "COMBO 3COMBO 1",
        "price": 6715.264,
        "orderDate": "2025-02-11",
        "status": "CANCELED",
        "localReference": "XMS5OUFZ09",
        "terminalId": "5606726231",
        "countryName": "Holy See (Vatican City State)"
    },
    {
        "idCart": 77491,
        "productName": "SIM 1COMBO 1",
        "price": 7357.208,
        "orderDate": "2025-07-29",
        "status": "CANCELED",
        "localReference": "8E5X15T4H4",
        "terminalId": "4968208560",
        "countryName": "Iran"
    },
    {
        "idCart": 49141,
        "productName": "TELEFONO 1COMBO 1",
        "price": 2865.706,
        "orderDate": "2025-10-16",
        "status": "DELIVERED",
        "localReference": "6I5541OUFM",
        "terminalId": "1555189757",
        "countryName": "Guam"
    },
    {
        "idCart": 81113,
        "productName": "COMBO NAVIDEÑOCOMBO 1",
        "price": 4462.904,
        "orderDate": "2026-03-02",
        "status": "CANCELED",
        "localReference": "UBW16GKMDT",
        "terminalId": "6734003497",
        "countryName": "Mayotte"
    },
    {
        "idCart": 51972,
        "productName": "COMBO PARA CUBACOMBO 1",
        "price": 3257.056,
        "orderDate": "2025-05-08",
        "status": "PENDING",
        "localReference": "YK625PP6VS",
        "terminalId": "8268108084",
        "countryName": "Puerto Rico"
    },
    {
        "idCart": 87330,
        "productName": "COMBO 2COMBO 1",
        "price": 1978.052,
        "orderDate": "2026-03-30",
        "status": "CANCELED",
        "localReference": "VQSLAWW592",
        "terminalId": "7819836839",
        "countryName": "Spain"
    },
    {
        "idCart": 69889,
        "productName": "TELEFONO 2COMBO 1",
        "price": 2522.966,
        "orderDate": "2026-01-29",
        "status": "DELIVERED",
        "localReference": "OWCRYW48XH",
        "terminalId": "9343457361",
        "countryName": "Libyan Arab Jamahiriya"
    },
    {
        "idCart": 69579,
        "productName": "TELEFONO MOVISTARCOMBO 1",
        "price": 9031.43,
        "orderDate": "2025-05-18",
        "status": "DELIVERED",
        "localReference": "S6MAQOPWQI",
        "terminalId": "5313686613",
        "countryName": "Morocco"
    },
    {
        "idCart": 27264,
        "productName": "COMBO 1COMBO 1",
        "price": 6324.646,
        "orderDate": "2026-02-10",
        "status": "PENDING",
        "localReference": "AI3MMOQSXW",
        "terminalId": "0679709519",
        "countryName": "Malta"
    },
    {
        "idCart": 13724,
        "productName": "TELEFONO 1COMBO 1",
        "price": 4712.839,
        "orderDate": "2025-07-10",
        "status": "CANCELED",
        "localReference": "ZYC3IV985V",
        "terminalId": "1326845997",
        "countryName": "Cambodia"
    },
    {
        "idCart": 71142,
        "productName": "TELEFONO MOVISTARCOMBO 1",
        "price": 7123.658,
        "orderDate": "2024-12-29",
        "status": "DELIVERED",
        "localReference": "5D508FFROP",
        "terminalId": "4545037436",
        "countryName": "Burundi"
    },
    {
        "idCart": 55370,
        "productName": "SIM 1COMBO 1",
        "price": 9091.249,
        "orderDate": "2025-03-08",
        "status": "DELIVERED",
        "localReference": "SWQ64WFOJD",
        "terminalId": "4911156605",
        "countryName": "Saint Barthelemy"
    },
    {
        "idCart": 75325,
        "productName": "COMBO PARA CUBACOMBO 1",
        "price": 4018.934,
        "orderDate": "2025-01-25",
        "status": "DELIVERED",
        "localReference": "AF9K3Y33AE",
        "terminalId": "4314334763",
        "countryName": "Bermuda"
    },
    {
        "idCart": 22320,
        "productName": "COMBO NAVIDEÑOCOMBO 1",
        "price": 6989.424,
        "orderDate": "2025-08-29",
        "status": "PENDING",
        "localReference": "RUH0KNJ41S",
        "terminalId": "4072224354",
        "countryName": "Gambia"
    }
]

Get Orders

Method Summary: Get Orders#

Key Usage Details#

Expected Response (200 OK)#

Request

Request Code Samples

Responses

Method Summary: Get Orders

Key Usage Details

Expected Response (200 OK)