API Documentation

Build powerful integrations with the Routiq REST API. Create links, track clicks, and manage routing rules programmatically.

Quick Start

1. Get Your API Key

Create an API key from your dashboard. Include it in the Authorization header.

Authorization: Bearer rq_your_api_key_here

2. Create Your First Link

curl -X POST https://routiq.link/api/v1/links \
  -H "Authorization: Bearer rq_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/my-page",
    "slug": "my-link"
  }'

Response:

{
  "success": true,
  "data": {
    "id": "clk_abc123",
    "shortUrl": "https://routiq.link/my-link",
    "originalUrl": "https://example.com/my-page",
    "clicks": 0,
    "createdAt": "2024-01-31T12:00:00Z"
  }
}

Base URL

https://routiq.link/api/v1

All API endpoints are relative to this base URL.

Authentication

Include your API key in the Authorization header of every request:

Authorization: Bearer rq_your_api_key

API keys start with rq_ prefix.

Endpoints

POST/api/v1/links

Create a new smart link

GET/api/v1/links

List all links

Query params: page, limit, search

GET/api/v1/links/:id

Get link details

PUT/api/v1/links/:id

Update a link

DELETE/api/v1/links/:id

Delete a link

GET/api/v1/links/:id/stats

Get link analytics

Rate Limits

Plan	Requests/Second	Requests/Day
Free	10	1,000
Pro	50	50,000
Enterprise	100	Unlimited

Error Codes

Code	Description
`400`	Bad Request - Invalid parameters
`401`	Unauthorized - Invalid or missing API key
`403`	Forbidden - Insufficient permissions
`404`	Not Found - Resource doesn't exist
`429`	Too Many Requests - Rate limit exceeded
`500`	Internal Server Error

Ready to Build?

Get your API key and start integrating in minutes.

Get Free API Key →