---
title: "Bulk job results"
method: GET
path: "/bulk/jobs/{id}/results"
tags: ["Bulk"]
---

# Bulk job results

`GET /bulk/jobs/{id}/results`

## Request

- Base URL: `https://app.1lookup.io/api/v1`
- URL: `https://app.1lookup.io/api/v1/bulk/jobs/{id}/results`
- Auth: HTTP bearer

Row-by-row results of a bulk job, oldest first, one page at a time. The CSV links carry every row, including skipped and duplicate ones. Free.

## Path parameters

- `id` string, required

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

A page of results.

- object
  - `success` true, required
  - `data` BulkJobResults, required
    - `job_id` string, required
    - `status` string, required: pending, processing, completed, failed or paused_insufficient_credits.
    - `results_url` string, nullable: Signed CSV download URL, valid for 1 hour.
    - `full_results_url` string, nullable: Signed CSV with every field, valid for 1 hour.
    - `csv_note` string
    - `lookups` object[], required
      - `id` string, required
      - `input` string, required
      - `status` string, required: completed or failed.
      - `tokens_consumed` integer, required: Credits this row cost.
      - `response_data` object: The lookup result, in the same shape as the single-lookup endpoint's `data`.
      - `error_message` string, nullable
      - `created_at` string, date-time, required
      - `completed_at` string, nullable
    - `pagination` object, required
      - `limit` integer, required
      - `next_cursor` string, nullable, required: Pass as `cursor` to read the next page. null on the last page.
      - `has_more` boolean, required

## Other responses

- `401`: `UNAUTHORIZED`: Invalid or missing API key
- `403`: `UPGRADE_REQUIRED`: The account has no paid plan, and API access needs one. Upgrade at https://app.1lookup.io/billing?tab=plan; `INSUFFICIENT_SCOPE`: The call was signed with an AI connector (MCP) sign-in, which can only reach /phone, /email, /ip and /account. Use an API key; `UNSUPPORTED_AUTH_CONTEXT`: Bulk jobs need a direct API key
- `404`: `NOT_FOUND`: Resource not found
- `429`: `RATE_LIMIT_EXCEEDED`: Too many requests
- `500`: `INTERNAL_ERROR`: Internal server error
- `503`: `SERVICE_UNAVAILABLE`: The lookup service, or the API key check, is temporarily unavailable. Nothing was charged; retry after `Retry-After` seconds

---

[API](https://skmtc.dev/1lookup/apis/1lookup-api.md) · [All operations](https://skmtc.dev/1lookup/apis/1lookup-api/llms.txt) · [OpenAPI document](https://skmtc.dev/1lookup/apis/1lookup-api/revisions/57b6d8ba04ac?raw)