HubstaffDeveloper Portal

Errors

API error codes and troubleshooting guide

Recent changes (1)
  1. Update

    Machine-readable error codes on all endpoints

    Every error response now includes a numeric error_code, and validation failures include a per-field details array.

    error_code
    Was: Present on a few endpoints onlyNow: Present on every error response
    details
    Was: Not returnedNow: Array of {attribute, error} on validation failures

    All 4xx/5xx responses now carry a stable numeric error_code alongside the human-readable error; see GET /v2/error_codes for the full list. Validation errors additionally return a details array pinpointing the offending fields. Several conditions that previously surfaced as a generic 500 (e.g. tracking time against a task the member is not assigned to, a project budget limit, an overlapping work break, deleting an imported time-off request, or an unknown job-site rule id) now return a specific coded 4xx instead. All fields are additive; existing integrations that key off the HTTP status keep working.

List all error codes

GET/v2/error_codes

Returns all available error codes with their descriptions. Use these codes for programmatic error handling and i18n support.

Error code ranges:

  • 10000-10999: Authentication & Authorization
  • 11000-11999: Validation
  • 12000-12999: Resource
  • 13000-13999: Rate Limiting
  • 14000-14999: Time Entries / Activities
  • 15000-15999: System

Responses

200List of error codes