Skip to main content
GET
/
api
/
v1
/
tam
/
build
/
{job_id}
Poll TAM Builder Results
curl --request GET \
  --url https://api.openfunnel.dev/api/v1/tam/build/{job_id} \
  --header 'X-API-Key: <x-api-key>'
{
  "job_id": "8a8e8a97-8192-48ff-849a-d8a96e949732",
  "status": "completed",
  "manifest": {
    "pages": 219,
    "page_size": 100,
    "unique_count": 21815,
    "partial": false,
    "degraded": false,
    "ranked": true,
    "stop_reason": null,
    "credits_consumed": 21815
  },
  "error_message": null,
  "rows": [
    {
      "name": "Acme Observability",
      "domain": "acme-observe.com",
      "linkedin_url": "https://www.linkedin.com/company/acme-observe",
      "headquarters": "San Francisco, California, United States",
      "match_reason": "Provides \"cloud observability\" and \"application performance monitoring\" tooling.",
      "match_score": 92,
      "source_band": "201-1000",
      "source_query": "cloud observability and monitoring tools",
      "employee_count": 420,
      "funding_stage": "Series C",
      "industries": [
        "Software",
        "DevOps"
      ],
      "hq_city": "San Francisco",
      "hq_region": "California",
      "hq_country": "United States"
    }
  ],
  "page": "page_0000",
  "next_cursor": "page_0001",
  "count": 100,
  "processed": 21815,
  "progress_message": "completed",
  "bands_done": 6,
  "bands_total": 6,
  "degraded": false
}

Headers

X-API-Key
string
required

Path Parameters

job_id
string
required

The job_id returned by the TAM build submit endpoint.

Query Parameters

cursor
string | null

Page to read, e.g. page_0003 (use next_cursor from the previous response). Omit for the first page.

Response

Job status, manifest, live progress, and one page of results.

Combined status + live progress + one page of the TAM master set.

job_id
string
required
status
string
required

pending | running | completed | failed | cancelling | cancelled.

manifest
TamBuildManifest · object

Build summary; populated once the job is terminal.

error_message
string | null
rows
TamCompanyResult · object[]

Companies in the requested page.

page
string | null

Name of the page returned (e.g. page_0003).

next_cursor
string | null

Pass as cursor to fetch the next page; null when this is the last page.

count
integer
default:0

Rows in this page.

processed
integer | null

Unique qualified companies so far (advances live as bands complete).

progress_message
string | null

Current stage, e.g. band 201-1000: validating 5000.

bands_done
integer | null
bands_total
integer | null
degraded
boolean | null