Skip to main content

Get list build results

Read paginated company or lead rows from a durable list-build job.

GET/api/list-builds/{job_id}/results
HTTP referenceScope search:runUpdated September 27, 2026

This page documents the canonical HTTP contract for this endpoint.

Company results include id, name, url, location, industry, and related metadata. Use company id values as current_company_ids when building a lead list.

Path parameters

  • job_idrequired

    string

    List-build job ID.

Query parameters

  • type · optional

    string

    items, companies, leads, jobs, or all. Default: items. The route does not currently accept businesses as a result type.

  • page · optional

    integer

    Page number. Default: 1.

  • page_size · optional

    integer

    Results per page. Default: 50. Max: 500.

Errors

StatusMeaning
401Invalid API key or missing auth.
403Missing search:run scope.
404List build job not found.

Docs