API Reference
Complete endpoint reference for the ERIP API.
The ERIP API is organized around REST. All endpoints return JSON and use standard HTTP status codes.
Base URL
https://api.erip.io/api/v1Authentication
All data endpoints require authentication via X-Api-Key header or Authorization: Bearer <jwt>. See Authentication for details.
Endpoints
Auth
Self-service account and API key management.
POST /auth/register
POST /auth/login
GET /auth/me
GET /auth/api-keys
POST /auth/api-keys
GET /auth/credits
Companies
Company search, summary, and full risk intelligence detail.
Credit Costs
| Endpoint | Credits |
|---|---|
GET /companies/search | 1 |
GET /companies/{companyId} | 2 |
GET /companies/{companyId}/detail | 5 |
Response headers X-Credits-Remaining and X-Credits-Cost are included on every credited request. When credits are exhausted, the API returns 402 Payment Required.