Skip to main content

GET /api/v1/internal/countries

Returns a list of countries resources.

This endpoint documentation is generated from the current Fastify route implementation and should be treated as the implementation-level contract for this version of the API.

Source route file: src/api/routes/internal/public/countries/get.ts

Request Method​

GET

Base URL​

https://api.userdocks.local:5000

Endpoint​

/api/v1/internal/countries

Path Variables​

No path variables.

Query Parameters​

No query parameters.

HTTP Headers​

No HTTP headers.

Successful Response​

Success status code(s): 200.

{
  "kind": "countries",
  "totalItems": 1,
  "itemsLength": 1,
  "items": [
    {
      "id": 1,
      "uuid": "11111111-1111-1111-1111-111111111111",
      "name": "Germany",
      "alpha2": "DE",
      "alpha3": "DEU",
      "createdAt": "2026-01-01T00:00:00.000Z",
      "updatedAt": "2026-01-01T00:00:00.000Z",
      "deletedAt": null
    }
  ]
}

Error Responses​

HTTP StatusExample Error
400{"errors":[{"validation":"error","code":"[E4000]","message":"Bad Request / validation error"}]}
500{"errors":[{"validation":"error","code":"[E0000]","message":"Internal Server Error"}]}

Example​

const url = `https://api.userdocks.local:5000/api/v1/internal/countries`;

const response = await fetch(url, {
  method: 'GET',
  headers: {},
});
const data = await response.json();
console.log(response.status, data);