# Lever API

> Lever returns company job listings and details as a workflow and API.

Lever, also known as Lever.co, lists open jobs on a company’s board and returns job details, company name, and total open jobs. List company jobs requires a company name and can filter by team, location, and workplace, with an optional maximum number of results.

- Page: https://fous.com/tools/lever
- Handle: `@lever`
- Category: [Jobs](https://fous.com/tools/category/jobs)
- Source website: https://jobs.lever.co
- Last verified: Sep 29, 2026

## Methods

### List company jobs

Operation `list_company_jobs`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

List open jobs on a company’s Lever board, with optional team, location, and workplace filters. A company without a public Lever board is not found; at most 500 matching jobs are returned.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `team` | string | no | `"Engineering"` | Part of a team name to match, for example Engineering. |
| `company` | string | yes | `"Gynger"` | Company name, for example Palantir Technologies. |
| `location` | string | no | `"New York"` | Place to match loosely in listed locations, for example New York. |
| `workplace` | string | no | `"remote"` | Work arrangement to include, for example remote. |
| `max_results` | integer | no | `3` | Maximum jobs to return, for example 100. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "company"
  ],
  "properties": {
    "team": {
      "type": "string",
      "default": "",
      "description": "Part of a team name to match, for example Engineering.",
      "examples": [
        "Engineering",
        "Legal"
      ]
    },
    "company": {
      "type": "string",
      "minLength": 1,
      "description": "Company name, for example Palantir Technologies.",
      "examples": [
        "Gynger",
        "Spotify",
        "Palantir Technologies"
      ]
    },
    "location": {
      "type": "string",
      "default": "",
      "description": "Place to match loosely in listed locations, for example New York.",
      "examples": [
        "New York"
      ]
    },
    "workplace": {
      "enum": [
        "remote",
        "hybrid",
        "on_site",
        "any"
      ],
      "type": "string",
      "default": "any",
      "description": "Work arrangement to include, for example remote.",
      "examples": [
        "remote",
        "hybrid"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 100,
      "maximum": 500,
      "minimum": 1,
      "description": "Maximum jobs to return, for example 100.",
      "x-fous-developer": true,
      "examples": [
        3,
        4,
        100
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "company": "Gynger"
    },
    {
      "company": "Spotify",
      "workplace": "remote",
      "max_results": 3
    },
    {
      "team": "Engineering",
      "company": "Palantir Technologies",
      "location": "New York",
      "workplace": "hybrid",
      "max_results": 4
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `jobs` | array |  | Matching jobs, sorted by team and then title. |
| `jobs[].team` | string or null | `"Engineering"` |  |
| `jobs[].title` | string | `"Senior Software Engineer"` |  |
| `jobs[].job_link` | string | `"https://jobs.lever.co/gynger/d59bce14-6458-4c73-be77-62db1ca5f33f"` |  |
| `jobs[].location` | string or null | `"New York City, NY"` |  |
| `jobs[].pay_range` | any |  |  |
| `jobs[].commitment` | string or null | `"Full-Time"` |  |
| `jobs[].posted_date` | string or null | `"2026-09-04"` |  |
| `jobs[].workplace_type` | string or null | `"hybrid"` |  |
| `company` | string | `"Gynger"` | Company name shown on the board. |
| `total_open_jobs` | integer | `3` | Total open jobs on the board before filters. |

**Example input**

```json
{
  "company": "Gynger"
}
```

**Example output**

```json
{
  "jobs": [
    {
      "team": "Engineering",
      "title": "Senior Software Engineer",
      "job_link": "https://jobs.lever.co/gynger/d59bce14-6458-4c73-be77-62db1ca5f33f",
      "location": "New York City, NY",
      "pay_range": {
        "period": "year",
        "maximum": 215000,
        "minimum": 175000,
        "currency": "USD"
      },
      "commitment": "Full-Time",
      "posted_date": "2026-09-04",
      "workplace_type": "hybrid"
    },
    {
      "team": "Engineering",
      "title": "Senior Software Engineer (Remote)",
      "job_link": "https://jobs.lever.co/gynger/10ad8416-19e2-4a54-9b77-1e977aeb84b5",
      "location": "New York City, NY",
      "pay_range": {
        "period": "year",
        "maximum": 215000,
        "minimum": 175000,
        "currency": "USD"
      },
      "commitment": "Full-Time",
      "posted_date": "2026-09-04",
      "workplace_type": "remote"
    },
    {
      "team": "Go-To-Market (GTM)",
      "title": "Account Executive",
      "job_link": "https://jobs.lever.co/gynger/4a53f458-1e80-4e70-bc2a-1aa9b2679b67",
      "location": "New York City, NY",
      "pay_range": {
        "period": "year",
        "maximum": 250000,
        "minimum": 200000,
        "currency": "USD"
      },
      "commitment": "Full-Time",
      "posted_date": "2026-06-10",
      "workplace_type": "hybrid"
    }
  ],
  "company": "Gynger",
  "total_open_jobs": 3
}
```

## Quick start

Replace `YOUR_API_KEY` with a Fous API key. To create one, open Developers at the bottom of Fous Studio, turn on Developer mode, then go to API keys (https://app.fous.com/keys). Change the values in `input` to run the same tool on new data.

```bash
curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@lever",
  "visibility": "public",
  "operation": "list_company_jobs",
  "version": 1,
  "input": {
    "company": "Gynger"
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
import json
import urllib.error
import urllib.request

api_key = "YOUR_API_KEY"

body = json.loads("{\n  \"api\": \"@lever\",\n  \"visibility\": \"public\",\n  \"operation\": \"list_company_jobs\",\n  \"version\": 1,\n  \"input\": {\n    \"company\": \"Gynger\"\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=180) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
const apiKey = "YOUR_API_KEY";

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(180_000),
  body: JSON.stringify({
  "api": "@lever",
  "visibility": "public",
  "operation": "list_company_jobs",
  "version": 1,
  "input": {
    "company": "Gynger"
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

## Use from an AI assistant

Connect this tool to Claude Code, Claude Desktop, Cursor, VS Code, Codex and any MCP client as its own MCP server. Each method is a typed tool whose arguments are the method’s input.

- Server URL: `https://api.fous.com/mcp/tools/lever`
- Authorization: `Authorization: Bearer <Fous API key>`

**Tools**

- `list_company_jobs`: List company jobs. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `fous_get_run`: the result of a run that was still going, by its `request_id`. Free.

Claude Code:

```bash
claude mcp add --scope user --transport http fous-lever https://api.fous.com/mcp/tools/lever --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"
```

To give the assistant every tool, connect `https://api.fous.com/mcp`: it finds one with `fous_search_tools` and runs it with `fous_run_tool`. Setup for other clients: https://fous.com/llms-full.txt.

## Use cases

- Find open roles at a company
- Filter job listings by team or location
- Compare workplace types across open roles
- Review job titles, pay ranges, and posting dates

## FAQ

### Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

### Can I call this Lever tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

### How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

### Do I need a Lever account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from jobs.lever.co when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026.

### What jobs are open at a company?

List company jobs returns matching open jobs with titles, teams, locations, and links.

### Which jobs are available in a particular location?

List company jobs can filter listings by a place matched loosely against listed locations.

### What workplace types are listed?

List company jobs can filter by workplace and returns each job’s workplace type.

## Related

- [Greenhouse API](https://fous.com/tools/greenhouse.md): Greenhouse provides public company job boards and open roles, with filtered listings capped at 500 jobs and full posting text, including identifiable pay ranges.
- [LinkedIn API](https://fous.com/tools/linkedin.md): LinkedIn returns publicly visible company information, recent company posts, open job listings and details, and similar midsized robotics companies; closed jobs, hidden details, and exhaustive company matches are unavailable.
- [Workday API](https://fous.com/tools/workday.md): Public job listings on Workday career sites.
- [Indeed API](https://fous.com/tools/indeed.md): Indeed returns public first-page listings and details for available, unexpired jobs, company employee ratings and CEO approval when available, and typical pay from public salary pages.
- [Remote OK API](https://fous.com/tools/remote-ok.md): Remote job postings from Remote OK.
- [Levels.fyi API](https://fous.com/tools/levels-fyi.md): Levels.fyi returns published per-level median annual pay, rankings of up to 50 companies by role/location median total pay, and cross-company pay comparisons for 2–10 companies.
- [Glassdoor API](https://fous.com/tools/glassdoor.md): Employee reviews and company ratings.
- [ZipRecruiter API](https://fous.com/tools/ziprecruiter.md): ZipRecruiter returns up to 100 public job listings per search and U.S. job-title pay ranges and top-paying cities where public salary pages exist.
- [All Jobs tools](https://fous.com/tools/category/jobs)