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 and list your candidates with cURL, the CLI, Python, or 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

{
  "candidates": [
    {
      "id": "…",
      "name": "Alex Rivera",
      "email": "alex@example.com"
    }
  ],
  "meta": { "limit": 5, "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

{
  "candidates": [
    {
      "id": "…",
      "name": "Alex Rivera",
      "email": "alex@example.com"
    }
  ],
  "meta": { "limit": 5, "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

{
  "candidates": [
    {
      "id": "…",
      "name": "Alex Rivera",
      "email": "alex@example.com"
    }
  ],
  "meta": { "limit": 5, "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

{
  "candidates": [
    {
      "id": "…",
      "name": "Alex Rivera",
      "email": "alex@example.com"
    }
  ],
  "meta": { "limit": 5, "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 (same Bearer key) | [MCP](/business/mcp) |
| SDK and CLI | [Libraries](/business/libraries/overview) |
| Prices | [Pricing](/business/get-started/pricing) |