The Company Identity API from WritersLogic Verifiable AI Agent Hub — 1 operation(s) for company identity.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/writerslogic-com:writerslogic-com-company-identity-api"curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: WritersLogic Verifiable AI Agent Hub Company Identity API
version: 2.0.0
description: Pay-per-call agents settled in USDC on Base via x402. Every response carries a signed provenance envelope.
contact:
name: WritersLogic
url: https://writerslogic.com/agents
email: agents@writerslogic.com
servers:
- url: https://agents.writerslogic.com
tags:
- name: Company Identity
paths:
/api/v1/company-identity:
post:
operationId: company_identity
summary: 'Company identity: name, domain, LEI, VAT, CIK or ticker to one verified legal…'
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.
Price: 0.05 USDC on Base (x402).'
x-x402-price-usdc: '0.05'
x-x402-amount: '50000'
x-payment-info:
protocols:
- x402
price:
mode: fixed
currency: USD
amount: '0.05'
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
tags:
- Company Identity
components:
securitySchemes:
x402:
type: apiKey
in: header
name: PAYMENT-SIGNATURE
description: x402 v2 payment payload (base64) sent after a 402 challenge
apiKey:
type: apiKey
in: header
name: X-API-KEY