API Reference

Access your LUMA data programmatically through the REST API.

The LUMA API lets you access your financial data programmatically. Build custom integrations, automate workflows, or connect LUMA to your own tools.

#Full API documentation

For complete API documentation including all endpoints, parameters, and examples:

api.luma.ai

#Overview

The API provides access to:

  • Transactions
  • Invoices
  • Customers
  • Time tracking projects and entries
  • Financial reports
  • Documents
  • Bank accounts

#Authentication

The LUMA API supports two authentication methods:

#API Keys (for your own data)

For accessing your own LUMA data in scripts, automations, or personal tools.

  1. Go to Settings → Developer
  2. Click Create API key
  3. Give it a descriptive name
  4. Copy the key immediately (you won't see it again)

Include your API key in the Authorization header:

Authorization: Bearer your-api-key-here

#OAuth 2.0 (for user-facing apps)

For building apps that access other users' LUMA data with their permission.

  1. Create an OAuth application in Settings → Developer
  2. Implement the OAuth authorization flow
  3. Exchange authorization codes for access tokens
  4. Use access tokens in API requests

Build an OAuth app →

#Base URL

All API endpoints use:

https://api.luma.waytogrow.es/v1

#Rate limits

  • Standard: 100 requests per minute
  • Burst: Up to 200 requests in short bursts

If you exceed rate limits, you'll receive a 429 Too Many Requests response. Wait and retry with exponential backoff.

#SDKs

#NPM package

Install the LUMA SDK:

npm install @luma-ai/sdk

#MCP package

For AI tool integrations:

npx @luma-ai/mcp

MCP documentation →

#Support