Skip to main content

Overview

Use run results to retrieve hydrated people data for a saved audience.
The endpoint returns:
  • 202 while the run is queued or running
  • 200 with paginated results when the run is completed
  • 409 when the run state cannot serve results

Read a run

Use the audience ID and run ID returned by your earlier requests. Follow Build and export an audience for environment setup, run creation, and a polling loop that stops on errors or after a time limit. Keep the same runId throughout pagination. Reading a completed run does not refresh it with new people.

Pending response

Completed response

Pagination

Use limit and offset. Continue increasing offset until offset + results.length >= total.

Person fields

Rows can include identity, contact, role, company, geography, demographics, profile signals, company signals, geo signals, compliance, source metadata, and intent matched topics. Any nullable field can be null when data is unavailable.

Next steps