# ROOTE API

Canonical URL: https://doc.roote.ai/roote-api



Use ROOTE capabilities over HTTP.

```text
https://api.roote.ai/v1
```

## Public endpoints [#public-endpoints]

| Method | Endpoint              | Capability                                                       |
| ------ | --------------------- | ---------------------------------------------------------------- |
| GET    | `/v1/geocode`         | [Geocode](/capabilities/geography/geocode)                       |
| GET    | `/v1/place-search`    | [Place Search](/capabilities/geography/place-search)             |
| GET    | `/v1/reverse-geocode` | [Reverse Geocode](/capabilities/geography/reverse-geocode)       |
| GET    | `/v1/nearby`          | [Nearby Mobility](/capabilities/shared-mobility/nearby-mobility) |
| GET    | `/v1/services/nearby` | [Nearby Services](/capabilities/urban-services/nearby-services)  |

Detailed contracts live with [Geography](/capabilities/geography), [Shared Mobility](/capabilities/shared-mobility), and [Urban Services](/capabilities/urban-services).

## Authentication [#authentication]

Use a ROOTE developer token. Start with [Authentication](/authentication), then review [API Authentication](/roote-api/api-authentication).

## OpenAPI [#openapi]

The machine-readable description is available at [api.roote.ai/openapi.json](https://api.roote.ai/openapi.json).