---
title: "Get export status"
method: GET
path: "/api/intellimatch/status"
tags: ["Intellimatch"]
---

# Get export status

`GET /api/intellimatch/status`

Poll this endpoint to check if a given search is completed.

The response will contain a `status` field with one of the following values:
- `success`: Export is completed and ready to download
- `processing`: Export is currently being processed (includes progress information)
- `pending`: Export is queued but not yet started
- `failed`: Export has failed
- `not_found`: Export hash not found or expired

## Query parameters

- `hash` string, required — The export hash returned by the search endpoint.

## Response `200`

Export processing

- object
  - `status` string — The current status of the export.
  - `progress` integer — The progress percentage (only when status is "processing").
  - `total_jobs` integer — Total number of jobs (only when status is "processing").
  - `processed_jobs` integer — Number of processed jobs (only when status is "processing").
  - `pending_jobs` integer — Number of pending jobs (only when status is "processing").
  - `failed_jobs` integer — Number of failed jobs (only when status is "processing").

## Other responses

- `401` — Unauthenticated
- `422` — Validation failed
- `423` — Subscription issue
- `429` — Too Many Attempts

---

[API](https://skmtc.net/findymail/apis/findymail-api-documentation.md) · [All operations](https://skmtc.net/findymail/apis/findymail-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/findymail/findymail-api-documentation/revisions/ae7fddf16bf9/schema)