OpenMercantil

OpenMercantil Companies API

Company reports and registry events

GitHub OpenAPI

Operations 34

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /api/v1/company/{slug} Get a Spanish company's registry report · Get a company report #
Ask an LLM
“What does OpenMercantil's structured report on a Spanish company include?”
“Can I pull the full registry profile of a company using its slug?”
Tell an agent
Get the company report for {company}.
Show me the full registry profile of {company}.
GET /api/v1/companies/compare Compare two companies side by side · Compare exactly two admitted companies #
Ask an LLM
“Can I compare two Spanish companies side by side in one request?”
“Which fields come back when I compare exactly two companies?”
Tell an agent
Compare the two companies {slugs}.
Put {slugs} side by side and show how they differ.
GET /api/v1/datasets/public List the public company dataset downloads · List generation-bound public company downloads #
Ask an LLM
“Which bulk company datasets can I download for free?”
“Where do I find the public company download files and their checksums?”
Tell an agent
List the public company dataset downloads.
Show me the downloadable company data files currently published.
GET /api/v1/company/{slug}/events List a company's BORME events by year · Get paginated company events #
Ask an LLM
“How do I see every BORME registry event published for a company?”
“Can I filter a company's registry events to a single calendar year?”
Tell an agent
List the BORME events for {company} in {year}.
Show page {page} of the registry events for {company}.
GET /api/v1/company/{slug}/timeline Get a company's combined multi-source timeline · Get unified multi-source company timeline #
Ask an LLM
“Can I get one chronological timeline mixing a company's BORME acts and procurement notices?”
“Which sources feed the unified company timeline?”
Tell an agent
Build the unified timeline for {company}.
Show BORME and procurement history for {company} in chronological order.
GET /api/v1/company/{slug}/officers List a company's current and past officers · Get current and historical company officers #
Ask an LLM
“Who are the directors and administrators of a Spanish company?”
“Can I see former officers of a company, not just the current board?”
Tell an agent
List the officers of {company}.
Show current and historical directors of {company}.
GET /api/v1/company/{slug}/contracts List procurement notices linked to a company · Get PLACSP procurement notices linked to a legal entity #
Ask an LLM
“Which public procurement notices is a Spanish company linked to?”
“Does a company's PLACSP contract list prove it was actually paid?”
Tell an agent
List the PLACSP procurement notices for {company}.
Show the first {limit} public tenders linked to {company}.
GET /api/v1/company/{slug}/procurement Get a company's procurement via the alias route · Alias of /contracts #
Ask an LLM
“Is there a /procurement alias that returns the same payload as a company's contracts route?”
“Which canonical route does the company procurement alias point to?”
Tell an agent
Fetch {company}'s procurement notices through the /procurement alias.
Call the procurement alias route for {company}.
GET /api/v1/company/{slug}/grants List public grants awarded to a company · Get BDNS public grants #
Ask an LLM
“Which BDNS public subsidies has a Spanish company been awarded?”
“Are grant amounts reported as payments or as awarded amounts?”
Tell an agent
List the public grants awarded to {company}.
Show up to {limit} BDNS subsidies for {company}.
GET /api/v1/company/{slug}/ip Get a company's trademarks and patents · Get policy-gated aggregated trademarks and patents #
Ask an LLM
“Can I look up the trademarks and patents a Spanish company holds?”
“Why does the company intellectual property route return a 503?”
Tell an agent
Get the trademarks and patents registered to {company}.
Check the OEPM, EUIPO and EPO filings for {company}.
GET /api/v1/company/{slug}/sources Show which data sources cover a company · Get bounded public integration coverage for a company #
Ask an LLM
“Which integrated sources have data about a given company?”
“Does empty coverage for a source prove the company is absent there?”
Tell an agent
Show the data source coverage for {company}.
Check which of BDNS, CNMV, TED and Wikidata have records on {company}.
GET /api/v1/company/{slug}/sanctions Check a company against sanctions data · Get policy-gated sanctions dataset #
Ask an LLM
“Is a Spanish company on any sanctions list?”
“Why is the company sanctions dataset unavailable right now?”
Tell an agent
Check whether {company} appears in sanctions data.
Screen {company} against the sanctions dataset.
GET /api/v1/empresa/{slug}/facts Get a company's extracted BORME facts · Get extracted BORME facts for a company #
Ask an LLM
“What appointments, removals and capital changes has a company published in BORME?”
“Can I get BORME facts for a company grouped by type through the Spanish empresa route?”
Tell an agent
Get the extracted BORME facts for empresa {company}.
Show up to {limit} BORME facts for {company} grouped by type.
GET /api/v1/company/{slug}/facts Get BORME facts via the legacy English route · Get extracted BORME facts through the legacy English alias #
Ask an LLM
“Does the deprecated English company facts route still return BORME facts?”
“Which route replaced the English company facts alias?”
Tell an agent
Get BORME facts for {company} through the legacy English facts route.
Call the deprecated company facts alias for {company}.
GET /api/v1/sector/{cnae}/companies List companies in a CNAE sector · Get companies by CNAE sector code #
Ask an LLM
“Which companies belong to a given CNAE activity code?”
“Can I narrow a sector's companies to one province?”
Tell an agent
List companies in CNAE sector {cnae}.
Show the companies in sector {cnae} located in {province}.
GET /api/v1/company/{slug}/relationships List a company's documentary relationships · Get documentary relationships of a company #
Ask an LLM
“Which people, companies, contracts and grants are documented as connected to a company?”
“Can I filter a company's relationships by type or confidence level?”
Tell an agent
List the documented relationships of {company}.
Show {type} relationships for {company}.
GET /api/v1/company/{slug}/risk-signals Get documentary risk signals for a company · Get documentary risk signals #
Ask an LLM
“What risk signals are published for a Spanish company?”
“Does a missing risk signal mean the underlying fact doesn't exist?”
Tell an agent
Get the documentary risk signals for {company}.
Show authorized risk flags on {company}.
GET /api/v1/company/{slug}/lei Get a company's LEI record · Get policy-gated GLEIF LEI record #
Ask an LLM
“Can I find the Legal Entity Identifier for a Spanish company?”
“Why is the GLEIF LEI lookup for a company returning 503?”
Tell an agent
Get the LEI record for {company}.
Look up the GLEIF legal entity identifier of {company}.
GET /api/v1/company/{slug}/bde Get Banco de España sector ratios for a company · Get Banco de España sector ratios for a company CNAE #
Ask an LLM
“How does a company's sector compare on Banco de España Central de Balances ratios?”
“Are the Banco de España ratios specific to the company or to its sector?”
Tell an agent
Get the Banco de España sector ratios for {company}.
Benchmark the CNAE sector of {company} using Central de Balances ratios.
GET /api/v1/company/{slug}/cnmv Get a company's CNMV listing and events · Get the CNMV listed-company projection and recent events #
Ask an LLM
“Is a Spanish company listed on the stock market according to CNMV?”
“What recent CNMV events have been published for a listed company?”
Tell an agent
Get the CNMV listing data for {company}.
Show the last {limit} CNMV events for {company}.
GET /api/v1/company/{slug}/aeat-moroso Check if a company is on the AEAT debtor list · Check policy-gated AEAT debtor-list mention #
Ask an LLM
“Does a Spanish company appear on the tax agency's list of debtors?”
“Would an AEAT debtor-list mention mean the company still owes tax?”
Tell an agent
Check whether {company} is on the AEAT moroso list.
Look up {company} in the Hacienda debtor list.
GET /api/v1/company/{slug}/wikidata Get a company's Wikidata metadata · Get the bounded Wikidata company metadata projection #
Ask an LLM
“Can I get a company's Wikidata Q-id, ticker and founding date?”
“Which Wikidata fields are excluded from the company projection?”
Tell an agent
Get the Wikidata metadata for {company}.
Find the Wikidata Q-id and ticker of {company}.
GET /api/v1/company/{slug}/ted List EU TED notices linked to a company · Get TED notice records linked to this corporate NIF #
Ask an LLM
“Which EU Tenders Electronic Daily notices mention a Spanish company's NIF?”
“Do TED notice links prove the company won or was paid for the contract?”
Tell an agent
List the TED notices linked to {company}.
Show {limit} European tender notices for {company}.
GET /api/v1/company/{slug}/accounts Get a company's filed annual accounts metadata · Get policy-gated filed accounts metadata #
Ask an LLM
“Can I see metadata about the annual accounts a company has filed?”
“Why is filed accounts metadata for a company currently unavailable?”
Tell an agent
Get the filed accounts metadata for {company}.
Show the annual accounts filings of {company}.
GET /api/v1/company/{slug}/geocode Get a company's geocoded location · Company geocode projection (unavailable) #
Ask an LLM
“Can I get map coordinates for a company from its company record?”
“Why does the company geocode projection always return 503?”
Tell an agent
Get the geocode projection for {company}.
Show where {company} is located on a map.
GET /api/v1/company/{slug}/activity Get a company's monthly registry activity · Activity time series #
Ask an LLM
“How active has a company been in the registry month by month?”
“Can I get a monthly activity series for a sparkline chart?”
Tell an agent
Get the monthly registry activity for {company}.
Build a sparkline of BORME activity counts for {company}.
GET /api/v1/company/{slug}/score Get a company's documentary completeness score · Documentary completeness score (no risk/credit scoring) #
Ask an LLM
“Is there a documentary completeness score for a company's public record?”
“Is the completeness score a credit or risk rating?”
Tell an agent
Get the documentary completeness score for {company}.
Show how complete the public record of {company} is.
GET /api/v1/company/{slug}/similar Find companies similar to a company · Similar companies (province + CNAE2 + BORME activity) #
Ask an LLM
“Which companies are similar to a given company in the same province and sector?”
“How are similar companies ranked?”
Tell an agent
Find companies similar to {company}.
Show {limit} peers of {company} in the same province and CNAE division.
GET /api/v1/company/{slug}/embargoes List embargo mentions for a company · Documentary embargo/garnishment mentions #
Ask an LLM
“Has a Spanish company had assets seized or embargoed according to public registries?”
“Do embargo mentions certify that an embargo is still in force?”
Tell an agent
List the embargo and garnishment mentions for {company}.
Check {company} for published embargoes de bienes.
GET /api/v1/company/{slug}/network Get a company's documentary network graph · Documentary network projection (temporarily unavailable) #
Ask an LLM
“Can I get the documentary network graph around a company?”
“Why is the company network projection temporarily unavailable?”
Tell an agent
Get the documentary network for {company}.
Map the network projection around {company}.
GET /api/v1/company/{slug}/enrichment Get authorized enrichment data for a company · Fail-closed public enrichment payload #
Ask an LLM
“What enrichment data is available for a company from authorized public sources?”
“Does the enrichment payload include license and attribution for each source?”
Tell an agent
Get the enrichment payload for {company}.
Show all licensed public-source enrichment for {company}.
GET /api/v1/company/{slug}/export Download a single company report as JSON · Export a single company report #
Ask an LLM
“Can I download one company's report as a JSON file?”
“Is there a size limit on a single company export?”
Tell an agent
Export the company report for {company} as JSON.
Download {company}'s report to a file.
POST /api/v1/empresa/{slug}/informe-legal Generate a redacted legal report on a company · Create the authenticated user's redacted corporate legal report #
Ask an LLM
“How do I order a legal report on a Spanish company with my credits?”
“Is personal data removed from the corporate legal report?”
Tell an agent
Generate the informe legal for {company} using CSRF token {csrf_token}.
Create a redacted corporate legal report on {company}.
GET /api/v1/company/{slug}/trust-score Get a company's trust score · Get Company Trust Score #
Ask an LLM
“What is OpenMercantil's trust score for a company?”
“Which signals are combined into a company's trust score?”
Tell an agent
Get the trust score for {company}.
Show how trustworthy {company} rates on the combined signals.

