Public API

OurByt has a small read-only API that anyone, including AI agents, can call without an account. It returns the countries and regions we sell eSIM data for, with their plans and prices in US dollars, and the countries where you can get an OurByt phone number. Buying happens in the OurByt app.

Machine-readable description

• OpenAPI: ourbyt.com/openapi.json
• API catalog (RFC 9727): ourbyt.com/.well-known/api-catalog

Endpoints

Base URL: https://api.ourbyt.com. Every endpoint is a GET and returns JSON.

GET /v1/health

Liveness + dependency health (db, redis)

GET /v1/catalogue/destinations

Destinations with a from price

• kind (query)

GET /v1/catalogue/destinations/{id}

One destination

• id (path, required)

GET /v1/catalogue/photos/{slot}

A destination photo (the URL in a destination's `image`)

• slot (path, required)

GET /v1/numbers/countries

Countries where numbers are sold

GET /v1/numbers/countries/{code}

One country and its number types

• code (path, required)

GET /v1/numbers/countries/{code}/types

Number types offered in a country

• code (path, required)

Fair use

Requests are rate limited. Prices can change at any time; the price shown in the app at checkout is the one you pay. Questions: [email protected].