---
title: "Get LinkedIn extraction job results"
method: GET
path: "/v1/extractions/{extraction_id}/"
tags: ["LinkedIn Extraction"]
---

# Get LinkedIn extraction job results

`GET /v1/extractions/{extraction_id}/`

## Request

- Base URL: `https://api.evaboot.com`
- URL: `https://api.evaboot.com/v1/extractions/{extraction_id}/`
- Auth: HTTP bearer

Fetch an extraction's status and, once it has finished, its extracted records. This is the endpoint you poll after creating an extraction, and it returns the same data a `webhook_url` would have delivered.

The status code tells you which of two payloads you get:

- **202**: still running. You get the status and a `progress` percentage, and should poll again shortly.
- **200**: finished. You get the full payload including `prospects`.

Each record maps human-readable column names to values: identity, role and tenure, company details, and the email address plus its verification status when the extraction was created with `enrich_email`. Which columns appear depends on whether leads or accounts were extracted.

For large extractions, page the records with the optional `start` and `limit` query parameters; `total_count` and `has_more` then describe the whole result set. Omit `limit` and every record is returned in one response. `limit=0` returns the status, progress and counts with an empty `prospects` list.

Synchronous and free: reading results costs no credits.

## Path parameters

- `extraction_id` string, required

## Query parameters

- `start` integer
- `limit` integer, nullable

## Response `200`

OK

- ExtractionDetailOut
  - `search_id` string, required: Identifier of the extraction you requested.
  - `search_name` string: The name you gave the extraction when you created it.
  - `status` string: Where the extraction stands. On this response it is `EXECUTED` when the results are complete, or `FAILED` / `PAUSED` when they are not.
  - `extraction_type` string: How the extraction was created: `SEARCH`, `LIST`, `UPLOAD` or `SINGLE`.
  - `total_prospects` integer: Number of leads or accounts Sales Navigator reported before scraping. An estimate; use `total_count` for the number of records actually extracted.
  - `progress` integer: Completion percentage, 0 to 100. `100` once the extraction has finished successfully.
  - `created_at` string, nullable: When the extraction was created (UTC).
  - `completed_at` string, nullable: When the extraction finished (UTC). `null` if it never finished.
  - `failure_reason` string: Short machine-readable reason the extraction did not complete, for example `insufficient_credits`, `auth_error`, `quota_exceeded` or `invalid_urls`. Empty string when the extraction succeeded.
  - `prospects` object[]: The extracted records, each a mapping of human-readable column names to values: identity, role and tenure, company details, and the email address plus its verification status when enrichment was requested. Which columns are present depends on whether leads or accounts were extracted.
  - `start` integer: Zero-based index of the first record returned.
  - `limit` integer, nullable: Page size that was applied, echoing the `limit` you sent. `null` when you did not page and every record was returned.
  - `returned_count` integer: Number of records in `prospects` on this response.
  - `total_count` integer: Number of records this extraction produced in total, across all pages.
  - `has_more` boolean: Whether records remain after this page. Request the next page with `start` = `start` + `returned_count`.

## Other responses

- `202`: Accepted
- `401`: The API key is missing, malformed or unknown.
- `404`: No such resource, or it belongs to another account.
- `422`: The request body or a supplied URL failed validation.

---

[API](https://skmtc.dev/evaboot/apis/evaboot-public-api.md) · [All operations](https://skmtc.dev/evaboot/apis/evaboot-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/evaboot/apis/evaboot-public-api/revisions/d770494f2718?raw)
