API Reference
Complete endpoint reference for the ERIP API.
The ERIP API exposes two surfaces over the same authentication and credit model:
- A REST API organised around resource URLs - all endpoints return JSON and use standard HTTP status codes. Documented below.
- A built-in MCP (Model Context Protocol) server at
/mcpthat surfaces the same company search and detail operations as LLM-callable tools. See MCP Server for client configuration.
Pick whichever fits your integration: REST for scripts and services, MCP for LLM agents.
Base URL
https://api.erip.io/v1Authentication
All data endpoints accept either an X-Api-Key header (user or service key) or Authorization: Bearer <jwt>. Tenant-admin endpoints under /tenant/** are Bearer-only - API keys cannot provision users or manage service keys. See Authentication for the full scheme matrix.
Endpoints
Auth
Sign-in, invite acceptance, and self-service account management.
GET /auth/accept-invite
POST /auth/request-login-link
GET /auth/login-link
POST /auth/login
GET /auth/me
GET /auth/credits
GET /auth/credits/history
GET /auth/api-keys
POST /auth/api-keys
DELETE /auth/api-keys/{keyId}
Tenant
Tenant-admin endpoints scoped to the caller's tenant. Bearer-only.
GET /tenant
PATCH /tenant/contact
GET /tenant/users
POST /tenant/users
DELETE /tenant/users/{userId}
GET /tenant/credits
GET /tenant/credits/history
GET /tenant/api-keys/service
POST /tenant/api-keys/service
DELETE /tenant/api-keys/service/{keyId}
Companies
Company search and full risk intelligence detail.
Credit Costs
| Endpoint | Credits |
|---|---|
GET /companies/search | 1 |
GET /companies/{companyId}/detail | 50 |
Costs are deducted from the caller's tenant credit pool. Response headers X-Credits-Remaining and X-Credits-Cost accompany every credited request. When the tenant's balance is exhausted the API returns 402 Payment Required.