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.
openapi: 3.2.0
info:
title: Fuentio Issues 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: Issues
paths:
/v1/issues:
post:
tags:
- Issues
summary: Report a wrong or missing answer
description: Stores the report for review. Each one is checked against the official source; a confirmed one becomes a test case. Needs an API key; at most 20 reports per key per day. Free.
operationId: post_issue_v1_issues_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/IssueRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'401':
description: Unauthorized
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
'402':
description: Payment Required
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'
'429':
description: Too Many Requests
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
'500':
description: Internal Server Error
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
'503':
description: Service Unavailable
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
components:
schemas:
IssueRequest:
properties:
subject:
type: string
maxLength: 80
title: Subject
description: 'What the issue is about: a Fuentio entity ID, a record ID or a tool name.'
examples:
- FR-SIREN-441639465
category:
type: string
enum:
- wrong_data
- wrong_link
- missing_data
- wrong_status
- other
title: Category
examples:
- wrong_status
message:
type: string
maxLength: 2000
title: Message
description: What you expected and what you got (10 to 2,000 characters).
examples:
- The company is shown active but BODACC published a liquidation in 2026.
additionalProperties: false
type: object
required:
- subject
- category
- message
title: IssueRequest