Overview

Routeway provides a set of account endpoints that let you monitor spending, review request history, and manage API keys — all without leaving your codebase or touching the dashboard.

Account endpoints require a management key, not a regular API key. Management keys are separate credentials with access to account operations. Create one from Dashboard → Management Keys.

Available Endpoints

Usage & Billing

Method	Path	Description
GET	/v1/account/balance	Current credit balance
GET	/v1/account/activity	Paginated request history with cost per call
GET	/v1/account/analytics	Aggregated usage metrics over time

API Keys

Method	Path	Description
GET	/v1/account/keys	List all API keys
POST	/v1/account/keys	Create a new API key
GET	/v1/account/keys/:id	Get details for a specific key
PATCH	/v1/account/keys/:id	Update key settings
DELETE	/v1/account/keys/:id	Delete an API key

Rate Limits

Routeway applies rate limits per endpoint to ensure system stability and fair usage across all users. Each endpoint is governed by two limits:

Burst limit — maximum number of requests allowed within a 10-second window
Sustained limit — maximum number of requests allowed per minute

When a limit is exceeded, the API returns a 429 Too Many Requests response. Clients should implement retry logic with exponential backoff.

Method	Endpoint	Burst (10s)	Per Minute
GET	/v1/account/balance	10	120
GET	/v1/account/activity	5	60
GET	/v1/account/analytics	2	25
GET	/v1/account/keys	5	60
GET	/v1/account/keys/:id	5	60
POST	/v1/account/keys	2	12
PATCH	/v1/account/keys/:id	2	15

Quick Example — Check Your Balance

Python
Node.js
cURL

import os
import requests

# Account endpoints require a management key
headers = {"Authorization": f"Bearer {os.getenv('ROUTEWAY_MANAGEMENT_KEY')}"}

response = requests.get("https://api.routeway.ai/v1/account/balance", headers=headers)
data = response.json()

print(f"Balance: ${data['balance']:.2f}")

const response = await fetch("https://api.routeway.ai/v1/account/balance", {
  headers: {
    Authorization: `Bearer ${process.env.ROUTEWAY_MANAGEMENT_KEY}`,
  },
});

const data = await response.json();
console.log(`Balance: $${data.balance.toFixed(2)}`);

curl https://api.routeway.ai/v1/account/balance \
  -H "Authorization: Bearer $ROUTEWAY_MANAGEMENT_KEY"

{
  "balance": 4.20
}

What’s in This Section

Balance & Usage

Check your credit balance, review request activity logs, and query aggregated analytics to understand spending patterns.

API Key Management

Create, list, update, and delete API keys programmatically. Configure daily limits, minute limits, model whitelists, and subscription settings per key.

Web Search BYOK

Add Tavily, Exa, or Valyu keys in Settings and use your own search provider with @online chat requests.

Authentication

Account endpoints require a management key passed as a Bearer token:

Authorization: Bearer YOUR_MANAGEMENT_KEY

Management keys are separate from regular API keys and can only be created from the Dashboard → Management Keys page.

Regular API keys (used for model requests) cannot access account endpoints. Always use a management key for these operations.

Get Started

Platform Details

Help & Resources

Core Concepts

Account Management

Guides

Available Endpoints

Usage & Billing

API Keys

Rate Limits

Quick Example — Check Your Balance

What’s in This Section

Balance & Usage

API Key Management

Web Search BYOK

Authentication

​Available Endpoints

​Usage & Billing

​API Keys

​Rate Limits

​Quick Example — Check Your Balance

​What’s in This Section

Balance & Usage

API Key Management

Web Search BYOK

​Authentication

Available Endpoints

Usage & Billing

API Keys

Rate Limits

Quick Example — Check Your Balance

What’s in This Section

Authentication