Documentation

📖
Documentation
https://openmercantil.es/api/documentacion
📖
APIReference
https://openmercantil.es/docs

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/openmercantil/refs/heads/main/openapi/openmercantil-companies-api-openapi.yml

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/openmercantil/refs/heads/main/overlays/openmercantil-companies-overlay.yaml
🔗
APIsJSON
https://openmercantil.es/apis.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/openmercantil:openmercantil-companies-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API 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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openmercantil-companies-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Openmercantil Companies API
  contact:
    name: OpenMercantil
    url: https://openmercantil.es/soporte
    email: social@openmercantil.es
  termsOfService: https://openmercantil.es/terminos-de-uso
  x-refined-note:
  - x-account-segment-contract differs across the merged source definitions and was not carried
  - x-company-identity-contract differs across the merged source definitions and was not carried
  - x-contract-status differs across the merged source definitions and was not carried
  - x-corrections differs across the merged source definitions and was not carried
  - x-dcat-catalog differs across the merged source definitions and was not carried
  - x-language differs across the merged source definitions and was not carried
  - x-methodology differs across the merged source definitions and was not carried
  - x-publisher differs across the merged source definitions and was not carried
  - x-rate-limit differs across the merged source definitions and was not carried
  - x-sources differs across the merged source definitions and was not carried
  - x-spatial differs across the merged source definitions and was not carried
  - x-temporal differs across the merged source definitions and was not carried
  version: '1.0'
  description: 'Operations tagged Companies across 2 of this provider''s published API definitions: openmercantil-openapi-1.9.3.json, openmercantil-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://openmercantil.es
  description: Production
tags:


# --- truncated at 32 KB (148 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/openmercantil/refs/heads/main/openapi/openmercantil-companies-api-openapi.yml