Reference

Errors

LeadsFriday uses standard HTTP status codes and structured JSON error bodies.

400

Invalid request

Missing or malformed request fields.

401

Unauthorized

Token is missing, expired, revoked, or invalid.

403

Forbidden

Insufficient credits or unavailable service.

404

Not found

Order or endpoint was not found.

409

Conflict

Duplicate or conflicting request.

429

Rate limited

Retry after the provided delay.

500

Server error

The request failed on our side; inspect before retrying.

Error response

{
  "code": "validation_error",
  "detail": "Contact count must be at least 500.",
  "fields": { "contact_count": ["Minimum value is 500."] }
}