---
title: "Retrieve the details of a bulk search."
method: GET
path: "/v5.1/bulk/{searchId}"
tags: ["bulk"]
---

# Retrieve the details of a bulk search.

`GET /v5.1/bulk/{searchId}`

## Request

- Base URL: `https://api.anymailfinder.com`
- URL: `https://api.anymailfinder.com/v5.1/bulk/{searchId}`
- Auth: API key in header `Authorization`

## Path parameters

- `searchId` string, required

## Response `200`

Success

- Api5SearchBulkDto
  - `status` 'on_deck' | 'queued' | 'running' | 'paused' | 'completed' | 'deleted' | 'extraction_queued' | 'extraction_running', required: The current status of the bulk operation. Each status represents a specific stage in the bulk operation lifecycle:<br /> - "on_deck": Indicates the bulk file has been uploaded through the UI, but the columns have not been mapped yet. This status is internal and typically not encountered by API users.<br /> - "queued": The bulk operation is queued and will be processed soon. This status implies that the operation is in the waiting list and will be picked up by the processing system.<br /> - "running": The bulk operation is currently in progress. This status indicates that the processing of the bulk file is actively ongoing.<br /> - "paused": The operation has been temporarily paused.<br /> - "completed": The bulk operation has been completed successfully. All records in the bulk file have been processed as intended.<br /> - "failed": The bulk operation has failed. This status indicates that there was an error during the processing which prevented the operation from completing successfully.<br /> Note: The status flow typically progresses from "queued" to "running", and then to either "completed" or "failed", but can also include "paused".
  - `counts` object, required
    - `failed` number, required
    - `found_unknown` number, required
    - `found_valid` number, required
    - `not_found` number, required
    - `total` number, required
  - `created_at` string, date-time, required
  - `credits_needed` number, required
  - `decision_maker_category` string, nullable, required
  - `file_name` string, required
  - `id` string, required
  - `paid` boolean, required
  - `started_running_at` string, date-time, nullable, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not found

---

[API](https://skmtc.dev/anymailfinder/apis/anymail-finder-api.md) · [All operations](https://skmtc.dev/anymailfinder/apis/anymail-finder-api/llms.txt) · [OpenAPI document](https://skmtc.dev/anymailfinder/apis/anymail-finder-api/revisions/cd6d62ec7603?raw)