Skip to main content
GET
/
api
/
public
/
countries
{
  "Countries": [
    {}
  ],
  "Countries[].Id": 123,
  "Countries[].Name": "<string>",
  "Countries[].TwoDigitsCode": "<string>",
  "Countries[].Culture": "<string>",
  "500 Internal Server Error": {}
}

​
List Countries

Returns all countries supported by the Nexudus platform. Used by address and profile forms across the portal to populate country dropdowns and map culture codes to display names.

​
Authentication

No authentication required. This is a public endpoint.

​
Query Parameters

​
_shape
string
Comma-separated list of field paths to include in the response. When provided, only the specified fields are returned — useful for reducing payload size. Supports nested paths using dot notation. Example: _shape=Countries.Name,Countries.TwoDigitsCode.

​
Response

​
Countries
array
Array of country objects.
​
Countries[].Id
number
Numeric identifier for the country.
​
Countries[].Name
string
Display name of the country in English.
​
Countries[].TwoDigitsCode
string
ISO 3166-1 alpha-2 two-letter country code (e.g. "GB", "US", "DE").
​
Countries[].Culture
string
BCP 47 culture/locale string for the country (e.g. "en-GB", "en-US", "de-DE").

​
Example Response

{
  "Countries": [
    {
      "Id": 1,
      "Name": "United Kingdom",
      "TwoDigitsCode": "GB",
      "Culture": "en-GB"
    },
    {
      "Id": 2,
      "Name": "United States",
      "TwoDigitsCode": "US",
      "Culture": "en-US"
    }
  ]
}

​
TypeScript Integration

import endpoints from '@/api/endpoints'
import { useTypedData } from '@/api/fetchData'

const endpoint = endpoints.system.countries
// endpoint.type is { Countries: { Culture: string; Id: number; Name: string; TwoDigitsCode: string }[] }

const { resource } = useTypedData(httpClient, endpoint)
const countries = resource?.Countries ?? []

​
Usage in Portal

ContextSource file
Profile / address country pickersrc/views/profile/
Checkout country selectorsrc/views/checkout/
Virtual Office formsrc/views/virtualOffice/

​
Error Responses

​
500 Internal Server Error
error
Unexpected server-side error. Retry with exponential back-off.
MethodEndpointDescription
GET/api/public/businesses/currentGet the current location
GET/api/public/configurationGet portal configuration