REST API Overview

Authentication, rate limits, and SDK availability.

The PeerLM REST API lets you programmatically create evaluations, trigger runs, ingest production logs, and retrieve results. Available on Pro and Enterprise plans.

Base URL

https://app.peerlm.com/api/v1

Authentication

All requests require an API key. Pass it via either header:

X-API-Key: plm_live_...

# or

Authorization: Bearer plm_live_...

Generate keys from Settings → API Keys. Keys have two scopes:

Read — list suites, runs, models, and usage
Read-Write — everything above plus creating resources, triggering runs, and ingesting logs

See Authentication for full details on key management, expiry, and revocation.

Rate Limits

Endpoint	Limit
General	200 requests / minute per key
Run creation	10 requests / 60 seconds
Audit creation	10 requests / 60 seconds

When rate limited, the API returns 429 with a Retry-After header.

Available Endpoints

Category	Endpoints	Docs
Suites & Runs	`GET/POST /suites`, `GET/POST /runs`, `GET /runs/:id/scores`	Endpoints
Prompts	`POST /system-prompts`, `POST /test-prompts`	Endpoints
Models & Usage	`GET /models`, `GET /usage`	Endpoints
Monitors	`GET/POST /workloads`, `POST /ingest`, `GET/POST /audits`	Monitors API

SDKs

Official SDK packages are available for common languages:

TypeScript / Node.js — npm install @peerlm/sdk
Python — pip install peerlm

See SDK Integration for setup guides.

Error Handling

All errors return JSON with an error field. See Error Codes & Responses for the full reference.