OpenMercantil website screenshot

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 29+ public sources (CNMV, OEPM, PLACSP, BDNS, OpenSanctions, CCAA gazettes, CNMC, CENDOJ and more) to expose company search, structured company reports, registry event timelines, officer records, CNAE sector navigation, daily summaries, public-procurement rankings, a v1.4 cross-source trust score, and CSV/JSON exports. The public REST API is free, requires no API key, and is rate-limited per IP. The project is informational and does not replace official Registro Mercantil certificates.

OpenMercantil publishes 14 APIs on the APIs.io network, including Billing API, Companies API, Contracts API, and 11 more. Tagged areas include Open Data, Spain, Company Data, Business Registry, and BORME.

The OpenMercantil catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

OpenMercantil’s developer surface includes authentication, documentation, pricing, support, code examples, and 20 more developer resources.

🌐 Visit website 📡 Source on GitHub
50.7/100 developing ▼ -5.3 Agent 35/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessPaidOpenFree trial⚡ Free to try
14 APIs
Open DataSpainCompany DataBusiness RegistryBORMEPublic RecordsSpanish CompaniesCIFCNAEPublic ProcurementPLACSPCNMVOEPMBDNSOpenSanctionsPublic-Interest DataSpanish Open DataREST APIJSONCSVGeocodingTrust ScoreRegistry TimelineDaily Summary

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 50.7/100 · developing
Contract Quality 16.1 / 25
Developer Ergonomics 4.8 / 20
Commercial Clarity 12.1 / 20
Operational Transparency 4.1 / 13
Governance 8.3 / 12
Discoverability 7.4 / 10
Agent readiness — 35/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/openmercantil: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 14

Individual APIs this provider publishes, each with its own machine-readable definition.

OpenMercantil Billing API

Stripe checkout and donation endpoints

OpenMercantil Companies API

Company reports, registry events, officers and export

OpenMercantil Contracts API

Public procurement (PLACSP) rankings

OpenMercantil Daily API

Daily BORME summary feeds

OpenMercantil Export API

Bulk and per-resource export endpoints

OpenMercantil Geocode API

Geolocation enrichment

OpenMercantil Network API

Company relationship network and embargoes

OpenMercantil Persons API

Person search and person reports

OpenMercantil Score API

Company score, trust score and activity timeseries

OpenMercantil Search API

Company and person search endpoints

OpenMercantil Sectors API

CNAE sector taxonomy and sector statistics

OpenMercantil Sources API

External sources and dataset freshness

OpenMercantil Stats API

Aggregate statistics by region and sector

OpenMercantil System API

Service health and metadata

Scroll for all 14

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

OpenMercantil Public API

OPEN COLLECTION

Pricing Plans 1

Published pricing tiers and plan structures.

Openmercantil Plans Pricing

3 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Openmercantil Rate Limits

3 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Openmercantil Finops

FINOPS

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Openmercantil Context

31 classes · 2 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

OpenMercantil API Rules

5 rules · 4 warnings 1 info

SPECTRAL

OpenMercantil API Rules

9 rules · 2 errors 4 warnings 3 info

SPECTRAL

JSON Schema 2

Standalone JSON Schema definitions for this provider's data models.

OpenMercantil Company

13 properties

JSON SCHEMA

OpenMercantil Company Event

5 properties

JSON SCHEMA

JSON Structure 1

JSON Structure definitions describing this provider's data shapes.

Openmercantil Company Structure

13 properties

JSON STRUCTURE

Examples 4

Example request and response payloads for these APIs.

Openmercantil Get Company Events Example

2 fields

EXAMPLE

Openmercantil Get Company Example

2 fields

EXAMPLE

Openmercantil Health Example

2 fields

EXAMPLE

Openmercantil Search Companies Example

2 fields

EXAMPLE

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Openmercantil Authentication

apiKey · 1 scheme

SECURITY

Openmercantil Domain Security

TLSv1.3 · HSTS

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Openmercantil Agentic Access

36 operations · 2 acting

36 operations · 2 acting

AGENTIC

Resources

Documentation 3

Reference material describing how the API behaves

Documentation
Documentation
 JSONSchema
JSONSchema
 JSONSchema
JSONSchema

Agent Surfaces 2

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess
AgenticAccess
 LlmsText
LlmsText

Design & Contract 4

Pagination, idempotency, versioning, errors, and events

