> ## Documentation Index
> Fetch the complete documentation index at: https://help.withallo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Vue d'ensemble

> Accedez aux deals synchronises depuis vos integrations CRM

L'API Deals vous donne un acces en lecture seule aux deals synchronises depuis vos integrations CRM.

Les deals sont synchronises depuis les integrations et ne peuvent pas etre crees, mis a jour ou supprimes via l'API.

## Scopes

| Scope      | Acces                           |
| ---------- | ------------------------------- |
| `CRM_READ` | Obtenir et rechercher des deals |

## Associations

* **Deal → Company** : Un deal peut etre associe a une entreprise (`company_id`)
* **Deal → Person** : Un deal peut etre lie a une personne via la synchronisation de l'integration

## Recherche

Les deals peuvent etre recherches via `POST /v2/api/crm/deals/search` avec une recherche en texte integral et un filtre `stage`.

## Endpoints

<CardGroup cols={1}>
  <Card title="Obtenir un deal" href="/fr/v2/api-reference/crm/get-deal">Obtenir un deal par ID</Card>
  <Card title="Rechercher des deals" href="/fr/v2/api-reference/crm/search-deals">Rechercher des deals par mot-cle</Card>
</CardGroup>