Lucid AI API quick start

Upload supported documents, track processing, and retrieve structured data through the Lucid AI REST API.

Quick Start

1
Sign up and create an API key

Register for an account, then navigate to Settings → API Keys to generate your first API key. Keys are prefixed with lucid_live_.

2
Upload a document via the API

curl -X POST https://qawaid.ai/api/v1/documents/upload \
  -H "X-API-Key: lucid_live_..." \
  -F "file=@invoice.pdf"

3
Retrieve extracted data

curl https://qawaid.ai/api/v1/documents/{id} \
  -H "X-API-Key: lucid_live_..."

Poll until processing reaches a terminal status. Successful extraction results use statuses such as COMPLETED, COMPLETED_WITH_WARNINGS, or NEEDS_REVIEW, then read the extracted_data field.

Authentication

All API requests must include your API key in the X-API-Key header:

X-API-Key: lucid_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

API keys are scoped to your organization and respect your subscription's rate limits. Keep your keys secret — do not commit them to version control.

Smart Rules

Smart Rules is managed through the authenticated Qawaid workspace. Use it to author and test rules and decision tables. The API-key examples on this page apply to Lucid document-processing endpoints.