{"id":"company-identity","title":"Company identity: name, domain, LEI, VAT, CIK or ticker to one verified legal entity","description":"Resolves a company name, web domain, LEI, EU VAT number, SEC CIK or stock ticker to one legal entity using official free registries in a single call: GLEIF (legal name, other names, addresses, jurisdiction, registry id, direct and ultimate parent), the SEC ticker table (CIK, ticker), the EU VIES VAT service, and Companies House officers when the operator has configured a key. Deterministic matching with explicit ambiguity: when no single candidate clearly leads, it returns status \"ambiguous\" with ranked candidates instead of guessing. For KYC, vendor onboarding and CRM de-duplication by agents. It does NOT fetch or scrape the domain, does not cover companies without an LEI, does not return beneficial owners or financials, and uses no model.","roi":"Replaces four registry lookups and the name-matching judgment with one deterministic, sourced answer for $0.05.","audience":"business","channels":["x402","mcp","rapidapi","apify"],"endpoint":{"method":"POST","url":"https://agents.writerslogic.com/api/v1/company-identity","path":"/api/v1/company-identity","contentType":"application/json"},"price":{"amount":"0.05","currency":"USDC","network":"base","perCall":true,"failedCallsCharged":false},"inputSchema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":2,"maxLength":200,"description":"Company name, with or without legal form."},"domain":{"type":"string","maxLength":253,"description":"Company web domain; only used to guess a name and to prefer matching candidates. It is never fetched."},"lei":{"type":"string","minLength":20,"maxLength":20,"description":"20-character LEI; check digits are validated (ISO 17442)."},"vat":{"type":"object","additionalProperties":false,"required":["country","number"],"properties":{"country":{"type":"string","enum":["AT","BE","BG","CY","CZ","DE","DK","EE","EL","ES","FI","FR","HR","HU","IE","IT","LT","LU","LV","MT","NL","PL","PT","RO","SE","SI","SK","XI"],"description":"VIES country code (Greece is EL, Northern Ireland XI)."},"number":{"type":"string","minLength":2,"maxLength":24,"description":"VAT number without the country prefix."}}},"cik":{"type":"integer","minimum":1,"maximum":9999999999,"description":"SEC Central Index Key."},"ticker":{"type":"string","minLength":1,"maxLength":10,"description":"Stock ticker, matched case-insensitively against the SEC table."},"country":{"type":"string","minLength":2,"maxLength":2,"description":"ISO 3166-1 alpha-2 hint; raises the score of candidates registered in that country."},"include_parents":{"type":"boolean","default":true,"description":"Look up GLEIF direct and ultimate parents."},"max_candidates":{"type":"integer","minimum":1,"maximum":10,"default":5,"description":"How many ranked candidates to return."}}},"resultSchema":{"type":"object","properties":{"query":{"type":"object","description":"The input as interpreted, with defaults applied."},"status":{"type":"string","enum":["resolved","ambiguous","not_found"],"description":"resolved: one candidate scored >= 0.85 and leads the runner-up by >= 0.15 (or an LEI was given). ambiguous: ranked candidates, no best."},"best":{"anyOf":[{"type":"object","properties":{"lei":{"type":"string"},"legal_name":{"type":"string"},"other_names":{"type":"array","items":{"type":"string"}},"entity_status":{"type":"string"},"registration_status":{"type":"string"},"jurisdiction":{"type":"string"},"legal_form_elf":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO 20275 entity legal form code."},"registry":{"type":"object","properties":{"authority_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"registered_as":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"legal_address":{"anyOf":[{"type":"object","properties":{"lines":{"type":"array","items":{"type":"string"}},"city":{"type":"string"},"region":{"type":"string"},"country":{"type":"string"},"postal_code":{"type":"string"}}},{"type":"null"}]},"headquarters_address":{"anyOf":[{"type":"object","properties":{"lines":{"type":"array","items":{"type":"string"}},"city":{"type":"string"},"region":{"type":"string"},"country":{"type":"string"},"postal_code":{"type":"string"}}},{"type":"null"}]},"sec":{"anyOf":[{"type":"object","properties":{"cik":{"type":"string"},"ticker":{"type":"string"},"title":{"type":"string"}}},{"type":"null"}]},"vat":{"anyOf":[{"type":"object","properties":{"country":{"type":"string"},"number":{"type":"string"},"valid":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"null when VIES could not answer; see reason."},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"checked_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]}}},{"type":"null"}]},"uk":{"anyOf":[{"type":"object","properties":{"company_number":{"type":"string"},"company_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"officers":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"role":{"anyOf":[{"type":"string"},{"type":"null"}]},"appointed_on":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},{"type":"string","enum":["not_configured"]},{"type":"null"}],"description":"Companies House profile and active officers for UK-registered entities; \"not_configured\" when the operator set no key."},"parents":{"anyOf":[{"type":"object","properties":{"direct":{"anyOf":[{"type":"object","properties":{"lei":{"type":"string"},"legal_name":{"type":"string"},"jurisdiction":{"type":"string"},"entity_status":{"type":"string"}}},{"type":"null"}]},"ultimate":{"anyOf":[{"type":"object","properties":{"lei":{"type":"string"},"legal_name":{"type":"string"},"jurisdiction":{"type":"string"},"entity_status":{"type":"string"}}},{"type":"null"}]},"exception":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"GLEIF reporting-exception reason when a parent is not reported, for example NATURAL_PERSONS."}}},{"type":"null"}]}}},{"type":"null"}]},"candidates":{"type":"array","items":{"type":"object","properties":{"lei":{"type":"string"},"legal_name":{"type":"string"},"jurisdiction":{"anyOf":[{"type":"string"},{"type":"null"}]},"entity_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"score":{"type":"number"}}}},"sources":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"sha256":{"type":"string"}}}},"notes":{"type":"array","items":{"type":"string"},"description":"Degraded or missing sources."},"limits":{"type":"object","properties":{"note":{"type":"string"}}}}},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"query":{"type":"object","description":"The input as interpreted, with defaults applied."},"status":{"type":"string","enum":["resolved","ambiguous","not_found"],"description":"resolved: one candidate scored >= 0.85 and leads the runner-up by >= 0.15 (or an LEI was given). ambiguous: ranked candidates, no best."},"best":{"anyOf":[{"type":"object","properties":{"lei":{"type":"string"},"legal_name":{"type":"string"},"other_names":{"type":"array","items":{"type":"string"}},"entity_status":{"type":"string"},"registration_status":{"type":"string"},"jurisdiction":{"type":"string"},"legal_form_elf":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO 20275 entity legal form code."},"registry":{"type":"object","properties":{"authority_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"registered_as":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"legal_address":{"anyOf":[{"type":"object","properties":{"lines":{"type":"array","items":{"type":"string"}},"city":{"type":"string"},"region":{"type":"string"},"country":{"type":"string"},"postal_code":{"type":"string"}}},{"type":"null"}]},"headquarters_address":{"anyOf":[{"type":"object","properties":{"lines":{"type":"array","items":{"type":"string"}},"city":{"type":"string"},"region":{"type":"string"},"country":{"type":"string"},"postal_code":{"type":"string"}}},{"type":"null"}]},"sec":{"anyOf":[{"type":"object","properties":{"cik":{"type":"string"},"ticker":{"type":"string"},"title":{"type":"string"}}},{"type":"null"}]},"vat":{"anyOf":[{"type":"object","properties":{"country":{"type":"string"},"number":{"type":"string"},"valid":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"null when VIES could not answer; see reason."},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"checked_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]}}},{"type":"null"}]},"uk":{"anyOf":[{"type":"object","properties":{"company_number":{"type":"string"},"company_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"officers":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"role":{"anyOf":[{"type":"string"},{"type":"null"}]},"appointed_on":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},{"type":"string","enum":["not_configured"]},{"type":"null"}],"description":"Companies House profile and active officers for UK-registered entities; \"not_configured\" when the operator set no key."},"parents":{"anyOf":[{"type":"object","properties":{"direct":{"anyOf":[{"type":"object","properties":{"lei":{"type":"string"},"legal_name":{"type":"string"},"jurisdiction":{"type":"string"},"entity_status":{"type":"string"}}},{"type":"null"}]},"ultimate":{"anyOf":[{"type":"object","properties":{"lei":{"type":"string"},"legal_name":{"type":"string"},"jurisdiction":{"type":"string"},"entity_status":{"type":"string"}}},{"type":"null"}]},"exception":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"GLEIF reporting-exception reason when a parent is not reported, for example NATURAL_PERSONS."}}},{"type":"null"}]}}},{"type":"null"}]},"candidates":{"type":"array","items":{"type":"object","properties":{"lei":{"type":"string"},"legal_name":{"type":"string"},"jurisdiction":{"anyOf":[{"type":"string"},{"type":"null"}]},"entity_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"score":{"type":"number"}}}},"sources":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"sha256":{"type":"string"}}}},"notes":{"type":"array","items":{"type":"string"},"description":"Degraded or missing sources."},"limits":{"type":"object","properties":{"note":{"type":"string"}}}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]},"example":{"name":"Apple Inc","country":"US"},"openapiOperation":{"operationId":"company_identity","summary":"Company identity: name, domain, LEI, VAT, CIK or ticker to one verified legal entity","description":"Resolves a company name, web domain, LEI, EU VAT number, SEC CIK or stock ticker to one legal entity using official free registries in a single call: GLEIF (legal name, other names, addresses, jurisdiction, registry id, direct and ultimate parent), the SEC ticker table (CIK, ticker), the EU VIES VAT service, and Companies House officers when the operator has configured a key. Deterministic matching with explicit ambiguity: when no single candidate clearly leads, it returns status \"ambiguous\" with ranked candidates instead of guessing. For KYC, vendor onboarding and CRM de-duplication by agents. It does NOT fetch or scrape the domain, does not cover companies without an LEI, does not return beneficial owners or financials, and uses no model.\n\nPrice: 0.05 USDC on Base (x402).","x-x402-price-usdc":"0.05","x-x402-amount":"50000","x-audience":"business","x-sample-url":"https://agents.writerslogic.com/api/v1/samples/company-identity","security":[{"x402":[]},{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":2,"maxLength":200,"description":"Company name, with or without legal form."},"domain":{"type":"string","maxLength":253,"description":"Company web domain; only used to guess a name and to prefer matching candidates. It is never fetched."},"lei":{"type":"string","minLength":20,"maxLength":20,"description":"20-character LEI; check digits are validated (ISO 17442)."},"vat":{"type":"object","additionalProperties":false,"required":["country","number"],"properties":{"country":{"type":"string","enum":["AT","BE","BG","CY","CZ","DE","DK","EE","EL","ES","FI","FR","HR","HU","IE","IT","LT","LU","LV","MT","NL","PL","PT","RO","SE","SI","SK","XI"],"description":"VIES country code (Greece is EL, Northern Ireland XI)."},"number":{"type":"string","minLength":2,"maxLength":24,"description":"VAT number without the country prefix."}}},"cik":{"type":"integer","minimum":1,"maximum":9999999999,"description":"SEC Central Index Key."},"ticker":{"type":"string","minLength":1,"maxLength":10,"description":"Stock ticker, matched case-insensitively against the SEC table."},"country":{"type":"string","minLength":2,"maxLength":2,"description":"ISO 3166-1 alpha-2 hint; raises the score of candidates registered in that country."},"include_parents":{"type":"boolean","default":true,"description":"Look up GLEIF direct and ultimate parents."},"max_candidates":{"type":"integer","minimum":1,"maximum":10,"default":5,"description":"How many ranked candidates to return."}}},"example":{"name":"Apple Inc","country":"US"}}}},"responses":{"200":{"description":"Paid result with provenance","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"query":{"type":"object","description":"The input as interpreted, with defaults applied."},"status":{"type":"string","enum":["resolved","ambiguous","not_found"],"description":"resolved: one candidate scored >= 0.85 and leads the runner-up by >= 0.15 (or an LEI was given). ambiguous: ranked candidates, no best."},"best":{"anyOf":[{"type":"object","properties":{"lei":{"type":"string"},"legal_name":{"type":"string"},"other_names":{"type":"array","items":{"type":"string"}},"entity_status":{"type":"string"},"registration_status":{"type":"string"},"jurisdiction":{"type":"string"},"legal_form_elf":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO 20275 entity legal form code."},"registry":{"type":"object","properties":{"authority_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"registered_as":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"legal_address":{"anyOf":[{"type":"object","properties":{"lines":{"type":"array","items":{"type":"string"}},"city":{"type":"string"},"region":{"type":"string"},"country":{"type":"string"},"postal_code":{"type":"string"}}},{"type":"null"}]},"headquarters_address":{"anyOf":[{"type":"object","properties":{"lines":{"type":"array","items":{"type":"string"}},"city":{"type":"string"},"region":{"type":"string"},"country":{"type":"string"},"postal_code":{"type":"string"}}},{"type":"null"}]},"sec":{"anyOf":[{"type":"object","properties":{"cik":{"type":"string"},"ticker":{"type":"string"},"title":{"type":"string"}}},{"type":"null"}]},"vat":{"anyOf":[{"type":"object","properties":{"country":{"type":"string"},"number":{"type":"string"},"valid":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"null when VIES could not answer; see reason."},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"checked_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]}}},{"type":"null"}]},"uk":{"anyOf":[{"type":"object","properties":{"company_number":{"type":"string"},"company_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"officers":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"role":{"anyOf":[{"type":"string"},{"type":"null"}]},"appointed_on":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},{"type":"string","enum":["not_configured"]},{"type":"null"}],"description":"Companies House profile and active officers for UK-registered entities; \"not_configured\" when the operator set no key."},"parents":{"anyOf":[{"type":"object","properties":{"direct":{"anyOf":[{"type":"object","properties":{"lei":{"type":"string"},"legal_name":{"type":"string"},"jurisdiction":{"type":"string"},"entity_status":{"type":"string"}}},{"type":"null"}]},"ultimate":{"anyOf":[{"type":"object","properties":{"lei":{"type":"string"},"legal_name":{"type":"string"},"jurisdiction":{"type":"string"},"entity_status":{"type":"string"}}},{"type":"null"}]},"exception":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"GLEIF reporting-exception reason when a parent is not reported, for example NATURAL_PERSONS."}}},{"type":"null"}]}}},{"type":"null"}]},"candidates":{"type":"array","items":{"type":"object","properties":{"lei":{"type":"string"},"legal_name":{"type":"string"},"jurisdiction":{"anyOf":[{"type":"string"},{"type":"null"}]},"entity_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"score":{"type":"number"}}}},"sources":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"sha256":{"type":"string"}}}},"notes":{"type":"array","items":{"type":"string"},"description":"Degraded or missing sources."},"limits":{"type":"object","properties":{"note":{"type":"string"}}}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]}}}},"400":{"description":"Invalid request (no payment consumed)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid X-API-KEY","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment required or invalid","content":{"application/json":{"schema":{"type":"object","description":"x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header)","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"code":{"type":"string"},"resource":{"type":"object"},"accepts":{"type":"array","items":{"type":"object"}},"extensions":{"type":"object"}}}}}},"502":{"description":"Upstream failure; the payment is released or not settled","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}},"links":{"docs":"https://writerslogic.com/agents/company-identity/","docsJson":"https://writerslogic.com/agents/company-identity.json","sample":"https://agents.writerslogic.com/api/v1/samples/company-identity","openapi":"https://agents.writerslogic.com/openapi.json","catalog":"https://agents.writerslogic.com/api/v1/catalog","verifyProvenance":"https://agents.writerslogic.com/api/v1/verify-provenance","index":"https://writerslogic.com/agents/index.json"}}