Get company headquarters and reported office-opening stories

View all Crunchbase Company & Investment Data endpoints →

Retrieve a company's reported headquarters and office-opening records using a required Crunchbase permalink, UUID or organization URL in company. No page parameter is documented for this endpoint. The results support footprint and expansion research, not a complete directory of currently operating office addresses. No endpoint-specific live probe is available. The unverified documented response example has three top-level fields: company, headquarters and offices. The company object contains id, uuid, name, type, link and image. The headquarters object contains city, region, country, continent, groups and ids; groups is empty in the example, so no populated group-item structure is established. The offices array contains id, opened_on, opening_description, opening_press, city, region, country, street, postal_code, location and is_headquarters. The opening_press object provides the associated press-story fields id, title, publisher, author, posted_on and link. Keep the reported opening date opened_on separate from the press publication date posted_on. In all supplied office examples, city, region, country, street, postal_code, location and is_headquarters are null; opening_press.author is also null. Do not infer office addresses or headquarters status from an opening story when those structured fields are missing. A separate headquarters summary does not establish that an office-opening record is the headquarters or that a location remains open today. Coverage and present-day operating status are not independently verified.

API Features

Separate headquarters geography Review the documented headquarters city, region, country and continent independently from individual office-opening records.
Reported office-opening context Use opened_on and opening_description for the reported opening event rather than interpreting a record as proof of a currently active office.
Press stories behind expansion Retain the opening_press title, publisher, posted_on and link with an office-opening record for source-aware expansion research.
Address and office-status gaps Handle null street, postal_code, location, city, region, country and is_headquarters values explicitly; the supplied office examples do not establish a usable address directory.
Opening-date and story-date distinction Preserve opened_on separately from opening_press.posted_on so expansion timelines do not confuse an office-opening date with a press publication date.

Live API Demo

GET /api/project/crunchbase/company-offices

Request cost is temporarily unavailable. No price is assumed.

View pricing

API Response (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/crunchbase/company-offices?key=<API_KEY>&company=openai'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

Frequently asked questions

What input is required to look up company offices?

Provide company as a Crunchbase permalink such as openai, a company UUID or a full Crunchbase organization URL. It is the only documented parameter for this endpoint; no page parameter is specified.

How are headquarters and office openings represented?

The unverified documented example separates headquarters, which has geography fields, from offices, which holds opening records. Each opening can include opened_on, opening_description and an opening_press story. Do not assume an opening record is the headquarters.

Does this endpoint provide complete street addresses?

Not on the supplied evidence. The office examples have null street, postal_code, city, region, country and location fields. Headquarters has a separate geographic summary, but that does not fill in missing office addresses.

What is the difference between opened_on and posted_on?

opened_on belongs to the reported office-opening record. opening_press.posted_on is the associated press story's publication date. Keep the two fields separate when creating an expansion timeline.

Can I see the press story behind an office opening?

The documented example includes opening_press with id, title, publisher, posted_on, link and author. Author is null in the supplied records. These are unverified example fields, not a guarantee that every opening has complete story metadata.

Does an office record prove that the location is still operating?

No. An opening event and its press story do not establish present-day operating status. The supplied is_headquarters values are also null. Verify current locations and headquarters designations independently before operational use.

Related operations

Guides

View Subscription Plans →