Home
Providers
OpenMercantil
OpenMercantil
OpenMercantil is an independent public-data API for Spanish company intelligence. It indexes the Boletin Oficial del Registro Mercantil (BORME) and cross-references it with 80+ official public sources (BOE, CNMV, CNMC, AEAT, AEPD, PLACSP, TED EU, BDNS, OEPM, EPO, WIPO, CENDOJ, GLEIF, OpenSanctions, ICIJ and more) to expose company and person search, structured company reports, BORME registry event timelines, documentary officer mentions, CNAE sector navigation and ratios, daily BORME summaries, public-procurement notices and rankings, documentary risk signals, a corporate relationship graph, a Spanish mercantile-law corpus that bridges registry acts to the governing BOE norm, account-plane datasets and HMAC-signed outbound webhooks, and CSV/JSON bulk exports. The live OpenAPI 3.1 contract (v1.9.3) declares 118 paths and 139 operations. The public read plane is free and anonymous with no API key, rate-limited at 60 req/min and 200 req/day per IP, with paid Profesional, MAX and Enterprise tiers raising the quota. Derived data is CC BY 4.0 and every response carries its own source and attribution metadata. The project is informational and does not replace official Registro Mercantil certificates.
OpenMercantil publishes 18 APIs on the APIs.io network, including API Credentials API, Billing API, BORME API, and 15 more. Tagged areas include BDNS, BORME, Business Registry, CIF, and CNAE.
The OpenMercantil catalog on APIs.io includes 1 event-driven AsyncAPI specification, 1 JSON-LD context, and 2 Spectral governance rulesets.
OpenMercantil’s developer surface includes authentication, documentation, pricing, support, code examples, changelog, API reference, and 43 more developer resources.
18 APIs
BDNS BORME Business Registry CIF CNAE CNMV CSV Company Data Company Search Corporate Registry DCAT-AP Daily Summary Geocoding JSON Legal Data Mercantile Law OEPM Open Data Open Government Data OpenAPI OpenSanctions PLACSP Public Procurement Public Records Public-Interest Data REST API Registry Timeline Risk Signals Sanctions Spain Spanish Companies Spanish Open Data Tenders Trust Score Webhook
On this page
Kin Score
APIs 18
Open Collections 16
Pricing Plans 1
Rate Limits 1
FinOps 1
Event Specs 1
Vocabularies 1
Spectral Rules 2
JSON Schema 2
JSON Structure 1
Examples 4
Security Posture 4
Scopes 1
Agentic Access 1
Resources 50
apis.yml
95 Operational Transparency
Composite quality — 87.3/100 · exemplar
Contract Quality
16.4 / 21
Developer Ergonomics
9.6 / 17
Operational Transparency
10.5 / 11
Contract Governance
5.6 / 10
Regulatory Posture
12.8 / 15
Agent readiness — 56/100 · agent native
Machine-Readable Contract
18 / 18
Agentic Access Contract
10 / 10
Documented Reversibility
0 / 6
MCP Server
0 / 12
Machine-Readable Auth
10 / 10
Idempotency
9 / 9
Stable Error Semantics
8 / 8
Request/Response Examples
7 / 7
Rate-Limit Signaling
7 / 7
Typed Event Surface
6 / 6
Agent Skills
5 / 5
Well-Known Catalog
0 / 4
Consent & Bot Identity
0 / 3
A2A Agent Card
0 / 8
Dry-Run / Simulate Mode
0 / 4
Individual APIs this provider publishes, each with its own machine-readable definition.
Scroll for all 18
Open, tool-agnostic API collections (OpenAPI-derived and Bruno).
Scroll for all 16
Published pricing tiers and plan structures.
Documented rate limits and quota policies.
Cost, billing, and metering signals for API financial operations.
AsyncAPI definitions for this provider's event-driven and streaming APIs.
JSON-LD contexts and semantic vocabularies used across these APIs.
Spectral governance rulesets for linting and validating these APIs.
Standalone JSON Schema definitions for this provider's data models.
JSON Structure definitions describing this provider's data shapes.
Example request and response payloads for these APIs.
Authentication, domain security, vulnerability disclosure, and trust-center signals.
OAuth scopes governing access to this provider's APIs.
Recommended x-agentic-access execution contracts for AI agents.
Get Started 3
Portal, sign-up, and the first successful call
Documentation 5
Reference material describing how the API behaves
Agent Surfaces 4
MCP servers, agent skills, and machine-readable catalogs
Design & Contract 11
Pagination, idempotency, versioning, errors, and events
Scroll for all 11
Build 6
SDKs, sample code, and the tooling you integrate with
Access & Security 7
Authentication, authorization, and security posture
Scroll for all 7
Operate 6
Status, limits, changes, and where to get help
Commercial 5
Pricing, plans, and the legal terms of use
Company 1
The organization behind the API
Other 2
Properties that don't map to a standard resource type
Source (apis.yml)
aid: openmercantil
url: https://raw.githubusercontent.com/api-evangelist/openmercantil/refs/heads/main/apis.yml
name: OpenMercantil
type: Index
accessModel:
pricing: freemium
onboarding: open
trial: true
try_now: true
public: true
label: Freemium (free trial) · Open access
confidence: high
source:
- plans
- authentication
generated: '2026-08-14'
method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/openmercantil.png
access: 3rd-Party
position: Consuming
created: '2026-05-09'
modified: '2026-08-14'
specificationVersion: '0.23'
description: OpenMercantil is an independent public-data API for Spanish company intelligence. It indexes the Boletin Oficial
del Registro Mercantil (BORME) and cross-references it with 80+ official public sources (BOE, CNMV, CNMC, AEAT, AEPD, PLACSP,
TED EU, BDNS, OEPM, EPO, WIPO, CENDOJ, GLEIF, OpenSanctions, ICIJ and more) to expose company and person search, structured
company reports, BORME registry event timelines, documentary officer mentions, CNAE sector navigation and ratios, daily
BORME summaries, public-procurement notices and rankings, documentary risk signals, a corporate relationship graph, a Spanish
mercantile-law corpus that bridges registry acts to the governing BOE norm, account-plane datasets and HMAC-signed outbound
webhooks, and CSV/JSON bulk exports. The live OpenAPI 3.1 contract (v1.9.3) declares 118 paths and 139 operations. The public
read plane is free and anonymous with no API key, rate-limited at 60 req/min and 200 req/day per IP, with paid Profesional,
MAX and Enterprise tiers raising the quota. Derived data is CC BY 4.0 and every response carries its own source and attribution
metadata. The project is informational and does not replace official Registro Mercantil certificates.
tags:
- BDNS
- BORME
- Business Registry
- CIF
- CNAE
- CNMV
- CSV
- Company Data
- Company Search
- Corporate Registry
- DCAT-AP
- Daily Summary
- Geocoding
- JSON
- Legal Data
- Mercantile Law
- OEPM
- Open Data
- Open Government Data
- OpenAPI
- OpenSanctions
- PLACSP
- Public Procurement
- Public Records
- Public-Interest Data
- REST API
- Registry Timeline
- Risk Signals
- Sanctions
- Spain
- Spanish Companies
- Spanish Open Data
- Tenders
- Trust Score
- Webhook
tags_raw:
- BDNS
- BORME
- Business Registry
- CIF
- CNAE
- CNMV
- CSV
- Company Data
- Company Search
- Corporate Registry
- DCAT-AP
- Daily Summary
- Geocoding
- JSON
- Legal Data
- Mercantile Law
- OEPM
- Open Data
- Open Government Data
- OpenAPI
- OpenSanctions
- PLACSP
- Public Procurement
- Public Records
- Public-Interest Data
- REST API
- Registry Timeline
- Risk Signals
- Sanctions
- Spain
- Spanish Companies
- Spanish Open Data
- Tenders
- Trust Score
- Webhooks
apis:
- aid: openmercantil:openmercantil-api-credentials-api
name: OpenMercantil API Credentials API
description: 'Account API credential management: list, create, rotate and revoke opaque omk_* API keys. Secrets are returned
once and recoverable only via an identical Idempotency-Key replay inside 24 hours.'
humanURL: https://openmercantil.es/api/documentacion
baseURL: https://openmercantil.es
tags:
- API Credentials
properties:
- type: OpenAPI
url: openapi/openmercantil-api-credentials-api-openapi.yml
- type: Overlay
url: overlays/openmercantil-api-credentials-overlay.yaml
- type: Documentation
url: https://openmercantil.es/api/documentacion
- type: APIReference
url: https://openmercantil.es/docs
- type: APIsJSON
url: https://openmercantil.es/apis.json
- aid: openmercantil:openmercantil-billing-api
name: OpenMercantil Billing API
description: Session-bound Stripe checkout, invoices and portal contracts. External actions are bounded, idempotent and
never exposed through the public MCP.
humanURL: https://openmercantil.es/api/documentacion
baseURL: https://openmercantil.es
tags:
- Billing
properties:
- type: OpenAPI
url: openapi/openmercantil-billing-api-openapi.yml
- type: Overlay
url: overlays/openmercantil-billing-overlay.yaml
- type: Documentation
url: https://openmercantil.es/api/documentacion
- type: APIReference
url: https://openmercantil.es/docs
- type: APIsJSON
url: https://openmercantil.es/apis.json
- aid: openmercantil:openmercantil-borme-api
name: OpenMercantil BORME API
description: Daily BORME publications, multi-source timeline and registry events
humanURL: https://openmercantil.es/api/documentacion
baseURL: https://openmercantil.es
tags:
- BORME
properties:
- type: OpenAPI
url: openapi/openmercantil-borme-api-openapi.yml
- type: Overlay
url: overlays/openmercantil-borme-overlay.yaml
- type: Documentation
url: https://openmercantil.es/api/documentacion
- type: APIReference
url: https://openmercantil.es/docs
- type: APIsJSON
url: https://openmercantil.es/apis.json
- aid: openmercantil:openmercantil-companies-api
name: OpenMercantil Companies API
description: Company reports and registry events
humanURL: https://openmercantil.es/api/documentacion
baseURL: https://openmercantil.es
tags:
- Companies
properties:
- type: OpenAPI
url: openapi/openmercantil-companies-api-openapi.yml
- type: Overlay
url: overlays/openmercantil-companies-overlay.yaml
- type: Documentation
url: https://openmercantil.es/api/documentacion
- type: APIReference
url: https://openmercantil.es/docs
- type: APIsJSON
url: https://openmercantil.es/apis.json
- aid: openmercantil:openmercantil-datasets-api
name: OpenMercantil Datasets API
description: Bulk exports (CSV / JSON / aggregated stats)
humanURL: https://openmercantil.es/api/documentacion
baseURL: https://openmercantil.es
tags:
- Datasets
properties:
- type: OpenAPI
url: openapi/openmercantil-datasets-api-openapi.yml
- type: Overlay
url: overlays/openmercantil-datasets-overlay.yaml
- type: Documentation
url: https://openmercantil.es/api/documentacion
- type: APIReference
url: https://openmercantil.es/docs
- type: APIsJSON
url: https://openmercantil.es/apis.json
- aid: openmercantil:openmercantil-graph-api
name: OpenMercantil Graph API
description: Corporate and person-to-company relationship graphs. Every emitted record retains the source-specific terms
authorized by the active public source catalog; no blanket relicensing applies.
humanURL: https://openmercantil.es/api/documentacion
baseURL: https://openmercantil.es
tags:
- Graph
properties:
- type: OpenAPI
url: openapi/openmercantil-graph-api-openapi.yml
- type: Overlay
url: overlays/openmercantil-graph-overlay.yaml
- type: Documentation
url: https://openmercantil.es/api/documentacion
- type: APIReference
url: https://openmercantil.es/docs
- type: APIsJSON
url: https://openmercantil.es/apis.json
- aid: openmercantil:openmercantil-integrations-api
name: OpenMercantil Integrations API
description: Public read-only connector catalog. Never exposes credentials, OAuth tokens, webhook secrets or operator actions.
humanURL: https://openmercantil.es/api/documentacion
baseURL: https://openmercantil.es
tags:
- Integration
tags_raw:
- Integrations
properties:
- type: OpenAPI
url: openapi/openmercantil-integrations-api-openapi.yml
- type: Overlay
url: overlays/openmercantil-integrations-overlay.yaml
- type: Documentation
url: https://openmercantil.es/api/documentacion
- type: APIReference
url: https://openmercantil.es/docs
- type: APIsJSON
url: https://openmercantil.es/apis.json
- aid: openmercantil:openmercantil-legal-api
name: OpenMercantil Legal API
description: 'Spanish mercantile-law layer (derecho mercantil): legislation corpus + article texts + act→norm bridge. Distributes
the consolidated BOE legal corpus structured by OpenMercantil so LLMs and agents can cite it as a source. License: consolidated
text from the BOE, reused under Ley 37/2007 (re-use of public sector information); the official version is always boe.es.
Informational only — NOT legal advice. Court judgments are NOT exposed here (CENDOJ is kept as a citation-index only,
per CGPJ…'
humanURL: https://openmercantil.es/api/documentacion
baseURL: https://openmercantil.es
tags:
- Legal
properties:
- type: OpenAPI
url: openapi/openmercantil-legal-api-openapi.yml
- type: Overlay
url: overlays/openmercantil-legal-overlay.yaml
- type: Documentation
url: https://openmercantil.es/api/documentacion
- type: APIReference
url: https://openmercantil.es/docs
- type: APIsJSON
url: https://openmercantil.es/apis.json
- aid: openmercantil:openmercantil-persons-api
name: OpenMercantil Persons API
description: Documentary mentions of natural persons in BORME (officer roles). Persons treated as documentary mentions only
— no DNI, no contact data, no scoring.
humanURL: https://openmercantil.es/api/documentacion
baseURL: https://openmercantil.es
tags:
- Persons
properties:
- type: OpenAPI
url: openapi/openmercantil-persons-api-openapi.yml
- type: Overlay
url: overlays/openmercantil-persons-overlay.yaml
- type: Documentation
url: https://openmercantil.es/api/documentacion
- type: APIReference
url: https://openmercantil.es/docs
- type: APIsJSON
url: https://openmercantil.es/apis.json
- aid: openmercantil:openmercantil-public-procurement-api
name: OpenMercantil Public Procurement API
description: Public procurement awards (PLACSP) and grants (BDNS)
humanURL: https://openmercantil.es/api/documentacion
baseURL: https://openmercantil.es
tags:
- Public Procurement
properties:
- type: OpenAPI
url: openapi/openmercantil-public-procurement-api-openapi.yml
- type: Overlay
url: overlays/openmercantil-public-procurement-overlay.yaml
- type: Documentation
url: https://openmercantil.es/api/documentacion
- type: APIReference
url: https://openmercantil.es/docs
- type: APIsJSON
url: https://openmercantil.es/apis.json
- aid: openmercantil:openmercantil-risk-signals-api
name: OpenMercantil Risk Signals API
description: Documentary risk signals from public sources (AEPD, CNMC, concursos, AEAT moroso, CENDOJ)
humanURL: https://openmercantil.es/api/documentacion
baseURL: https://openmercantil.es
tags:
- Risk Signals
properties:
- type: OpenAPI
url: openapi/openmercantil-risk-signals-api-openapi.yml
- type: Overlay
url: overlays/openmercantil-risk-signals-overlay.yaml
- type: Documentation
url: https://openmercantil.es/api/documentacion
- type: APIReference
url: https://openmercantil.es/docs
- type: APIsJSON
url: https://openmercantil.es/apis.json
- aid: openmercantil:openmercantil-search-api
name: OpenMercantil Search API
description: Company and person search endpoints
humanURL: https://openmercantil.es/api/documentacion
baseURL: https://openmercantil.es
tags:
- Search
properties:
- type: OpenAPI
url: openapi/openmercantil-search-api-openapi.yml
- type: Overlay
url: overlays/openmercantil-search-overlay.yaml
- type: Documentation
url: https://openmercantil.es/api/documentacion
- type: APIReference
url: https://openmercantil.es/docs
- type: APIsJSON
url: https://openmercantil.es/apis.json
- aid: openmercantil:openmercantil-sectors-api
name: OpenMercantil Sectors API
description: CNAE sector aggregates, ratios and company listings
humanURL: https://openmercantil.es/api/documentacion
baseURL: https://openmercantil.es
tags:
- Sectors
properties:
- type: OpenAPI
url: openapi/openmercantil-sectors-api-openapi.yml
- type: Overlay
url: overlays/openmercantil-sectors-overlay.yaml
- type: Documentation
url: https://openmercantil.es/api/documentacion
- type: APIReference
url: https://openmercantil.es/docs
- type: APIsJSON
url: https://openmercantil.es/apis.json
- aid: openmercantil:openmercantil-sources-api
name: OpenMercantil Sources API
description: Source catalog metadata, freshness and integration status
humanURL: https://openmercantil.es/api/documentacion
baseURL: https://openmercantil.es
tags:
- Sources
properties:
- type: OpenAPI
url: openapi/openmercantil-sources-api-openapi.yml
- type: Overlay
url: overlays/openmercantil-sources-overlay.yaml
- type: Documentation
url: https://openmercantil.es/api/documentacion
- type: APIReference
url: https://openmercantil.es/docs
- type: APIsJSON
url: https://openmercantil.es/apis.json
- aid: openmercantil:openmercantil-support-api
name: OpenMercantil Support API
description: Customer-support writes. Anonymous creation requires explicit privacy consent; replies require an authenticated
owner session and CSRF. Ticket data is never exposed through the public MCP.
humanURL: https://openmercantil.es/api/documentacion
baseURL: https://openmercantil.es
tags:
- Support
properties:
- type: OpenAPI
url: openapi/openmercantil-support-api-openapi.yml
- type: Overlay
url: overlays/openmercantil-support-overlay.yaml
- type: Documentation
url: https://openmercantil.es/api/documentacion
- type: APIReference
url: https://openmercantil.es/docs
- type: APIsJSON
url: https://openmercantil.es/apis.json
- aid: openmercantil:openmercantil-system-api
name: OpenMercantil System API
description: Service health and metadata
humanURL: https://openmercantil.es/api/documentacion
baseURL: https://openmercantil.es
tags:
- System
properties:
- type: OpenAPI
url: openapi/openmercantil-system-api-openapi.yml
- type: Overlay
url: overlays/openmercantil-system-overlay.yaml
- type: Documentation
url: https://openmercantil.es/api/documentacion
- type: APIReference
url: https://openmercantil.es/docs
- type: APIsJSON
url: https://openmercantil.es/apis.json
- aid: openmercantil:openmercantil-user-api
name: OpenMercantil User API
description: Authenticated Panel Pro endpoints — segments, lists, notes, tags, exports, audit. Requires session cookie (browser)
and X-CSRF-Token header for mutations.
humanURL: https://openmercantil.es/api/documentacion
baseURL: https://openmercantil.es
tags:
- User
properties:
- type: OpenAPI
url: openapi/openmercantil-user-api-openapi.yml
- type: Overlay
url: overlays/openmercantil-user-overlay.yaml
- type: Documentation
url: https://openmercantil.es/api/documentacion
- type: APIReference
url: https://openmercantil.es/docs
- type: APIsJSON
url: https://openmercantil.es/apis.json
- aid: openmercantil:openmercantil-webhooks-api
name: OpenMercantil Webhooks API
description: 'Account outbound webhooks: register, update, rotate the HMAC signing secret and delete event subscriptions.
Three subscribable event types; deliveries are signed and fail closed on unknown events.'
humanURL: https://openmercantil.es/api/documentacion
baseURL: https://openmercantil.es
tags:
- Webhook
tags_raw:
- Webhooks
properties:
- type: OpenAPI
url: openapi/openmercantil-webhooks-api-openapi.yml
- type: Overlay
url: overlays/openmercantil-webhooks-overlay.yaml
- type: Documentation
url: https://openmercantil.es/api/documentacion
- type: APIReference
url: https://openmercantil.es/docs
- type: APIsJSON
url: https://openmercantil.es/apis.json
- type: Webhooks
url: asyncapi/openmercantil-webhooks.yml
maintainers:
- FN: OpenMercantil
email: social@openmercantil.es
- FN: Pablo Cirre
url: https://github.com/PabloCirre
common:
- type: AgenticAccess
url: agentic-access/openmercantil-agentic-access.yml
- type: DomainSecurity
url: security/openmercantil-domain-security.yml
- type: Authentication
url: authentication/openmercantil-authentication.yml
- name: Website
url: https://openmercantil.es/
type: Website
- name: API Documentation
url: https://openmercantil.es/api/documentacion
type: Documentation
- name: APIs.json
url: https://openmercantil.es/apis.json
type: APIsJSON
- name: Pricing
url: https://openmercantil.es/precios
type: Pricing
- name: Terms Of Use
url: https://openmercantil.es/terminos-de-uso
type: TermsOfService
- name: Support
url: https://openmercantil.es/soporte
type: Support
- name: Downloads
url: https://openmercantil.es/descargas
type: Downloads
- name: GitHub (maintainer account, published in /humans.txt)
url: https://github.com/PabloCirre
type: GitHubOrganization
- url: json-schema/openmercantil-company-schema.json
type: JSONSchema
- url: json-schema/openmercantil-event-schema.json
type: JSONSchema
- url: json-structure/openmercantil-company-structure.json
type: JSONStructure
- url: json-ld/openmercantil-context.jsonld
type: JSONLDContext
- url: examples/openmercantil-search-companies-example.json
type: Examples
- url: examples/openmercantil-get-company-example.json
type: Examples
- url: examples/openmercantil-get-company-events-example.json
type: Examples
- url: examples/openmercantil-health-example.json
type: Examples
- url: rules/openmercantil-rules.yml
type: SpectralRuleset
- url: vocabulary/openmercantil-vocabulary.yml
type: Vocabulary
- url: plans/openmercantil-plans-pricing.yml
type: Plans
- url: rate-limits/openmercantil-rate-limits.yml
type: RateLimits
- url: finops/openmercantil-finops.yml
type: FinOps
- type: LLMsTxt
url: https://openmercantil.es/llms.txt
- type: Packages
url: packages/openmercantil-packages.yml
- type: Conventions
url: conventions/openmercantil-conventions.yml
- type: Idempotency
url: conventions/openmercantil-conventions.yml
- type: ErrorCatalog
url: errors/openmercantil-problem-types.yml
- type: Lifecycle
url: lifecycle/openmercantil-lifecycle.yml
- type: StatusPage
url: https://openmercantil.es/status
name: Service Status
- type: Deprecation
url: lifecycle/openmercantil-lifecycle.yml
- type: ChangeLog
url: changelog/openmercantil-changelog.yml
- type: Conformance
url: conformance/openmercantil-conformance.yml
- type: Compliance
url: conformance/openmercantil-conformance.yml
- type: OAuthScopes
url: scopes/openmercantil-scopes.yml
- type: VulnerabilityDisclosure
url: security/openmercantil-vulnerability-disclosure.yml
- type: Security
url: security/openmercantil-vulnerability-disclosure.yml
- type: TrustCenter
url: security/openmercantil-trust-center.yml
- type: DataModel
url: data-model/openmercantil-data-model.yml
- type: Webhooks
url: asyncapi/openmercantil-webhooks.yml
- type: AgentSkill
url: skills/_index.yml
- type: LLMsTxt
url: llms/openmercantil-llms.txt
- type: DeveloperPortal
url: https://openmercantil.es/api
name: Developer Portal
- type: APIReference
url: https://openmercantil.es/docs
name: Swagger UI Reference
- type: GettingStarted
url: https://openmercantil.es/api/documentacion
name: Quickstart
- type: OpenAPI
url: https://openmercantil.es/openapi.json
name: Full OpenAPI 3.1 (v1.9.3)
- type: SignUp
url: https://openmercantil.es/mi-cuenta/login
name: Sign Up / Login
- type: PrivacyPolicy
url: https://openmercantil.es/privacidad
name: Privacy Policy
- type: HelpCenter
url: https://openmercantil.es/faq
name: FAQ
url-source: https://openmercantil.es/
x-enrichment:
date: '2026-08-14'
status: enriched
artifacts_added: 50
pass: local-v1