Resolve an identifier to its Bixel ID
Deterministic resolution of a bxc_ Bixel ID, apex domain, or URL to exactly one company with its stable bixel_id — the exact sibling of /v1/search. First-hit-wins ladder: bixel_id, exact domain, domain alias, URL folded to its registrable apex. Merged IDs answer 200 with the survivor plus the superseded chain (an issued ID never 404s); tracked-but-shallow domains answer a tracked envelope and register demand; unknown identifiers answer 404 company_not_found. Responses carry meta.data_version (the registry mint version).
Query Parameters
A bxc_ Bixel ID, apex domain, or any URL (folds to its registrable apex). Bare names are not accepted yet — use /v1/search for fuzzy name lookup.
length <= 2048Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://example.com/v1/resolve?identifier=vercel.com"{ "data": { "identifier": "string", "match": { "bixel_id": "string", "name": "string", "domain": "string", "slug": "string", "status": "active", "matched_via": "bixel_id", "confidence": 0, "web_presence": "domain_rooted", "record_available": true, "why": [ "string" ], "superseded": { "bixel_id": "string" } }, "tracked": {}, "miss": { "logged": 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 } }}{ "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"}