API Reference

API basics

Authentication, rate limits, pagination, and error handling for the public NiceData API.

Authentication

Every public API request requires an API key in the Authorization header. The bearer scheme is case-insensitive. API keys are scoped to a single organization and can be managed in Settings > API.

Authorization: Bearer nd_live_your_api_key_here

Rate limits

Rate limits protect both authenticated and unauthenticated API traffic. When a limit is exceeded, the API returns 429 Too Many Requests with a Retry-After header.

Pagination

Project and document list endpoints are paginated. Webhook list responses are not currently paginated.

{
  "page": 1,
  "per_page": 25,
  "total": 1,
  "total_pages": 1
}

Errors

Errors are returned as JSON. Validation failures can include an errors object keyed by field name.

{
  "error": "Failed to create project",
  "errors": {
    "name": [
      "can't be blank"
    ]
  }
}