REST API

Base URL

The ERP API is available at /api. For example:

GET /api/health
GET /api/agents

Authentication

• JWT: get a token at /api/auth/login and send it in the Authorization: Bearer <token> header.
• API tokens: you can also use service tokens for machine-to-machine integrations.

Formats

• Requests and responses in JSON.
• Dates in ISO 8601 format.
• Amounts as decimal numbers.

Available modules

Most modules expose CRUD endpoints following a consistent structure:

• GET /api/{module}: paginated list.
• GET /api/{module}/{id}: detail.
• POST /api/{module}: create.
• PUT /api/{module}/{id}: update.
• DELETE /api/{module}/{id}: logical deletion.

Example

curl -H "Authorization: Bearer $TOKEN" \
  https://erp.ovlicuo.com/api/clients

For more details, see the interactive Swagger docs at /api/docs.