JSONStructure
JSONStructure
 JSONLDContext
JSONLDContext
 SpectralRuleset
SpectralRuleset
 Vocabulary
Vocabulary

Build 5

SDKs, sample code, and the tooling you integrate with

GitHubProject
GitHubProject
 Examples
Examples
 Examples
Examples
 Examples
Examples
 Examples
Examples

Access & Security 2

Authentication, authorization, and security posture

DomainSecurity
DomainSecurity
 Authentication
Authentication

Operate 2

Status, limits, changes, and where to get help

Support
Support
 RateLimits
RateLimits

Commercial 4

Pricing, plans, and the legal terms of use

Pricing
Pricing
 TermsOfService
TermsOfService
 Plans
Plans
 FinOps
FinOps

Company 1

The organization behind the API

Website
Website

Other 2

Properties that don't map to a standard resource type

APIsJSON
APIsJSON
 Downloads
Downloads

Source (apis.yml)

apis.yml Raw ↑ 
aid: openmercantil
url: https://raw.githubusercontent.com/api-evangelist/openmercantil/refs/heads/main/apis.yml
name: OpenMercantil
type: Index
accessModel:
  pricing: paid
  onboarding: open
  trial: true
  try_now: true
  public: true
  label: Paid (free trial) · Open access
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  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-05-19'
specificationVersion: '0.19'
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 29+ public sources (CNMV, OEPM, PLACSP, BDNS, OpenSanctions,
  CCAA gazettes, CNMC, CENDOJ and more) to expose company search, structured company reports, registry event timelines, officer
  records, CNAE sector navigation, daily summaries, public-procurement rankings, a v1.4 cross-source trust score, and CSV/JSON
  exports. The public REST API is free, requires no API key, and is rate-limited per IP. The project is informational and
  does not replace official Registro Mercantil certificates.
tags:
- Open Data
- Spain
- Company Data
- Business Registry
- BORME
- Public Records
- Spanish Companies
- CIF
- CNAE
- Public Procurement
- PLACSP
- CNMV
- OEPM
- BDNS
- OpenSanctions
- Public-Interest Data
- Spanish Open Data
- REST API
- JSON
- CSV
- Geocoding
- Trust Score
- Registry Timeline
- Daily Summary
apis:
- aid: openmercantil:openmercantil-billing-api
  name: OpenMercantil Billing API
  description: Stripe checkout and donation endpoints
  humanURL: https://openmercantil.es/api/documentacion
  baseURL: https://openmercantil.es
  tags:
  - Billing
  properties:
  - type: OpenAPI
    url: openapi/openmercantil-billing-api-openapi.yml
  - type: Documentation
    url: https://openmercantil.es/api/documentacion
  - type: APIsJSON
    url: https://openmercantil.es/apis.json
- aid: openmercantil:openmercantil-companies-api
  name: OpenMercantil Companies API
  description: Company reports, registry events, officers and export
  humanURL: https://openmercantil.es/api/documentacion
  baseURL: https://openmercantil.es
  tags:
  - Companies
  properties:
  - type: OpenAPI
    url: openapi/openmercantil-companies-api-openapi.yml
  - type: Documentation
    url: https://openmercantil.es/api/documentacion
  - type: APIsJSON
    url: https://openmercantil.es/apis.json
- aid: openmercantil:openmercantil-contracts-api
  name: OpenMercantil Contracts API
  description: Public procurement (PLACSP) rankings
  humanURL: https://openmercantil.es/api/documentacion
  baseURL: https://openmercantil.es
  tags:
  - Contracts
  properties:
  - type: OpenAPI
    url: openapi/openmercantil-contracts-api-openapi.yml
  - type: Documentation
    url: https://openmercantil.es/api/documentacion
  - type: APIsJSON
    url: https://openmercantil.es/apis.json
- aid: openmercantil:openmercantil-daily-api
  name: OpenMercantil Daily API
  description: Daily BORME summary feeds
  humanURL: https://openmercantil.es/api/documentacion
  baseURL: https://openmercantil.es
  tags:
  - Daily
  properties:
  - type: OpenAPI
    url: openapi/openmercantil-daily-api-openapi.yml
  - type: Documentation
    url: https://openmercantil.es/api/documentacion
  - type: APIsJSON
    url: https://openmercantil.es/apis.json
