GET

api

public

countries

List Countries

curl --request GET \
  --url https://spaces.nexudus.com/api/public/countries \
  --header 'Authorization: Basic <encoded-value>'

import requests

url = "https://spaces.nexudus.com/api/public/countries"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://spaces.nexudus.com/api/public/countries', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "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

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

array

Array of country objects.

number

Numeric identifier for the country.

string

Display name of the country in English.

string

ISO 3166-1 alpha-2 two-letter country code (e.g. "GB", "US", "DE").

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

Context	Source file
Profile / address country picker	`src/views/profile/`
Checkout country selector	`src/views/checkout/`
Virtual Office form	`src/views/virtualOffice/`

Error Responses

error

Unexpected server-side error. Retry with exponential back-off.

Method	Endpoint	Description
`GET`	`/api/public/businesses/current`	Get the current location
`GET`	`/api/public/configuration`	Get portal configuration

Get Enum ValuesRetrieve the list of valid values for a named Nexudus enumeration type.

List Countries

curl --request GET \
  --url https://spaces.nexudus.com/api/public/countries \
  --header 'Authorization: Basic <encoded-value>'

import requests

url = "https://spaces.nexudus.com/api/public/countries"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://spaces.nexudus.com/api/public/countries', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "Countries": [
    {}
  ],
  "Countries[].Id": 123,
  "Countries[].Name": "<string>",
  "Countries[].TwoDigitsCode": "<string>",
  "Countries[].Culture": "<string>",
  "500 Internal Server Error": {}
}

​List Countries

​Authentication

​Query Parameters

​Response

​Example Response

​TypeScript Integration

​Usage in Portal

​Error Responses

​Related Endpoints

List Countries

Authentication

Query Parameters

Response

Example Response

TypeScript Integration

Usage in Portal

Error Responses

Related Endpoints