API Reference

Base URL: https://api.routeon.io/api

Full contract (OpenAPI 3.1): download openapi.yaml from GitLab, or use Download spec on the synced Routeon API (Public) overview / Reference (Swagger) pages in the developer portal. Import the file into Postman, Insomnia, or any OpenAPI-compatible tool.

Every response wraps its payload in an envelope:

{
  "data": { ... },
  "error_code": null,
  "message": "Request successful"
}

Create, list, and retrieve short links.

Method Path Summary Auth
POST /v1/links/ Create a short link Bearer token
POST /v1/links/bulk Create up to 10,000 links in one request API key
POST /v1/links/list List and search links API key
GET /v1/links/{id} Get a single link by ID API key

Legacy aliases

The contract also exposes the create, bulk-create, and list operations above under an older /public/links path prefix. They are the same operations with the same request/response shapes — prefer the /v1/ paths for new integrations:

Method Path Same operation as
POST /public/links POST /v1/links/
POST /public/links/bulk POST /v1/links/bulk
POST /public/links/list POST /v1/links/list

Clicks Analytics

Method Path Summary Auth
GET /v1/analytics/clicks Aggregated click analytics, grouped by dimension API key

Domain

Method Path Summary Auth
GET /v1/domains List domains available to the account Bearer token

Note: the create-link and list-domains endpoints require a bearer (JWT) token; the other endpoints accept an API key. See Key Concepts → Authentication for details.