Skip to main content

Refresh company firmographics

Request a firmographic refresh for one company.

POST/api/companies/{company_id}/firmographics/refresh
HTTP referenceScope authenticated user session (developer API keys blocked)Updated September 27, 2026

This page documents the canonical HTTP contract for this endpoint.

This session-only route requires a signed-in user JWT; developer API keys are blocked. providers is an optional list passed to the refresh job; the HTTP route does not define an enum, so omit it unless you have a provider value from the applicable product contract. use_geocoder and classify_public_docs both default to true. An optional Idempotency-Key (maximum 240 characters) identifies the request occurrence: replaying it with the same request returns the existing admission receipt; reuse with a different request can return 409. A queued receipt is not completed enrichment. The result URL in source.result_endpoint can be polled for terminal status.

Path parameters

  • company_idrequired

    string

    Company ID.

Body parameters

  • providers · optional

    array<string>

    Optional provider selection.

  • use_geocoder · optional

    boolean

    Use geocoding; default true.

  • classify_public_docs · optional

    boolean

    Classify public documents; default true.

Errors

StatusMeaning
400Invalid Company ID or Idempotency-Key longer than 240 characters.
401Signed-in user JWT and organization/user context required.
403Developer API keys are blocked for this session-only route.
404Company not found.
409Company has no domain, or the idempotency key conflicts with a different refresh request.

Docs