*API REST › Objetos › CRM*

# Embudo

> Embudo del CRM con sus etapas ordenadas y, opcionalmente, el recuento y el valor total de sus oportunidades.

Un embudo del CRM con sus etapas ordenadas y, opcionalmente, el número y el valor total de sus oportunidades. Las oportunidades avanzan por sus etapas. Necesita el add-on de CRM: sin él la respuesta es 402 `addon_required`.

Esquemas: `PipelineDto`

## Atributos

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `pipelineId` | string |  |
| `name` | string |  |
| `slug` | string |  |
| `isDefault` | boolean |  |
| `isArchived` | boolean |  |
| `totalOpportunities` | integer |  |
| `totalValue` | string |  |
| `stages` | object[] |  |
| `stages.stageId` | string |  |
| `stages.name` | string |  |
| `stages.order` | integer |  |
| `stages.type` | string |  `open`, `won`, `lost` |
| `stages.probability` | number |  |
| `stages.isDefault` | boolean |  |
| `createdAt` | string<date-time> |  |
| `updatedAt` | string<date-time> |  |

## Ejemplo

*Pipeline · Generado a partir del esquema*

```json
{
  "pipelineId": "string",
  "name": "Example",
  "slug": "string",
  "isDefault": true,
  "isArchived": true,
  "totalOpportunities": 1,
  "totalValue": "1234.50",
  "stages": [
    {
      "stageId": "string",
      "name": "Example",
      "order": 1,
      "type": "open",
      "probability": 1,
      "isDefault": true
    }
  ],
  "createdAt": "2026-09-01T08:00:00Z",
  "updatedAt": "2026-09-01T08:00:00Z"
}
```

## Lo devuelven

- [`GET /api/v1/crm/pipelines`](https://docs.filmo.io/es/rest-api/endpoint-reference/crm/list-pipelines) — Listar embudos
- [`GET /api/v1/crm/pipelines/{pipelineId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/crm/get-a-pipeline) — Obtener un embudo

## Lo modifican

Ninguna operación.

---

URL canónica: https://docs.filmo.io/es/rest-api/objects/pipeline  
Última actualización: 2026-10-25