Skip to main content

​
Overview

Everything your workspace does in the LumisReach dashboard, from code: AI agents that call and text people, short social videos, Lincoln AI, phone numbers, caller trust, your calls, texts and contacts, and billing. Base URL: https://api.lumisreach.com/api/v1

​
What you can do

Quick Agent Actions

Have an AI agent call, text, email or iMessage someone toward a goal, with no phone number to buy first.

Lincoln AI

Message Lincoln AI, your workspace’s assistant, and read its conversations.

Videos

Make short social videos, pay per video, and post them to your connected accounts, now or on a schedule.

MCP server

Connect Claude, Cursor or any MCP client and let the agent run the phone itself.

Calls, texts and contacts

Your most recent calls (with transcripts and recordings) and texts, everyone you have been in touch with, and your whole history with one person. Free.

Number configuration

Change the voice, prompt, transfer number, SMS agent and every other Answer setting of a number.

Call webhooks

Get a signed POST when a call starts, and the full transcript when it ends.

Inbound SMS

Get a signed POST, or a live stream, the moment someone texts one of your numbers.

Place calls

Start an outbound call from one of your numbers, with optional recording.

Caller trust

Verify caller IDs, register your business, and track each number’s spam reputation.

Billing and usage

Your plan, wallet balance, what you have used this period and what each call, text and video cost.

Sub-entities

Create and manage child workspaces, such as clinic locations or client accounts, under one organization.

​
Quick start

1

Create an API key

In the dashboard, open Settings → Developer API (app.lumisreach.com/settings/api) and create a key. See Authentication.
2

Check it works

Call GET /v1/me with the key as a Bearer token.
3

Make your first request

Start a Quick AI call, create a video, or message Lincoln AI.

​
Rate limits

Each API key can make up to 600 requests per minute (120 for a demo key). Over the limit, a request gets 429 with X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers.

​
Moved endpoints

The conversation history endpoints moved on 2026-09-30, and the old /v1/history/* paths no longer exist: GET /v1/calls/{id} now returns the full call (transcript, summary, tags, recording_url) in place of the shorter record it used to.

​
Retired endpoints

Every endpoint in this reference accepts a key from Settings → Developer API. These older routes served the discontinued Zapier app and internal tools, and are retired: /v1/appointments, /v1/campaigns, /v1/workflows, /v1/workflows/{id}/enroll, /v1/workflow_contacts, /v1/webhook_subscriptions, /v1/dialer/* and /v1/isv/* answer 405, as do POST /v1/contacts, POST /v1/calls and POST /v1/messages.