Get BDNS public grants

Changed on Jul 26, 2026

Read only company_integrations_public_v1 after company_public_v2 admission. Returns up to 200 attested BDNS rows and never queries the canonical grants table. Monetary values are awarded amounts in integer cents, never payments; ambiguous raw zero is null. Empty is complete bounded-projection coverage, not proof of absence upstream.

get/api/v1/company/{slug}/grants

Request

Base URL
https://openmercantil.es
Auth
- none
- or API key in header X-API-Key
- or HTTP bearer
TypeScript
https://skmtc.dev/openmercantil/apis/openmercantil-public-api/docs/api/v1/company/:slug/grants/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

slugstring required

Exact corporate slug admitted by company_public_v2; no empty segments, leading/trailing hyphen or repeated separator.

Query parameters

limitinteger

Headers

If-None-Matchstring

Optional RFC 9110 entity-tag validator. Weak validators, comma-separated validator lists and * are accepted.

Response

Grants list

projection_status'available' required

slugstring required

cifstring required

complete_bounded_projectiontrue required

coverage_status'available' | 'empty' required

coverage_noticestring required

countinteger required

returned_countinteger required

amount_noticestring required

_attributionsobject

Changes

Jul 26, 2026996f96a11758 Revision changes
- breaking
  for the query request parameter limit, default value was changed from 30 to 100
- breaking
  for the path request parameter slug, the minLength was increased from 0 to 1
- breaking
  added the pattern ^[a-z0-9]+(?:-[a-z0-9]+)*$ to the path request parameter slug
- info
  api operation id getCompanyBySlugGrants was added
- info
  the endpoint scheme security apiKey was added to the API
- info
  the endpoint scheme security bearerAuth was added to the API
- info
  added the new optional header request parameter If-None-Match
- info
  for the query request parameter limit, the max was increased from 100.00 to 200.00
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  the response property became required for the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status

Operation history