Get company firmographic refresh status

This page documents the canonical HTTP contract for this endpoint.

This route requires a signed-in user session and blocks developer API keys. Use the source.result_endpoint returned by Refresh company firmographics. The backend verifies runtime, organization, user, job kind, and exact company identity before returning the native status and result.

Follow canonical operation-run progress with operation_run_id; this companion endpoint exposes the native refresh result. A successful HTTP read with status=queued is not finished enrichment. Inspect the returned status and result/error for completion.

Path parameters

company_idrequired
string
Exact company ID from the refresh admission receipt.
job_idrequired
string
Exact native job_id returned by refresh admission. This is separate from operation_run_id.

Name	Type	Description
company_idrequired	string	Exact company ID from the refresh admission receipt.
job_idrequired	string	Exact native job_id returned by refresh admission. This is separate from operation_run_id.

Errors

Status	Meaning
400	Invalid company ID format or missing job ID.
401	A signed-in user and organization context are required.
403	Developer API keys are blocked for this route.
404	No exact user-scoped firmographic refresh matches this company and job.
409	The native job is missing its canonical operation receipt.

Example

bash

curl -X GET "https://app.autotouch.ai/api/companies/67c4b113b4dd8f2d4999f0f1/firmographics/refresh/0123456789abcdef0123456789abcdef" \
  -H "Authorization: Bearer $USER_SESSION_TOKEN"

Response example

json

{
  "success": true,
  "company_id": "67c4b113b4dd8f2d4999f0f1",
  "job_id": "0123456789abcdef0123456789abcdef",
  "operation_run_id": "run_0123456789abcdef0123456789abcdef",
  "status": "queued",
  "result": {}
}