> For the complete documentation index, see [llms.txt](https://developer.parvenu.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.parvenu.io/get-enrichment-results/download-jobs-list.md).

# Download Jobs List

Download the job posts saved on a specific list.

## Download Jobs List

<mark style="color:green;">`POST`</mark> `/download_list_jobs`

{% hint style="info" %}
Downloading list data is **free** — you've already paid for the enrichment.
{% endhint %}

Return the job posts saved on a list that was previously populated by a job search. Pass the `listname` to download its job-post rows. When the list has also been people-enriched, each row includes the matched contact fields (name, title, email, LinkedIn URL) alongside the job fields.

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

| Name                    | Type              | Description                                                                                                                         |
| ----------------------- | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| `api_key`               | string (required) | Your API Key.                                                                                                                       |
| `listname`              | string            | The list to download job posts from.                                                                                                |
| `limit`                 | integer           | Optional. Rows per page (minimum 1). Omit to download every job post.                                                               |
| `offset`                | integer           | Optional. Rows to skip before the page starts (minimum 0, default 0). Use with `limit` to read a large list in pages.               |
| `include_empty_columns` | boolean           | Optional, default `false`. Columns that are empty on every returned row are left out. Set `true` to get every column, empty or not. |

**Response**

The job rows are under `data`, and `total` is how many rows are in this response. See [Response Format](/getting-started/response-format.md) for the fields every endpoint returns.

Pages and empty columns work the same way as [Download List Data](/get-enrichment-results/download-list-data.md): a field below is left out when no job post on the page has a value for it, and a page with fewer rows than `limit` is the last one.

| Field                  | Description                                                |
| ---------------------- | ---------------------------------------------------------- |
| `job_id`               | LinkedIn job posting id.                                   |
| `job_title`            | Job title.                                                 |
| `organization_name`    | Hiring company.                                            |
| `job_location`         | Location text on the posting.                              |
| `job_url`              | Link to the posting.                                       |
| `posted_at`            | Date posted, `YYYY-MM-DD`.                                 |
| `employment_type`      | e.g. `Full-time`.                                          |
| `seniority`            | e.g. `Director`.                                           |
| `job_function`         | Job function on the posting.                               |
| `company_website`      | Hiring company website.                                    |
| `company_linkedin_url` | Hiring company LinkedIn page.                              |
| `headcount`            | Hiring company headcount when known.                       |
| `description_text`     | Full posting text.                                         |
| `extra`                | Any remaining provider fields that have no canonical name. |

**Example**

{% tabs %}
{% tab title="Input" %}

```json
{
  "api_key": "your_api_key",
  "listname": "pm_jobs",
  "limit": 500,
  "offset": 0
}
```

{% endtab %}

{% tab title="Output" %}

```json
{
  "status": "success",
  "data": [
    {
      "job_title": "Product Manager",
      "organization_name": "Teleflex",
      "job_location": "Morrisville, NC",
      "job_url": "https://www.linkedin.com/jobs/view/4382179543",
      "posted_at": "2026-05-11",
      "seniority": "Not Applicable",
      "employment_type": "Full-time",
      "job_function": "Product Management and Marketing",
      "company_website": "http://www.teleflex.com",
      "company_linkedin_url": "https://www.linkedin.com/company/teleflex"
    }
  ],
  "credits_used": 0,
  "total": 1,
  "success": true
}
```

{% endtab %}

{% tab title="Error" %}

```json
{
  "status": "error",
  "error": { "code": "not_found", "message": "Not Found" },
  "success": false
}
```

{% endtab %}
{% endtabs %}