Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: GeoArm Taxi booking Config API
version: 1.0.0
summary: Prices, timetable and booking for daily rides between Tbilisi (Georgia) and Yerevan (Armenia).
description: 'Open API for people and for AI agents acting for a person. No key is needed. A booking made here is a request: a GeoArm Taxi dispatcher confirms it with the passenger by phone or Telegram. Payment is in cash to the driver. Read GET /api/config first: it lists the valid values for a booking. Human-readable guide: https://geoarmtaxi.com/agents/'
contact:
name: GeoArm Taxi
url: https://geoarmtaxi.com/agents/
email: info@geoarmtaxi.com
servers:
- url: https://geoarmtaxi.com
tags:
- name: Config
paths:
/api/config:
get:
operationId: getConfig
summary: Current prices, seats, timetable and departure points
description: 'Everything a booking needs: currencies, car types (seats, price per passenger, optional whole-vehicle price), departure points per direction (id, names in 7 languages, coordinates) and departure times per direction. Values change; read them before each booking.'
responses:
'200':
description: The live configuration
content:
application/json:
schema:
$ref: '#/components/schemas/Config'
tags:
- Config
components:
schemas:
Config:
type: object
properties:
currencies:
type: array
items:
type: string
enum:
- GEL
- USD
- AMD
types:
type: object
description: 'Car types by id: `sprinter` (minibus), `minivan`, `sedan`.'
additionalProperties:
type: object
properties:
max:
type: integer
description: Seats
price:
$ref: '#/components/schemas/Price'
description: Per passenger, one way
whole:
$ref: '#/components/schemas/Price'
description: Whole vehicle, one way (optional)
points:
type: object
description: Departure points by direction (`tbs-evn`, `evn-tbs`).
additionalProperties:
type: array
items:
type: object
properties:
id:
type: string
name:
type: object
additionalProperties:
type: string
lat:
type: number
lng:
type: number
price:
anyOf:
- $ref: '#/components/schemas/Price'
- type: 'null'
description: The point's own price per passenger, if it has one
addressPickup:
type: boolean
description: 'Whether pick-up from an address (`point: "@addr"`) is offered'
schedule:
type: object
description: Departure times (HH:MM, Tbilisi/Yerevan time) by direction.
additionalProperties:
type: array
items:
type: string
Price:
type: object
description: Amount per currency code; a currency that is not offered is absent.
additionalProperties:
type: number
example:
GEL: 60
USD: 25
AMD: 8500