canonical: https://jentic.com/apis/nogogo.fr/nogogo

# Nogogo Fr API Nogogo - Fiabilité des entreprises françaises

The Nogogo API looks up French companies by name or SIREN number and returns an assessment of their apparent reliability built from public data. For a given SIREN it exposes the company record, its history, financials, legal events, and directors, and a bulk endpoint checks up to 100 SIRENs in one request. A separate B2B barometer reports reliability trends by period, with sector, region, failure-signal, and insight breakdowns plus a PDF edition.

## For AI agents

Search French companies, pull a company's financials, legal events, history, and directors by SIREN, check up to 100 SIRENs in bulk, and read the periodic B2B barometer by sector and region.

## Scope

Does not file company documents, issue credit ratings or insurance, or cover companies outside France. Use for researching the apparent reliability of French companies from public data only.

## Capabilities

- Search French companies by name or keyword with the q parameter and a result limit
- Pull a company's profile, financials, history, and legal events by its SIREN number
- List a company's directors, optionally including inactive ones, and look up one director by hash_identite
- Check reliability data for up to 100 SIRENs in a single bulk request
- Read the B2B barometer for a period with sector, region, and failure-signal breakdowns
- Download the barometer for a period as a PDF report

## Use cases

### Supplier due diligence by an agent through Jentic

A procurement agent vetting a new French supplier searches Jentic for a company lookup, gets the Nogogo search operation and its schema, and finds the supplier's SIREN from a name query. It then calls the financials, legal-events, and directors endpoints for that SIREN and summarises anything that warrants a closer look before the contract is signed.

Example prompt: Call GET `/api/v1/companies/search` with q='Boulangerie Martin Lyon', take the SIREN of the best match, then call GET `/api/v1/companies/{siren}/legal-events` and GET `/api/v1/companies/{siren}/financials` and summarise the results

### Portfolio screening in bulk

Credit and accounts-receivable teams that track many French customers can refresh them together instead of one by one. POST `/api/v1/companies/bulk` takes a sirens array of 1 to 100 entries, so a nightly job can re-check a customer book in batches and flag changes.

Example prompt: Call POST `/api/v1/companies/bulk` with a sirens array of 100 customer SIREN numbers and list the companies whose data shows new legal events

### Director background checks

Knowing who runs a company matters for onboarding and compliance reviews. GET `/api/v1/companies/{siren}/directors` lists the directors, with include_inactive_directors to show former ones, and GET `/api/v1/directors/{hash_identite}` returns the detail for one director so reviewers can see the other companies linked to them.

Example prompt: Call GET `/api/v1/companies/{siren}/directors` with include_inactive_directors=true, then call GET `/api/v1/directors/{hash_identite}` for each active director

### B2B reliability trend reporting

Economists and risk teams following French business health can read the Nogogo B2B barometer by period. The summary, sectors, regions, failure-signals, and insights endpoints break down each period, the history endpoint takes a months parameter for trend lines, and the PDF endpoint returns a ready-made report.

Example prompt: Call GET `/api/v1/barometer/latest`, then call GET `/api/v1/barometer/{period}/sectors` for that period with order and limit set to return the ten weakest sectors

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/api/v1/companies/search` | Search French companies |
| GET | `/api/v1/companies/{siren}` | Get a company by SIREN |
| GET | `/api/v1/companies/{siren}/financials` | Get a company's financials |
| GET | `/api/v1/companies/{siren}/legal-events` | Get a company's legal events |
| GET | `/api/v1/companies/{siren}/directors` | List a company's directors |
| POST | `/api/v1/companies/bulk` | Look up up to 100 SIRENs at once |
| GET | `/api/v1/barometer/latest` | Get the latest B2B barometer |

## Key resources

- **Companies** — Search companies and read a company's profile, history, financials, legal events, and directors by SIREN; bulk lookup for up to 100 SIRENs
- **Directors** — Read one director's detail by hash_identite
- **B2B barometer** — Latest, historical, and per-period barometer data with summary, sector, region, failure-signal, insight, and PDF views

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 51 / 100
- **Maturity:** Foundational
- **Dimensions:**
  - Foundational Compliance: 99 / 100
  - Developer Experience & Jentic Compatibility: 62 / 100
  - AI-Readiness & Agent Experience: 43 / 100
  - Agent Usability: 94 / 100
  - Security: 50 / 100
  - AI Discoverability: 21 / 100
- **View full report:** https://jentic.com/apis/nogogo.fr/nogogo/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring Nogogo by hand means getting an API key from the customer area, sending it in the X-API-Key header, and handling validation errors on SIREN and period inputs yourself. Through Jentic you install once, import Nogogo from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** Nogogo puts the SIREN in the URL path (`/api/v1/companies/{siren}/...`), so a rule can pin your agent to one company's records and the operations you pick. You choose the operations it may call, so wider ones like bulk lookups or director detail are not included unless you add them.
- **Credential handling:** Your Nogogo API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'check a French company's legal events' or 'search French companies', and Jentic returns the matching Nogogo operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Pappers API** — French company registry data, filings, and officers
- **OpenCorporates API** — Company records across many jurisdictions
- **OpenAI API** — Language models to summarise Nogogo company findings into a due-diligence note

## FAQ

### What authentication does the Nogogo API use?

Per its OpenAPI spec, the Nogogo API authenticates with an API key sent in the `X-API-Key` header, available in the Nogogo customer area after you create an account. Through Jentic, the key is stored encrypted by your own Jentic One instance and injected at call time, so your agent never handles it.

### Can I check many French companies at once with the Nogogo API?

Yes. POST `/api/v1/companies/bulk` takes a sirens array with between 1 and 100 SIREN numbers per request, so larger lists can be sent in batches of 100.

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

The OpenAPI spec does not specify rate limits. Check https://nogogo.fr for the limits that apply to your plan.

### How do I look up a French company's legal events with the Nogogo API through Jentic?

Install Jentic One with `curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh`, add Nogogo from the Jentic API Directory, and store your X-API-Key value. Your agent searches for 'search French companies' to find the SIREN, then calls GET `/api/v1/companies/{siren}/legal-events.` To run it on your own infrastructure, install Jentic One from its GitHub repo.

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

Yes. For example, write a rule that allows GET `/api/v1/companies/search` plus the company detail, financials, and legal-events reads, and leaves out bulk lookups and director detail. The agent can then research single companies but cannot run large bulk checks or pull director records, and each call it makes is checked against that rule.

### Is there a Nogogo MCP server?

You don't need an MCP server to give your agent the Nogogo API. Jentic connects it directly from the API Directory: import it, store your API key once, and your agent calls it, discovering operations on demand rather than loading tool definitions up front.

### What does the Nogogo B2B barometer contain?

The barometer endpoints report on a given period: GET `/api/v1/barometer/{period}/summary` for the overview, /sectors and /regions for rankings with limit and order parameters, /failure-signals filtered by scope_type and scope_key, /insights, and /pdf for a downloadable report. GET `/api/v1/barometer/history` takes a months parameter for trends.