Docs / Rates

Distance

Measures the distance between two points. A point can be coordinates or a country code.

POST/v1/geo/distance

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

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

const distance = await client.distance({ country: "TR" }, { country: "DE" });

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
from	object	latitude and longitude, or country. Required.
to	object	latitude and longitude, or country. Required.

Response

A 200 response uses one call. Returns kilometers and the resolved coordinates of both points.

Errors

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

Status	Code	When
400	invalid_request	A required field is missing or has the wrong type.
401	unauthorized	The bearer token is missing or not recognized.