API Reference

Endpoint reference for the Moonlit Data API, generated from the live OpenAPI spec: search, filter values, document retrieval, and the Luna research assistant.

Try requests live in the interactive Swagger docs.

Authentication

All API requests must include your subscription key in the Ocp-Apim-Subscription-Key header. Access is provisioned by our team; see Get access.

Keep your subscription key secret. Do not expose it in client-side code or public repositories. If your key is compromised, contact our team immediately.

curl -X POST "https://api.moonlit.ai/v1.1/search/keyword_search" \
  -H "Content-Type: application/json" \
  -H "Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY" \
  -d '{"query": "huurrecht opzegging", "jurisdictions": ["Netherlands"]}'

Base URL

All API endpoints are relative to the following base URL:

https://api.moonlit.ai/v1.1

For example, the keyword search endpoint is available at https://api.moonlit.ai/v1.1/search/keyword_search.

Errors

When a request fails, the API returns a JSON body with a single detail field describing what went wrong:

{
  "detail": "Invalid or missing API key."
}

The exception is 422: FastAPI validation errors return a structured detail array listing each invalid field and the reason. These statuses appear across the API; the errors each endpoint can return are listed on its endpoint page.

Gateway errors

A 429 is returned by the API gateway before the request reaches the API, when the monthly quota for your subscription is exhausted. It has a different body shape: {"statusCode": 429, "message": "..."}. Gateway-level errors are not part of the OpenAPI spec.

Choosing the right search

Endpoints