Skip to main content
GET
Get enrichment results
Returns the current state of an enrichment run. While the run is in progress the response is 202 Accepted with status: "processing". Once finished it becomes 200 OK with per-profile results.

Overview

Use this endpoint to poll for enrichment results when you do not have a webhook configured. The id path parameter is the requestId returned by POST /sourcing/enrich.

Response Examples

Still Processing (202 Accepted)

Completed (200 OK)

Completed with Partial Failure (200 OK)

Failed (200 OK with status: "failed")

Partial Success vs. Run Failure

A status: "completed" response can include individual per-profile failures — those profiles have success: false in the data array and are not billed. A status: "failed" response indicates the entire run encountered an unrecoverable error before any profile could be processed.

Authorizations

Authorization
string
header
required

API key for authentication using Bearer scheme

Path Parameters

id
string
required

The requestId returned by POST /sourcing/enrich (e.g. enr_550e8400-…).

Response

Enrichment results (completed or failed)

success
boolean
required

Whether the request succeeded.

Example:

true

requestId
string
required

The enrichment run request ID.

Example:

"enr_550e8400-e29b-41d4-a716-446655440000"

status
enum<string>
required

Current status of the enrichment run.

Available options:
processing,
completed,
failed
Example:

"processing"

message
string

Human-readable message. Present while the run is still processing.

Example:

"Enrichment is in progress. Please poll again in a few seconds."

createdAt
string

ISO 8601 timestamp when the run was created.

Example:

"2025-01-01T00:00:00.000Z"

completedAt
string

ISO 8601 timestamp when the run completed or failed.

Example:

"2025-01-01T00:00:05.000Z"

enrichedCount
integer

Number of profiles successfully enriched.

Example:

3

failureCount
integer

Number of profiles that failed enrichment.

Example:

1

creditsConsumed
integer

Credits consumed by this enrichment run.

Example:

3

data
object[]

Per-profile enrichment results. Present when status = 'completed'.

errorCode
string

Machine-readable error code when status = 'failed'.

Example:

"INTERNAL_ERROR"

errorMessage
string

Human-readable error message when status = 'failed'.

Example:

"An unexpected error occurred during enrichment."