Get Nationalities

This endpoint returns the list of available nationalities for a given terminal. It is typically used as part of the initial step in a dynamic location-based product selection flow, where nationality information is required to proceed with further filtering or categorization.

⸻

🔍 Description

Use this method to:

Retrieve the available nationalities for the current terminal.

Display a list of nationalities (ID + name) to the user.

Provide input for the next step in the product selection flow.

📌 Unlike product endpoints, this response does not include detailed product metadata. It only provides the identifiers and names of the available nationalities.

⸻

📥 Request Details

Method: GET

Authentication: Required

Path Parameters:

terminalId (integer): ID of the requesting terminal

⸻

📤 Response

Returns an array of nationality objects:

Field	Type	Description
id	integer	Unique identifier of nationality
name	string	Display name of nationality

Example

[
  {
    "id": 1,
    "name": "Colombia"
  },
  {
    "id": 2,
    "name": "Venezuela"
  },
  {
    "id": 3,
    "name": "Argentina"
  }
]

🧠 Usage Notes

This method provides the list of nationalities available for a given terminal.

The response is typically used to populate selection dropdowns or filters in the user interface.

Get Nationalities

Request

Request Code Samples

Responses