---
title: API REST resource (/v1)
description: Surface REST classique d'Insourcia — un endpoint par ressource, verbes HTTP standards.
---

L'API REST `/v1` suit la convention resource-style. Un endpoint par ressource, verbes HTTP standards.

## Endpoints

| Méthode | Path | Description |
|---|---|---|
| `GET` | `/v1/me` | Info de la clé API courante |
| `GET` | `/v1/companies/search?q=...` | Recherche d'entreprises |
| `GET` | `/v1/companies/{siren}` | Fiche entreprise |
| `GET` | `/v1/companies/{siren}/financials` | Données financières (P&L, bilan) |
| `GET` | `/v1/companies/{siren}/directors` | Liste des dirigeants |
| `GET` | `/v1/announcements/search?type=vente` | Annonces BODACC |

Référence interactive complète sur [**`/docs`**](/docs).

## Authentification

```bash
curl https://api.insourcia.io/v1/me \
  -H "Authorization: Bearer isk_xxx"
```

Génère ta clé sur [`app.insourcia.io/settings`](https://app.insourcia.io/settings).

## Format de réponse

Brut, sans envelope :

```json
{
  "siren": "552120222",
  "denomination": "VINCI",
  "code_ape": "7010Z",
  ...
}
```

Erreurs :

```json
{
  "error": "not_found",
  "message": "Aucune entreprise trouvée pour le SIREN 000000000."
}
```

## Quand utiliser REST plutôt que Tools RPC

- Tu écris du code backend traditionnel (Node, Python, Go) et préfères des paths intuitifs
- Tu fais de l'enrichment lead-by-lead (un endpoint par lookup)
- Ton client HTTP / CRM attend des réponses sans envelope

Pour les agents IA et automations no-code, voir [Tools RPC](/docs/guides/tools-rpc).