Fuentio Screening API
The screening API from Fuentio — 5 operation(s) for screening.
Operations 5
GET
/v1/companies/{country}/{identifier}/review
A review-ready report on a company (JSON + Markdown)
#
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/fuentio-com:fuentio-com-screening-api"
All apis
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.
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.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Fuentio Screening API
summary: Verify any company in France, Spain or the United Kingdom in one call, with sources an auditor accepts.
description: 'Start here: the sandbox quickstart (curl examples, a Postman collection, MCP setup and companies to try). What each outcome means: /docs/outcomes. Errors: /docs/errors.'
version: 0.1.0
tags:
- name: Screening
paths:
/v1/companies/{country}/{identifier}/screen:
get:
tags:
- Screening
summary: Screen a company against sanctions lists
description: 'Compares the company''s own names with the EU Financial Sanctions File, the UK Sanctions List, the OFAC SDN list and France''s registre national des gels. `result` is `possible_match` (each with the list, entry, score, reasons, listing date, legal act and official link) or `no_match_found`: "no match found in these lists at this time", or `not_checked` when no list could be read. Never "clear", never "sanctioned": a name match needs a human check. `lists` gives each list''s version, or says it was not checked. Needs an API key. Costs `STARTAPI_SCREEN_UNITS` units (2).'
operationId: get_screen_v1_companies__country___identifier__screen_get
parameters:
- name: country
in: path
required: true
schema:
type: string
maxLength: 2
examples:
- FR
title: Country
- name: identifier
in: path
required: true
schema:
type: string
maxLength: 64
examples:
- '441639465'
title: Identifier
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Get Screen V1 Companies Country Identifier Screen Get
'401':
content:
application/json:
examples:
unauthorized:
value:
meta:
request_id: req_example
error:
code: unauthorized
message: This API key is unknown or revoked.
hint: Get a free key with POST /v1/keys, or call without a key for the keyless trial (20 units a day).
docs_url: https://api.fuentio.com/docs/errors#unauthorized
description: Unauthorized
'402':
content:
application/json:
examples:
quota_exceeded:
value:
meta:
request_id: req_example
error:
code: quota_exceeded
message: 'Quota used up: 20 of 20 units today.'
hint: Get a free key (100 units a month) with POST /v1/keys.
docs_url: https://api.fuentio.com/docs/errors#quota_exceeded
details:
limit: 20
used: 20
resets: '2026-10-06'
description: Payment Required
'429':
content:
application/json:
examples:
rate_limited:
value:
meta:
request_id: req_example
error:
code: rate_limited
message: 'Too many requests: the Trial (no key) plan allows 1 per second.'
hint: Retry after 0.4 seconds.
docs_url: https://api.fuentio.com/docs/errors#rate_limited
details:
retry_after: 1
description: Too Many Requests
'500':
content:
application/json:
examples:
internal_error:
value:
meta:
request_id: req_example
error:
code: internal_error
message: Something went wrong on our side.
hint: Retry later; quote the request_id if you contact support.
docs_url: https://api.fuentio.com/docs/errors#internal_error
description: Internal Server Error
'503':
content:
application/json:
examples:
upstream_unavailable:
value:
meta:
request_id: req_example
error:
code: upstream_unavailable
message: The official source (Annuaire des Entreprises (API Recherche d'entreprises)) is not answering right now.
hint: Retry in a minute.
docs_url: https://api.fuentio.com/docs/errors#upstream_unavailable
details:
source: fr_recherche_entreprises
reason: timeout
description: Service Unavailable
/v1/companies/{country}/{identifier}/insolvency:
get:
tags:
- Screening
summary: Insolvency notices and state of a company
description: 'France: BODACC A insolvency notices (DILA), linked by SIREN; `state` is `in_procedure`, `under_plan`, `closed`, `notice_found` (a notice whose opening came before the loaded years), `none_found` (BODACC loaded for the company''s whole life) or `not_covered`, with `procedure` (safeguard, reorganisation, liquidation), dates and each notice''s official citation and file. Spain: BORME ''Situación concursal'' acts; `notice_found` (BORME doesn''t say when a procedure ends), `none_found` or `not_covered`. `covered_since` gives the first day loaded. Costs `STARTAPI_INSOLVENCY_UNITS` units (1).'
operationId: get_insolvency_v1_companies__country___identifier__insolvency_get
parameters:
- name: country
in: path
required: true
schema:
type: string
maxLength: 2
examples:
- FR
title: Country
- name: identifier
in: path
required: true
schema:
type: string
maxLength: 64
examples:
- '441639465'
title: Identifier
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Get Insolvency V1 Companies Country Identifier Insolvency Get
'401':
content:
application/json:
examples:
unauthorized:
value:
meta:
request_id: req_example
error:
code: unauthorized
message: This API key is unknown or revoked.
hint: Get a free key with POST /v1/keys, or call without a key for the keyless trial (20 units a day).
docs_url: https://api.fuentio.com/docs/errors#unauthorized
description: Unauthorized
'402':
content:
application/json:
examples:
quota_exceeded:
value:
meta:
request_id: req_example
error:
code: quota_exceeded
message: 'Quota used up: 20 of 20 units today.'
hint: Get a free key (100 units a month) with POST /v1/keys.
docs_url: https://api.fuentio.com/docs/errors#quota_exceeded
details:
limit: 20
used: 20
resets: '2026-10-06'
description: Payment Required
'429':
content:
application/json:
examples:
rate_limited:
value:
meta:
request_id: req_example
error:
code: rate_limited
message: 'Too many requests: the Trial (no key) plan allows 1 per second.'
hint: Retry after 0.4 seconds.
docs_url: https://api.fuentio.com/docs/errors#rate_limited
details:
retry_after: 1
description: Too Many Requests
'500':
content:
application/json:
examples:
internal_error:
value:
meta:
request_id: req_example
error:
code: internal_error
message: Something went wrong on our side.
hint: Retry later; quote the request_id if you contact support.
docs_url: https://api.fuentio.com/docs/errors#internal_error
description: Internal Server Error
'503':
content:
application/json:
examples:
upstream_unavailable:
value:
meta:
request_id: req_example
error:
code: upstream_unavailable
message: The official source (Annuaire des Entreprises (API Recherche d'entreprises)) is not answering right now.
hint: Retry in a minute.
docs_url: https://api.fuentio.com/docs/errors#upstream_unavailable
details:
source: fr_recherche_entreprises
reason: timeout
description: Service Unavailable
/v1/companies/{country}/{identifier}/address:
get:
tags:
- Screening
summary: Validate a company's registered address
description: 'France: the registered address checked against the Base Adresse Nationale (API Adresse, IGN): `validated` true only when the best answer has the record''s postal code and a score of at least 0.6; then the official form, BAN identifiers, coordinates, `precision` and `confidence`. `same_address.active_companies`: active companies Fuentio holds at the same postal code and street line. Spain: `validated: null` (the Spanish service isn''t available yet). Costs `STARTAPI_ADDRESS_UNITS` units (1).'
operationId: get_address_v1_companies__country___identifier__address_get
parameters:
- name: country
in: path
required: true
schema:
type: string
maxLength: 2
examples:
- FR
title: Country
- name: identifier
in: path
required: true
schema:
type: string
maxLength: 64
examples:
- '441639465'
title: Identifier
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Get Address V1 Companies Country Identifier Address Get
'401':
content:
application/json:
examples:
unauthorized:
value:
meta:
request_id: req_example
error:
code: unauthorized
message: This API key is unknown or revoked.
hint: Get a free key with POST /v1/keys, or call without a key for the keyless trial (20 units a day).
docs_url: https://api.fuentio.com/docs/errors#unauthorized
description: Unauthorized
'402':
content:
application/json:
examples:
quota_exceeded:
value:
meta:
request_id: req_example
error:
code: quota_exceeded
message: 'Quota used up: 20 of 20 units today.'
hint: Get a free key (100 units a month) with POST /v1/keys.
docs_url: https://api.fuentio.com/docs/errors#quota_exceeded
details:
limit: 20
used: 20
resets: '2026-10-06'
description: Payment Required
'429':
content:
application/json:
examples:
rate_limited:
value:
meta:
request_id: req_example
error:
code: rate_limited
message: 'Too many requests: the Trial (no key) plan allows 1 per second.'
hint: Retry after 0.4 seconds.
docs_url: https://api.fuentio.com/docs/errors#rate_limited
details:
retry_after: 1
description: Too Many Requests
'500':
content:
application/json:
examples:
internal_error:
value:
meta:
request_id: req_example
error:
code: internal_error
message: Something went wrong on our side.
hint: Retry later; quote the request_id if you contact support.
docs_url: https://api.fuentio.com/docs/errors#internal_error
description: Internal Server Error
'503':
content:
application/json:
examples:
upstream_unavailable:
value:
meta:
request_id: req_example
error:
code: upstream_unavailable
message: The official source (Annuaire des Entreprises (API Recherche d'entreprises)) is not answering right now.
hint: Retry in a minute.
docs_url: https://api.fuentio.com/docs/errors#upstream_unavailable
details:
source: fr_recherche_entreprises
reason: timeout
description: Service Unavailable
/v1/companies/{country}/{identifier}/vat:
get:
tags:
- Screening
summary: A company's EU VAT number, registration not checked
description: 'France: the VAT number the register publishes, or the one computed from the SIREN (standard key; a few companies have a letter key). `registration_checked` is always false: check the registration on the official VIES page (`check_url`). Spain: BORME doesn''t publish VAT numbers. Costs `STARTAPI_VAT_UNITS` units (1).'
operationId: get_vat_v1_companies__country___identifier__vat_get
parameters:
- name: country
in: path
required: true
schema:
type: string
maxLength: 2
examples:
- FR
title: Country
- name: identifier
in: path
required: true
schema:
type: string
maxLength: 64
examples:
- '441639465'
title: Identifier
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Get Vat V1 Companies Country Identifier Vat Get
'401':
content:
application/json:
examples:
unauthorized:
value:
meta:
request_id: req_example
error:
code: unauthorized
message: This API key is unknown or revoked.
hint: Get a free key with POST /v1/keys, or call without a key for the keyless trial (20 units a day).
docs_url: https://api.fuentio.com/docs/errors#unauthorized
description: Unauthorized
'402':
content:
application/json:
examples:
quota_exceeded:
value:
meta:
request_id: req_example
error:
code: quota_exceeded
message: 'Quota used up: 20 of 20 units today.'
hint: Get a free key (100 units a month) with POST /v1/keys.
docs_url: https://api.fuentio.com/docs/errors#quota_exceeded
details:
limit: 20
used: 20
resets: '2026-10-06'
description: Payment Required
'429':
content:
application/json:
examples:
rate_limited:
value:
meta:
request_id: req_example
error:
code: rate_limited
message: 'Too many requests: the Trial (no key) plan allows 1 per second.'
hint: Retry after 0.4 seconds.
docs_url: https://api.fuentio.com/docs/errors#rate_limited
details:
retry_after: 1
description: Too Many Requests
'500':
content:
application/json:
examples:
internal_error:
value:
meta:
request_id: req_example
error:
code: internal_error
message: Something went wrong on our side.
hint: Retry later; quote the request_id if you contact support.
docs_url: https://api.fuentio.com/docs/errors#internal_error
description: Internal Server Error
'503':
content:
application/json:
examples:
upstream_unavailable:
value:
meta:
request_id: req_example
error:
code: upstream_unavailable
message: The official source (Annuaire des Entreprises (API Recherche d'entreprises)) is not answering right now.
hint: Retry in a minute.
docs_url: https://api.fuentio.com/docs/errors#upstream_unavailable
details:
source: fr_recherche_entreprises
reason: timeout
description: Service Unavailable
/v1/companies/{country}/{identifier}/review:
get:
tags:
- Screening
summary: A review-ready report on a company (JSON + Markdown)
description: 'Identity (record, entity, links with reasons), reconciled facts with their sources, the last year''s changes and gaps, and every check at once: insolvency, sanctions screen, address, VAT. A module that fails is reported as such. `markdown` is the same report ready to paste; `sha256` is the hash of the JSON report. Needs an API key. Costs `STARTAPI_REVIEW_UNITS` units (8).'
operationId: get_review_v1_companies__country___identifier__review_get
parameters:
- name: country
in: path
required: true
schema:
type: string
maxLength: 2
examples:
- FR
title: Country
- name: identifier
in: path
required: true
schema:
type: string
maxLength: 64
examples:
- '441639465'
title: Identifier
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Get Review V1 Companies Country Identifier Review Get
'401':
content:
application/json:
examples:
unauthorized:
value:
meta:
request_id: req_example
error:
code: unauthorized
message: This API key is unknown or revoked.
hint: Get a free key with POST /v1/keys, or call without a key for the keyless trial (20 units a day).
docs_url: https://api.fuentio.com/docs/errors#unauthorized
description: Unauthorized
'402':
content:
application/json:
examples:
quota_exceeded:
value:
meta:
request_id: req_example
error:
code: quota_exceeded
message: 'Quota used up: 20 of 20 units today.'
hint: Get a free key (100 units a month) with POST /v1/keys.
docs_url: https://api.fuentio.com/docs/errors#quota_exceeded
details:
limit: 20
used: 20
resets: '2026-10-06'
description: Payment Required
'429':
content:
application/json:
examples:
rate_limited:
value:
meta:
request_id: req_example
error:
code: rate_limited
message: 'Too many requests: the Trial (no key) plan allows 1 per second.'
hint: Retry after 0.4 seconds.
docs_url: https://api.fuentio.com/docs/errors#rate_limited
details:
retry_after: 1
description: Too Many Requests
'500':
content:
application/json:
examples:
internal_error:
value:
meta:
request_id: req_example
error:
code: internal_error
message: Something went wrong on our side.
hint: Retry later; quote the request_id if you contact support.
docs_url: https://api.fuentio.com/docs/errors#internal_error
description: Internal Server Error
'503':
content:
application/json:
examples:
upstream_unavailable:
value:
meta:
request_id: req_example
error:
code: upstream_unavailable
message: The official source (Annuaire des Entreprises (API Recherche d'entreprises)) is not answering right now.
hint: Retry in a minute.
docs_url: https://api.fuentio.com/docs/errors#upstream_unavailable
details:
source: fr_recherche_entreprises
reason: timeout
description: Service Unavailable