400 | invalid_parameter | A query parameter or body field is missing or malformed. details.parameter names it. |
400 | invalid_json | The body is not a JSON object. |
400 | invalid_idempotency_key | The Idempotency-Key header contains other characters than letters, digits and _ . : -, or is longer than 128. |
400 | invalid_location | location_id is not an active location of this company. |
400 | timestamp_in_future | timestamp lies in the future. |
400 | timestamp_too_old | timestamp lies more than 7 days back. |
400 | email_not_supported | Employees created through the API have no email address. |
401 | missing_api_key | No Authorization: Bearer … header. |
401 | invalid_api_key | The key does not exist. |
401 | api_key_revoked | The key was revoked in Cloxo. |
401 | api_key_expired | The key passed its expiry date. |
401 | api_key_disabled | The key was disabled by Cloxo. Contact support. |
402 | subscription_inactive | The company has no active subscription or running trial. |
402 | seat_limit_reached | All employee seats of the plan are in use. |
403 | insufficient_scope | The key lacks the permission this endpoint needs. |
403 | company_inactive | The Cloxo account is deactivated. |
403 | demo_account | The demo account cannot be changed. |
404 | employee_not_found | No such employee in this company. |
404 | time_entry_not_found | No such time entry in this company. |
409 | already_clocked_in | clock_in while a shift is open. details holds the open shift. |
409 | not_clocked_in | clock_out or a break event while no shift is open. |
409 | already_on_break | break_start while a break is running. |
409 | not_on_break | break_end while no break is running. |
409 | timestamp_conflict | timestamp lies before an event that is already recorded. details.must_be_after gives the limit. |
409 | period_locked | timestamp falls in a month the employer locked. |
409 | employee_archived | The employee is archived. |
409 | employee_cannot_clock | The person is an administrator who does not clock. |
409 | clocked_in_elsewhere | The person is still clocked in at another company in Cloxo. |
409 | employee_exists | An active employee with this name exists. details.employee_id gives the id. |
409 | idempotency_key_reused | The Idempotency-Key was used before for a different event. |
413 | payload_too_large | The body is larger than 16 kB. |
415 | unsupported_media_type | The body was not sent as application/json. |
429 | rate_limited | More than 120 requests in one minute with this key (PDF reports: 10 per minute). Wait for Retry-After seconds. |
429 | too_many_failed_attempts | Too many requests with an unknown key from your address. |
500 | server_error | Our fault. Retry later and quote request_id to support. |
503 | temporarily_unavailable | Try again in a few seconds. |