Fuentio Watches API
The watches API from Fuentio — 3 operation(s) for watches.
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-watches-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 Watches 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: watches
paths:
/v1/watches:
get:
tags:
- watches
summary: Your watches
description: The key's watches. Free.
operationId: get_watches_route_v1_watches_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
additionalProperties: true
type: object
title: Response Get Watches Route V1 Watches Get
post:
tags:
- watches
summary: 'Watch a company: changes are POSTed to your endpoint, signed'
description: 'Watches one Fuentio entity. When it changes, Fuentio POSTs the changes (as `what_changed` returns them, with gaps) to your https `callback_url`, signed: `Fuentio-Signature: t=,v1=.'')>`; reject `t` older than 5 minutes. `Fuentio-Delivery-Id` identifies retries. Retries: 1 min, 5 min, 30 min, 2 h, 12 h. The `signing_secret` is shown once. An API key is required; private or local callback addresses are refused. Costs 1 unit.'
operationId: post_watch_v1_watches_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/WatchRequest'
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
/v1/watches/{watch_id}:
delete:
tags:
- watches
summary: Stop a watch
description: Free.
operationId: delete_watch_route_v1_watches__watch_id__delete
parameters:
- name: watch_id
in: path
required: true
schema:
type: string
maxLength: 40
title: Watch Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Delete Watch Route V1 Watches Watch Id Delete
/v1/watches/{watch_id}/deliveries:
get:
tags:
- watches
summary: A watch's delivery log
description: 'Every delivery: status, attempts, next try, last HTTP status or error. Free.'
operationId: get_deliveries_v1_watches__watch_id__deliveries_get
parameters:
- name: watch_id
in: path
required: true
schema:
type: string
maxLength: 40
title: Watch Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Get Deliveries V1 Watches Watch Id Deliveries Get
components:
schemas:
WatchRequest:
properties:
entity_id:
type: string
maxLength: 20
title: Entity Id
description: A Fuentio entity ID.
examples:
- fu_7K3M9Q2XH4PZ
callback_url:
type: string
maxLength: 500
title: Callback Url
description: Your https endpoint. Each POST is signed (Fuentio-Signature header).
examples:
- https://hooks.example.com/fuentio
additionalProperties: false
type: object
required:
- entity_id
- callback_url
title: WatchRequest