Coding agent documentation index Fetch the complete documentation index at: https://docs.worklittle.com/docs-agent-manifest.json Use this file to discover all available pages before exploring further.

Quickstart

Create an API key, then list your candidates. Official clients: cURL, CLI, Python, and TypeScript.

Call the API

cURL

#### 1. Create an API key

Sign in to Worklittle Business, open API keys, and choose Create API key. Copy the sk-wl-api01-... secret once.

Give the key jobs:applications. If paid routes return 402 Payment Required, open Billing and fix billing before retrying.

#### 2. Set your API key

Export the key as an environment variable. The SDK and CLI read WORKLITTLE_API_KEY automatically.

export WORKLITTLE_API_KEY="sk-wl-api01-..."

#### 3. List candidates

Send a GET request to https://api.worklittle.com. Any language with HTTPS can do the same. Schema: OpenAPI.

curl -s "https://api.worklittle.com/candidates?limit=5" \
  -H "Authorization: Bearer $WORKLITTLE_API_KEY"

Output

{
  "data": [
    {
      "id": "…",
      "name": "Alex Rivera",
      "email": "alex@example.com",
      "stage": "Applied"
    }
  ],
  "meta": { "next_cursor": "…" }
}

CLI

#### 1. Create an API key

Sign in to Worklittle Business, open API keys, and choose Create API key. Copy the sk-wl-api01-... secret once.

Give the key jobs:applications. If paid routes return 402 Payment Required, open Billing and fix billing before retrying.

#### 2. Install the CLI

brew install worklittle/tap/worklittle

Other install options: CLI.

#### 3. Set your API key

Export the key as an environment variable. The SDK and CLI read WORKLITTLE_API_KEY automatically.

export WORKLITTLE_API_KEY="sk-wl-api01-..."

#### 4. Run a command

worklittle candidates list --limit 5 --pretty

Output

{
  "data": [
    {
      "id": "…",
      "name": "Alex Rivera",
      "email": "alex@example.com",
      "stage": "Applied"
    }
  ],
  "meta": { "next_cursor": "…" }
}

Python

#### 1. Create an API key

Sign in to Worklittle Business, open API keys, and choose Create API key. Copy the sk-wl-api01-... secret once.

Give the key jobs:applications. If paid routes return 402 Payment Required, open Billing and fix billing before retrying.

#### 2. Set your API key

Export the key as an environment variable. The SDK and CLI read WORKLITTLE_API_KEY automatically.

export WORKLITTLE_API_KEY="sk-wl-api01-..."

#### 3. Create a project and install the SDK

pip install worklittle

Full install notes: Python SDK.

#### 4. Create your code

Create a file called quickstart.py:

from worklittle import Worklittle

wl = Worklittle()
page = wl.candidates.list(limit=5)
print(page)

#### 5. Run your code

python quickstart.py

Output

{
  "data": [
    {
      "id": "…",
      "name": "Alex Rivera",
      "email": "alex@example.com",
      "stage": "Applied"
    }
  ],
  "meta": { "next_cursor": "…" }
}

TypeScript

#### 1. Create an API key

Sign in to Worklittle Business, open API keys, and choose Create API key. Copy the sk-wl-api01-... secret once.

Give the key jobs:applications. If paid routes return 402 Payment Required, open Billing and fix billing before retrying.

#### 2. Set your API key

Export the key as an environment variable. The SDK and CLI read WORKLITTLE_API_KEY automatically.

export WORKLITTLE_API_KEY="sk-wl-api01-..."

#### 3. Create a project and install the SDK

npm install worklittle

Full notes: TypeScript SDK.

#### 4. Create your code

Create a file called quickstart.ts:

import { createWorklittle } from "worklittle";

const wl = createWorklittle();
const page = await wl.candidates.list({ limit: 5 });
console.log(page);

#### 5. Run your code

npx tsx quickstart.ts

Output

{
  "data": [
    {
      "id": "…",
      "name": "Alex Rivera",
      "email": "alex@example.com",
      "stage": "Applied"
    }
  ],
  "meta": { "next_cursor": "…" }
}

Next

| Goal | Start here |
| --- | --- |
| Pipeline | [Manage candidates](/business/api/manage-candidates) |
| Publish a job | [Post a job](/business/api/post-a-job) |
| Public career board | [Public job board](/business/api/public-job-board) |
| Org setup | [Manage organization](/business/api/manage-organization) |
| MCP | [MCP](/business/mcp) — `https://mcp.worklittle.com` with the same Bearer key |
| SDK reference | [Libraries](/business/libraries/overview) |
| Prices | [Pricing](/business/get-started/pricing) |
| Agents | [Agent Quickstart](/use-cases/agent-quickstart) |