canonical: https://jentic.com/apis/api.decidento.com/decidento

# Decidento API

Jentic publishes the only available OpenAPI specification for Decidento API, keeping it validated and agent-ready. The Decidento API delivers French B2B sales-intelligence data: company firmographics, business signals (executive moves, fundraising, hiring spikes, M&A), and curated articles from the French business press. Sales and marketing teams use it to build prospect lists, monitor accounts for trigger events, and enrich CRM records with verified company data keyed on SIREN/CCCID identifiers. Authentication uses paired X-AUTH-TOKEN and X-AUTH-ID headers issued by Decidento.

## For AI agents

Pull French B2B company profiles, business signals, and sector news from Decidento. Authenticated via paired X-AUTH-TOKEN and X-AUTH-ID headers.

## Scope

Does not handle non-French companies, contact-level person data, or financial-statement filings - use for French B2B firmographics, business signals, and press articles only.

## Capabilities

- Search French companies by sector, region, headcount, and revenue via /companies
- Resolve a company by CCCID via `/companies/{companyCccid}/v2` or by collection of SIRENs
- Stream business signals such as fundraising and hiring via /signals
- Pull curated articles from the French business press via /articles
- Fetch a collection of articles, companies, or signals by ID list in one call
- Monitor accounts for trigger events to feed sales-cadence tools

## Use cases

### Prospect List Building for French B2B

Build a targeted prospect list of French companies that match a sector, headcount band, and region. /companies and `/companies/v2` accept structured filters and return paginated results that can feed directly into a CRM or outbound sequencer. Useful for SDR teams targeting the French market who need richer firmographics than open Sirene data alone provides.

Example prompt: Search `/companies/v2` for French SaaS companies between 50 and 200 employees in Île-de-France and return the first 100 results with SIREN, name, and revenue band

### Trigger-Event Sales Intelligence

Monitor accounts for buying signals - fundraising rounds, executive moves, hiring surges, M&A - so reps can reach out at the right moment. /signals returns recent business events with the company id, signal type, and source link. Pair it with `/signals/collection` to refresh signals for a watchlist of target accounts in one call. This is the canonical use case Decidento was built for.

Example prompt: Pull /signals filtered to type=fundraising and date>=2025-01-01 for a watchlist of 50 SIRENs and surface any new events to the sales channel

### Article-Based Account Briefings

Generate an account briefing before a sales call by pulling the latest curated articles about the company. /articles supports search by company id and date, and `/articles/collection` accepts an array of article ids for batch retrieval. Reps walk into meetings with a one-page summary of recent press coverage rather than skimming Google News.

Example prompt: Search /articles for company id 12345 in the last 30 days and produce a 5-bullet pre-meeting briefing

### AI Agent CRM Enrichment

An AI agent uses Decidento via Jentic to enrich newly-created CRM contacts with company firmographics and recent signals. The agent searches Jentic by intent, loads the schema, and executes the call with the SIREN supplied at runtime. Jentic injects the X-AUTH-TOKEN and X-AUTH-ID headers so the agent never holds the credentials.

Example prompt: Search Jentic for 'look up French company by SIREN', load the schema, and resolve a list of 25 SIRENs into Decidento company records

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/companies` | Search French companies with parameters |
| GET | `/companies/{companyCccid}/v2` | Look up a company by CCCID |
| GET | `/companies/collection/v2` | Resolve a collection of companies by SIREN |
| GET | `/signals` | Get recent business signals |
| GET | `/articles` | Search recent articles |
| GET | `/articles/collection` | Fetch a collection of articles by ID |

## Key resources

- **Articles** — Curated French business press articles, searchable and retrievable in batches
- **Companies** — French company firmographics keyed on SIREN and CCCID identifiers
- **Signals** — Business trigger events such as fundraising, hiring, and executive moves

## Why Jentic

- **Setup:** Wiring the Decidento API by hand means handling its paired X-AUTH-TOKEN and X-AUTH-ID headers and mapping the company, signal, and article routes yourself. Through Jentic you install once, import Decidento from the API Directory, store the credentials once, and your agent calls it.
- **Permission scoping:** Decidento puts the company id in the URL path (`/companies/{companyCccid}/v2`), so a rule can pin your agent to one company: it can read that company's firmographics and nothing else. You choose the operations it may call, so broad signal and article searches are only included if you add them.
- **Credential handling:** Your Decidento X-AUTH-TOKEN and X-AUTH-ID are stored once, encrypted, by your own Jentic One instance and injected as headers at execution time. They never enter the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'find French companies by SIREN' or 'list recent fundraising signals', and Jentic returns the matching Decidento operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Clearbit API** — Clearbit provides global B2B firmographics and contact enrichment, weaker on French SIREN coverage.
- **HubSpot Account Info API** — HubSpot CRM is a common destination for Decidento-enriched company and signal data.
- **Salesforce API** — Salesforce Sales Cloud is the canonical destination for Decidento-enriched account data in larger French enterprises.

## FAQ

### Why is there no official OpenAPI spec for Decidento API?

Decidento does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Decidento API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

### What authentication does the Decidento API use?

Decidento uses paired API-key headers: X-AUTH-TOKEN and X-AUTH-ID, both issued by Decidento to your account. Both headers must be present on every request. Jentic stores the pair in the encrypted vault and injects them automatically so agents call the API without ever seeing the raw values.

### Can I look up a company by SIREN through the Decidento API?

Yes - `/companies/collection/v2` accepts a list of SIREN identifiers and returns matching company records, while `/companies/{companyCccid}/v2` resolves a single company by Decidento's CCCID. Use the collection endpoint when batch-enriching CRM records to minimise the number of round trips.

### What are the rate limits for the Decidento API?

Decidento applies plan-based rate limits that are not declared in the spec. Treat the API as moderate-throughput: batch IDs into /collection endpoints rather than calling per-record loops. If you receive a 429 response, back off and retry - Decidento returns a Retry-After header on throttled responses.

### How do I monitor companies for fundraising signals through Jentic?

Run `pip install jentic`, search for 'monitor French company signals', load the GET /signals schema, and pass the company ids and signal type. Schedule the agent to run daily and pipe new signals into Slack or your CRM. Jentic handles the X-AUTH-TOKEN and X-AUTH-ID injection on every call.

### Does the Decidento API cover companies outside France?

No. Decidento focuses on French firmographics, French press coverage, and business signals tied to French entities identified by SIREN or CCCID. For pan-European or US firmographic data, use a different provider - Decidento will return empty results for non-French queries.

### Can I limit what my agent is allowed to do with the Decidento API?

Yes. Because you run Jentic One yourself, your own rules decide which Decidento operations and credentials the agent may use, so you can allow just company lookups like `/companies/{companyCccid}/v2` while excluding broad /signals and /articles searches. Since the company id sits in the URL path, a rule can pin the agent to a single company so it reads that company's firmographics and nothing else. Your X-AUTH-TOKEN and X-AUTH-ID stay under your control and are only applied to the calls you permit.