Introduction

One REST API runs everything in Lucra; the app is built on it too. Use it directly, through the SDK, or as tools over MCP.

Your first request

curl https://api.onlucra.com/v1/programs \
  -H "Authorization: Bearer $LUCRA_API_KEY" \
  -H "Lucra-Version: 2026-10-01"

Get a key in Settings → API and MCP. Every request sends Lucra-Version, so your integration keeps working as the API grows.

IDs

IDs start with a prefix naming the resource, like prog_00lhuAJjQgdtNt5WnqTBc95. Treat the rest as opaque.

Responses

{
  "id": "prog_00lhuAJjQgdtNt5WnqTBc95",
  "name": "Spring launch",
  "status": "open",
  "version": 3,
  "createdAt": "2026-10-01T15:04:05.000Z"
}

• References are bare IDs: program, creator, account.
• Money is in cents beside a currency; rates are percents.
• Times are UTC ISO 8601 and end in At.
• Enums can grow, so handle values you don't know.

Lists

Lists take limit (up to 100) and cursor, and return data with a nextCursor (null on the last page). Filter by field name, like status=pending,approved, or by createdAfter and createdBefore.

Nothing is deleted: set status to archived. Lists leave archived items out unless you ask for them.

Changes

Send a resource's version with a PATCH to change it only if nobody else has; a stale one returns 409 version_conflict.

Idempotency

Send an Idempotency-Key on a write and a retry returns the first response instead of writing twice. Writes that move money require one.

Errors

Errors carry a stable code, a readable detail, and a fix when there's a clear next step.

{
  "status": 422,
  "code": "invalid_request",
  "detail": "type: expected one of \"organic\"|\"paid_ads\"",
  "fix": "Fix `type` in the request body.",
  "retryable": false
}

OpenAPI

The full spec is at https://api.onlucra.com/v1/openapi.json. Browse every endpoint.