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

# List jobs

`GET /v1/jobs`

## Request

- Base URL: `https://dataapi.reachthepeople.ai/api`
- URL: `https://dataapi.reachthepeople.ai/api/v1/jobs`
- Auth: HTTP bearer

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Paginated job list

- JobListResponse
  - `records` Job[]
    - `jobId` string
    - `type` 'email_append'
    - `name` string
    - `status` string
    - `progress` integer
    - `total` integer
    - `pricedResults` PricedResult[]
      - `category` string
      - `matched` integer
      - `unitPrice` number, float
      - `estimatedAmount` number, float
    - `billing` BillingLine[]
      - `category` string
      - `matched` integer
      - `unitPrice` number, float
      - `amount` number, float
    - `totalAmount` number, float
    - `invoiceNumber` string
    - `paid` boolean
    - `createdAt` string, date-time
    - `purchasedAt` string, date-time
  - `total` integer
  - `limit` integer
  - `offset` integer

## Other responses

- `401`: Missing or invalid API key

---

[API](https://skmtc.dev/salesstream/apis/data-api.md) - [All operations](https://skmtc.dev/salesstream/apis/data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/salesstream/apis/data-api/revisions/71ddbbca233d?raw)
