Introduction

Lusor gives AI agents real phones. The phones in your workspace are your own phones, such as your iPhone or Android phone, and Lusor Phones, the cloud phones Lusor runs for you. You can use the API in two ways:

Send tasks to an agent

Describe a task in plain language. A Lusor agent operates the phone until the task is done and returns the result.

Control a phone directly

Drive the phone yourself with deterministic actions: read the screen, tap, type, swipe and launch apps.

Your first request

Create an API key in the Lusor app under Settings → API Keys, then list the phones in your workspace:

curl https://api.lusor.ai/v1/devices \
  -H "X-Api-Key: $LUSOR_API_KEY"

import os, requests

r = requests.get(
    "https://api.lusor.ai/v1/devices",
    headers={"X-Api-Key": os.environ["LUSOR_API_KEY"]},
)
print(r.json())

const res = await fetch("https://api.lusor.ai/v1/devices", {
  headers: { "X-Api-Key": process.env.LUSOR_API_KEY },
});
console.log(await res.json());

The response lists each phone with its id and whether it is connected. The Quickstart takes it from there to your first agent task.

Base URL

https://api.lusor.ai

All endpoints are versioned under /v1. Requests and responses are JSON unless an endpoint says otherwise. The screenshot endpoint, for example, returns PNG bytes.

Explore the docs

Get started

Create an API key, send your first task, and learn the core concepts.

Agents & sessions

Create agents, send turns, follow sessions, and answer the agent’s questions.

Phones

The phones in your workspace, and how to control one directly.

Billing and limits

Credits, Lusor Phone minutes, errors and rate limits.

API reference

Every endpoint, with an interactive playground.