- aid: openmercantil:openmercantil-export-api
  name: OpenMercantil Export API
  description: Bulk and per-resource export endpoints
  humanURL: https://openmercantil.es/api/documentacion
  baseURL: https://openmercantil.es
  tags:
  - Export
  properties:
  - type: OpenAPI
    url: openapi/openmercantil-export-api-openapi.yml
  - type: Documentation
    url: https://openmercantil.es/api/documentacion
  - type: APIsJSON
    url: https://openmercantil.es/apis.json
- aid: openmercantil:openmercantil-geocode-api
  name: OpenMercantil Geocode API
  description: Geolocation enrichment
  humanURL: https://openmercantil.es/api/documentacion
  baseURL: https://openmercantil.es
  tags:
  - Geocode
  properties:
  - type: OpenAPI
    url: openapi/openmercantil-geocode-api-openapi.yml
  - type: Documentation
    url: https://openmercantil.es/api/documentacion
  - type: APIsJSON
    url: https://openmercantil.es/apis.json
- aid: openmercantil:openmercantil-network-api
  name: OpenMercantil Network API
  description: Company relationship network and embargoes
  humanURL: https://openmercantil.es/api/documentacion
  baseURL: https://openmercantil.es
  tags:
  - Network
  properties:
  - type: OpenAPI
    url: openapi/openmercantil-network-api-openapi.yml
  - type: Documentation
    url: https://openmercantil.es/api/documentacion
  - type: APIsJSON
    url: https://openmercantil.es/apis.json
- aid: openmercantil:openmercantil-persons-api
  name: OpenMercantil Persons API
  description: Person search and person reports
  humanURL: https://openmercantil.es/api/documentacion
  baseURL: https://openmercantil.es
  tags:
  - Persons
  properties:
  - type: OpenAPI
    url: openapi/openmercantil-persons-api-openapi.yml
  - type: Documentation
    url: https://openmercantil.es/api/documentacion
  - type: APIsJSON
    url: https://openmercantil.es/apis.json
- aid: openmercantil:openmercantil-score-api
  name: OpenMercantil Score API
  description: Company score, trust score and activity timeseries
  humanURL: https://openmercantil.es/api/documentacion
  baseURL: https://openmercantil.es
  tags:
  - Score
  properties:
  - type: OpenAPI
    url: openapi/openmercantil-score-api-openapi.yml
  - type: Documentation
    url: https://openmercantil.es/api/documentacion
  - 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: Documentation
    url: https://openmercantil.es/api/documentacion
  - type: APIsJSON
    url: https://openmercantil.es/apis.json
- aid: openmercantil:openmercantil-sectors-api
  name: OpenMercantil Sectors API
  description: CNAE sector taxonomy and sector statistics
  humanURL: https://openmercantil.es/api/documentacion
  baseURL: https://openmercantil.es
  tags:
  - Sectors
  properties:
  - type: OpenAPI
    url: openapi/openmercantil-sectors-api-openapi.yml
  - type: Documentation
    url: https://openmercantil.es/api/documentacion
  - type: APIsJSON
    url: https://openmercantil.es/apis.json
- aid: openmercantil:openmercantil-sources-api
  name: OpenMercantil Sources API
  description: External sources and dataset freshness
  humanURL: https://openmercantil.es/api/documentacion
  baseURL: https://openmercantil.es
  tags:
  - Sources
  properties:
  - type: OpenAPI
    url: openapi/openmercantil-sources-api-openapi.yml
  - type: Documentation
    url: https://openmercantil.es/api/documentacion
  - type: APIsJSON
    url: https://openmercantil.es/apis.json
- aid: openmercantil:openmercantil-stats-api
  name: OpenMercantil Stats API
  description: Aggregate statistics by region and sector
  humanURL: https://openmercantil.es/api/documentacion
  baseURL: https://openmercantil.es
  tags:
  - Stats
  properties:
  - type: OpenAPI
    url: openapi/openmercantil-stats-api-openapi.yml
  - type: Documentation
    url: https://openmercantil.es/api/documentacion
  - 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: Documentation
    url: https://openmercantil.es/api/documentacion
  - type: APIsJSON
    url: https://openmercantil.es/apis.json
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
  url: https://github.com/PabloCirre/OpenBorme
  type: GitHubProject
- 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: LlmsText
  url: https://openmercantil.es/llms.txt
url-source: https://openmercantil.es/