Docs / Countries

List divisions

Lists the first-level divisions of a country.

GET/v1/countries/{code}/divisions

import { Client } from "@liveapiio/liveapi";

const client = new Client({ token: process.env.LIVEAPI_TOKEN });

const divisions = await client.divisions("TR");

Request

Send Authorization: Bearer YOUR_TOKEN. The token stays on your server. Each library reads it from the environment and calls this endpoint for you.

Field	Type	Description
code	string	ISO country code. Path parameter.

Response

A 200 response uses one call. Each division has id, country, code, name, level, and parent_id.

Errors

A failed request returns { "error": { "code", "message" } } and does not use a call.

Status	Code	When
404	not_found	Country not found.
401	unauthorized	The bearer token is missing or not recognized.