Get a company record
Get a company's full current state: facts across all dimensions (pricing, features, security, positioning, stack, hiring, reliability, funding, location, legal), each with provenance, as_of date, and source URL. Identify companies by apex domain, e.g. pinecone.io. Tracked-not-member domains answer with a tier-labeled minimal record (liveness + discovery receipts, zero facts) instead of 404. A company without a record yet answers 404 (or that minimal record when tracked). To get one: POST /v1/companies/{company}/reads for a one-time fresh read, POST /v1/coverage/requests to add it to your coverage, or a watch; the record lands in two to three minutes for a company already in the identity layer and three to six for one Bixel has never seen, and this call then answers it.
Path Parameters
Apex domain (canonical, e.g. pinecone.io). Bare values are resolved as legacy slugs. Unknown names: resolve via /v1/search first.
Query Parameters
concise = coverage, jobs, and per-dimension counts + last-changed dates with facts omitted (roughly 10x fewer tokens; drill in with the facts endpoint). Default detailed.
Value in
- "detailed"
- "concise"
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://example.com/v1/companies/pinecone.io"{ "data": { "identity": { "schema_version": "identity-schema/1.1", "layer": "tracked", "record_kind": "organization", "bixel_id": "string", "kind": "brand", "canonical_name": "string", "legal_name": "string", "legal_name_as_of": "2019-08-24", "primary_domain": "string", "domain_anchoring": "domain_rooted", "registry_status": "active", "merged_into": "string", "registry_ids": [ { "system": "lei", "id": "string" } ], "legal_entity": { "result_type": "resolved", "bixel_id": "string", "registry_ids": [ { "system": "lei", "id": "string" } ] }, "domains": [ { "domain": "string", "status": "primary", "domain_state": "live", "valid_from": "2019-08-24", "valid_to": "2019-08-24" } ], "relationships": [ { "type": "operates", "counterparty": "string", "direction": "from", "domain_scope": "string", "valid_from": "2019-08-24", "valid_to": "2019-08-24", "tier": "attested" } ], "cross_refs": [ { "system": "string", "id": "string", "status": "current", "tier": "attested" } ], "evidence": [ { "type": "capture", "id": "string" } ], "web_presence": null, "lifecycle": null }, "company": { "name": "string", "domain": "string", "slug": "string", "bixel_id": "string", "served_since": "2019-08-24", "categories": [ "string" ] }, "last_captured_at": "2019-08-24", "jobs": { "active_postings": 0, "ats_tracked": true, "note": "string" }, "dimensions": { "property1": { "count": 0, "last_changed_at": "string", "facts": [ { "key": "pricing.model", "value": null, "unit": "usd_per_month", "provenance": "observed", "as_of": "2019-08-24", "source_url": "string", "capture_id": "string", "product": "string" } ] }, "property2": { "count": 0, "last_changed_at": "string", "facts": [ { "key": "pricing.model", "value": null, "unit": "usd_per_month", "provenance": "observed", "as_of": "2019-08-24", "source_url": "string", "capture_id": "string", "product": "string" } ] } }, "coverage": { "dimensions_captured": 0, "dimensions_total": 0, "per_dimension": { "property1": 0, "property2": 0 }, "thin": true } }, "meta": { "generated_at": "2019-08-24T14:15:22Z", "count": 0, "total": 0, "next_cursor": "string", "notice": "string", "window": { "served_from": "string", "earliest_event_at": "string", "events_beyond_window": true }, "data_version": "string", "resolved_at": "2019-08-24T14:15:22Z", "attribution": { "source": "Bixel", "url": "string", "license": "CC-BY-4.0", "notice": "from Bixel", "data_version": "string" } }}{ "type": "http://example.com", "title": "string", "status": 0, "code": "company_not_found", "detail": "string", "hint": "string", "docs_url": "http://example.com"}{ "type": "http://example.com", "title": "string", "status": 0, "code": "company_not_found", "detail": "string", "hint": "string", "docs_url": "http://example.com"}{ "type": "http://example.com", "title": "string", "status": 0, "code": "company_not_found", "detail": "string", "hint": "string", "docs_url": "http://example.com"}