Skip to main content
For HTTP status summaries, subscription gates, and rate-limit headers, see API overview.

​
Error Response Format

All errors follow a consistent format:

​
HTTP Status Codes

​
object
Request successful
​
object
Resource created successfully
​
object
Invalid request parameters or malformed request body
​
object
Invalid or missing API key
​
object
Business does not have an active subscription required for the Developer API
​
object
Resource not found
​
object
Server error. Please contact support if this persists.

​
Common Errors

​
Invalid API Key

​
object
Solution: Verify your API key is correct and included in the request header.

​
No Active Subscription

​
object
Solution: The Developer API requires a paid subscription. Upgrade your subscription plan to continue using the API.

​
Resource Not Found

​
object
Solution: Check that the UUID or source_uuid exists and is correct.

​
Invalid Request Body

​
object
Solution: Ensure all required fields are included in your request body.

​
Rate Limiting

API rate limits may apply. Check response headers for rate limit information:
  • X-RateLimit-Limit: Maximum requests per time window
  • X-RateLimit-Remaining: Remaining requests in current window
  • X-RateLimit-Reset: Time when rate limit resets
If you exceed rate limits, you’ll receive a 429 Too Many Requests response. Implement exponential backoff in your integration.

​
UUID Resolution

All update and delete operations support both uuid and source_uuid for record identification. The API automatically checks both fields when looking up records. Example:
  • If you have a record with uuid: "abc-123" and source_uuid: "xyz-789"
  • You can use either abc-123 or xyz-789 in the endpoint URL
  • Both will resolve to the same record

​
Best Practices

  1. Always check status codes before processing responses
  2. Handle errors gracefully with appropriate user feedback
  3. Implement retry logic for transient errors (5xx status codes)
  4. Respect rate limits by implementing request throttling
  5. Log errors for debugging and monitoring