100% Free Foreverx-api-keyREST / JSON

API Documentation

Everything you need to integrate global location and banking data into your applications — one API, unlimited potential.

$curl -H "x-api-key: <token>" https://api.trebtaai.com/v1/continents

Base URL

v1https://api.trebtaai.com/v1

All endpoints are prefixed with this base URL.

Location API

Auth Required

Geographic Hierarchy

Access the full global geographic hierarchy — from continents down to individual cities — through a consistent, filterable REST interface.

Method	Endpoint	Query Params	Description
GET	`/continents`List all 7 continents→ [ { id, name, code, description } ]	—	List all 7 continents
GET	`/continents/:id`Get a single continent by ID→ { id, name, code, description }	—	Get a single continent by ID
GET	`/countries`List all countries (filter by continent)→ [ { id, name, code, continentId } ]	`?continentId=`	List all countries (filter by continent)
GET	`/countries/:id`Get a single country by ID→ { id, name, code, continentId }	—	Get a single country by ID
GET	`/states`List all states (filter by country)→ [ { id, name, code, countryId } ]	`?countryId=`	List all states (filter by country)
GET	`/states/:id`Get a single state by ID→ { id, name, code, countryId }	—	Get a single state by ID
GET	`/cities`Paginated cities (filter by state)→ { data: [...], total, page, totalPages }	`?stateId=&page=&pageSize=`	Paginated cities (filter by state)
GET	`/cities/:id`Get a single city by ID→ { id, name, stateId, population }	—	Get a single city by ID

Auth Required

Financial Institutions

Query a comprehensive database of 5,000+ banks — with SWIFT codes, country mappings, founding year, and full metadata.

Method	Endpoint	Query Params	Description
GET	`/banks`Paginated bank list (filter by country)→ { data: [...], total, page, totalPages }	`?countryId=&page=&pageSize=`	Paginated bank list (filter by country)
GET	`/banks/:id`Get full details of a single bank→ { id, name, code, countryId, established }	—	Get full details of a single bank

Auth Required

Bank Branch Locator

Locate 50,000+ bank branches worldwide — full address, phone, email, city mapping, and services offered.

Method	Endpoint	Query Params	Description
GET	`/branches`Paginated branches (filter by bank or city)→ { data: [...], total, page, totalPages }	`?bankId=&cityId=&page=&pageSize=`	Paginated branches (filter by bank or city)
GET	`/branches/:id`Get full details of a single branch→ { id, name, code, bankId, address, cityId, phone, email }	—	Get full details of a single branch

X API KEY

Every endpoint requires a valid API KEY. Obtain one by registering and logging in — the X API KEY you can generate your self. One Key for all.

01
Create a free account
Register with email or OAuth (Google, GitHub, Facebook) — no credit card needed.
02
Login to get your token
POST to /auth/login. The response contains your accessToken.
03
Add the API Key header
Include the api key on every API request as shown below.
04
Make requests freely
No rate limits, no usage caps — use the API as much as you need.

Request HeaderHTTP

// Add to every request
x-api-key:  <your_api_key>

Response EnvelopeJSON

{
  "success": true,
  "data": [...],
  "total": 195,
  "page": 1,
  "totalPages": 10
}

Error Response401 / 403 / 404

{
  "success": false,
  "error": {
    "code": 102,
    "type": "invalid_access_key",
    "info": "Your API key is invalid or inactive."
  }
}

Everything you expect from a production-grade API

Standard HTTP methods with clean, predictable JSON responses on every endpoint.

Production-grade infrastructure with SLA-backed availability guarantees.

Stateless, secure API key authentication — no session management needed.

Large datasets are paginated with page, pageSize, total, and totalPages in every response.

No credit card, no rate limits, no paywalls. Free forever for all developers.

Call the API directly from browser clients and single-page apps without a proxy.

Free — No Credit Card

Create your free account in seconds and get instant access to all TREBTA AI APIs — no approval process, no waiting.