---
title: "List all jobs"
method: GET
path: "/jobs"
tags: ["Jobs"]
---

# List all jobs

`GET /jobs`

## Request

- Base URL: `https://api.companyenrich.com`
- URL: `https://api.companyenrich.com/jobs`
- Auth: API key in header `Authorization`

**Cost:** FREE - No credits deducted

Returns a paginated list of all jobs (bulk enrichment, etc.) for the authenticated user.
Supports optional filtering by job status and type.

## Query parameters

- `page` integer
- `pageSize` integer
- `status` unknown
- `type` string

## Response `200`

OK

- PaginatedListOfJobSummaryDto
  - `items` JobSummaryDto[], required: The items in the list
    - `id` string, uuid, required: Unique identifier for the job.
    - `type` string, required: The type of job (bulk_enrichment, bulk_person_email_enrichment, etc.).
    - `status` 'pending' | 'processing' | 'completing' | 'completed' | 'failed', required: Current status of the job (pending, processing, completing, completed, failed).
    - `title` string, required: Human-readable title of the job.
    - `created_at` string, date-time, required: Timestamp when the job was created.
    - `started_at` string, date-time, nullable: Timestamp when the job started processing.
    - `completed_at` string, date-time, nullable: Timestamp when the job completed.
    - `credits_charged` integer, required: Total credits charged for this job.
    - `error_message` string, nullable: Error message if the job failed.
  - `page` integer: The current page number. 1-indexed
  - `totalPages` integer: The total number of pages
  - `totalItems` integer: The total number of items in the list

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `422`: Unprocessable Entity
- `429`: Too Many Requests

---

[API](https://skmtc.dev/companyenrich/apis/company-enrich-api.md) - [All operations](https://skmtc.dev/companyenrich/apis/company-enrich-api/llms.txt) - [OpenAPI document](https://skmtc.dev/companyenrich/apis/company-enrich-api/revisions/07f84debab87?raw)