CRM

Listar embudos

Devuelve los embudos de la cuenta con sus etapas ordenadas. Úsalo para resolver pipelineId y stageId del listado de oportunidades sin adivinar identificadores.

GET
/api/v1/crm/pipelines

Ejemplos de petición

curl https://app.filmo.io/api/v1/crm/pipelines \
  --header "Authorization: Bearer $FILMO_API_KEY"
{
  "data": [
    {
      "pipelineId": "pipeline_9f3a2b",
      "name": "Example pipeline",
      "slug": "Example slug",
      "isDefault": true,
      "isArchived": true,
      "totalOpportunities": 1,
      "totalValue": "120.00",
      "stages": [
        {
          "stageId": "stage_9f3a2b",
          "name": "Example stage",
          "order": 1,
          "type": "open",
          "probability": 1,
          "isDefault": true
        }
      ],
      "createdAt": "2026-09-01T10:00:00+02:00",
      "updatedAt": "2026-09-01T10:00:00+02:00"
    }
  ]
}

Generado a partir del esquema

NO pagina: una cuenta tiene un puñado de embudos y se devuelven todos.

Autorizaciones

Clave de API como Bearer, con el permiso de abajo. crm:read

Parámetros de consulta

includeArchivedbooleanpredeterminado:false

Si es "true", se incluyen también los embudos archivados. Por defecto solo se devuelven los activos.

Respuesta

application/json

Respuesta correcta.

Esquema de la respuesta: PipelineDto

Sobre: PipelineItems. meta.warnings solo aparece cuando la operación está obsoleta.

Cabeceras: X-Request-Id · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset

dataobject[]

Mostrar atributos hijos
data.pipelineIdstring

data.namestring

data.slugstring

data.isDefaultboolean

data.isArchivedboolean

data.totalOpportunitiesinteger

data.totalValuestring

data.stagesobject[]

Mostrar atributos hijos
data.stages.stageIdstring

data.stages.namestring

data.stages.orderinteger

data.stages.typestring

Opciones disponibles: open, won, lost

data.stages.probabilitynumber

data.stages.isDefaultboolean

data.createdAtstring<date-time>

data.updatedAtstring<date-time>

metaobject

Información adicional sobre la respuesta.

Mostrar atributos hijos
meta.warningsobject[]

Avisos del ciclo de vida; solo aparecen cuando la operación está obsoleta.

Mostrar atributos hijos
meta.warnings.codestring

Código de aviso estable.

Opciones disponibles: deprecated

meta.warnings.messagestring

Para personas: qué está obsoleto, hasta cuándo y qué usar.

meta.warnings.sunsetstring

Día (YYYY-MM-DD) en que la operación deja de estar disponible.

meta.warnings.replacementstring | null

operationId de la operación que hay que usar en su lugar, o null si no hay ninguna.

Errores

EstadoCódigosSignificado
400validation_errorConsulta o cuerpo mal formados. errors[] enumera cada campo erróneo con su código estable.
402addon_requiredEl plan de la cuenta no incluye el add-on que necesita esta operación; requiredAddon lo nombra.

401, 403, 429, 500 los puede devolver cualquier operación. Errores

Obsolescencia

Esta operación no está obsoleta. Las obsolescencias se anuncian con la cabecera Deprecation y una fecha de retirada. Política de versiones

  • CRM

    Embudo

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