Docs / Countries

List countries

Lists countries. Pass q to match a name or code.

GET/v1/countries

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

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

const countries = await client.countries("turkey");

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
q	string	Optional name or code filter.

Response

A 200 response uses one call. Returns an array of country objects.

Errors

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

Status	Code	When
401	unauthorized	The bearer token is missing or not recognized.