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/v1

HTTP Methods

MethodDescription
GETRetrieve resources
POSTCreate new resources
PATCHUpdate existing resources (partial update)
DELETERemove resources

Pagination

List endpoints support pagination via query parameters:

ParameterDefaultDescription
page1Page number to retrieve
per_page20Number of items per page (max 100)
Example
GET /api/v1/entities?page=2&per_page=50

Paginated 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:

CodeStatusDescription
200OKRequest succeeded
201CreatedResource created successfully
400Bad RequestInvalid request parameters
401UnauthorizedMissing or invalid API key
403ForbiddenInsufficient permissions
404Not FoundResource doesn't exist
429Too Many RequestsRate limit exceeded
500Server ErrorSomething went wrong on our end

Resources