HTTP status codes
| Code | Meaning |
|---|---|
200 | Success |
400 | Bad request — missing or invalid field |
401 | Unauthorized — missing, expired, or invalid token |
403 | Forbidden — token valid but insufficient permissions |
404 | Resource not found |
500 | Internal server error |
Error body
All errors return a JSON body with amessage field:
Common errors
| Message | Cause | Fix |
|---|---|---|
No token provided. | x-access-token header missing | Add the header |
Unauthorized! Access Token was expired! | Token older than 24 h | Re-authenticate |
Customer not found | customerid does not exist | Verify the ID via /finance/customers |
Deal not found | dealid does not exist | Verify via /finance/deals |
WHERE parameter 'id' has invalid 'undefined' value | Required body field missing | Check required fields in the request schema |