API Reference
Complete reference for all EntityEngine API endpoints
The EntityEngine API is organized around REST. Our API has predictable resource-oriented URLs, accepts JSON-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.
Base URL
https://app.entityengine.com/api/v1HTTP Methods
| Method | Description |
|---|---|
| GET | Retrieve resources |
| POST | Create new resources |
| PATCH | Update existing resources (partial update) |
| DELETE | Remove resources |
Pagination
List endpoints support pagination via query parameters:
| Parameter | Default | Description |
|---|---|---|
page | 1 | Page number to retrieve |
per_page | 20 | Number of items per page (max 100) |
Example
GET /api/v1/entities?page=2&per_page=50Paginated responses include a meta object:
{
"success": true,
"data": [...],
"meta": {
"page": 2,
"per_page": 50,
"total": 127,
"total_pages": 3
}
}Error Codes
The API uses conventional HTTP response codes to indicate success or failure:
| Code | Status | Description |
|---|---|---|
| 200 | OK | Request succeeded |
| 201 | Created | Resource created successfully |
| 400 | Bad Request | Invalid request parameters |
| 401 | Unauthorized | Missing or invalid API key |
| 403 | Forbidden | Insufficient permissions |
| 404 | Not Found | Resource doesn't exist |
| 429 | Too Many Requests | Rate limit exceeded |
| 500 | Server Error | Something went wrong on our end |