Skip to main content
GET
Company Titles Finder
Company Titles Launcher returns results synchronously. If you need the stored result again, pass its input.task.job_id as this endpoint’s job_id query parameter. This retrieves the existing result without running a new search.
This endpoint is in Preview and requires Company Titles access on your API key. API behavior may change, and it is not recommended for critical production workloads.

Read the result

  • output.titles contains the titles for the requested page.
  • output.has_more_pages indicates whether more pages are available.
  • output.usage contains the job’s cost breakdown.
The result uses the raw_titles mode chosen at launch. You cannot change that mode or request another page through the Finder.

Retrieve another page

If output.has_more_pages is true, send a new request to Company Titles Launcher with the same company and title mode, then increment page_number.
Each page returns up to 50,000 titles. Valid page numbers run from 1 to 100.

Authorizations

x-api-key
string
header
required

To access the API, provide your API key in x-api-key.

Query Parameters

job_id
string<uuid>
required

The unique job_id you want to query. This value is returned by the corresponding launcher endpoint.

A UUID.

Example:

"7d44db58-5de3-4e92-a2fb-8325d12c2e8b"

Response

Company Titles job state, input, and any available output.

Company Titles response with job state, input, and optional output.

status
enum<string>
required

The status of the job.

Available options:
RUNNING,
SUCCEEDED,
FAILED,
TIMED_OUT,
ABORTED
Example:

"RUNNING"

start_date
string<date-time>
required

A date time in ISO 8601 format.

Example:

"2025-02-05T15:46:35.771751+00:00"

input
object
required
Example:
stop_date
string<date-time>

A date time in ISO 8601 format.

Example:

"2025-02-05T15:46:35.771751+00:00"

output
object

Paginated Company Titles output for a succeeded job.

Example: