Errors

Whenever a request is unsuccessful, the Hello Tractor API returns an error response with a type and message. Use these to diagnose integration issues before contacting the integration team.

Status codes

Code	Meaning
`200`	Success
`400`	Bad request — invalid parameters
`401`	Unauthorized — missing or invalid API key
`403`	Forbidden — valid key but insufficient access
`404`	Not found
`429`	Rate limited
`500`	Server error

Error body

Example

{
  "error": {
    "type": "invalid_request_error",
    "message": "Invalid funding_source filter"
  },
  "documentation_url": "https://developers.hellotractor.com/errors"
}

Fix 401 errors by verifying your dashboard API key and Authorization: Bearer header. Fix 403 by requesting additional access via Collaborate.

Get started

Tell us what you are building and we will align on API access and telemetry integration.