# Listar oportunidades

> plazbot opportunities list: oportunidades (deals) del workspace, filtrables por pipeline, fase, contacto o vista.

Fuente: https://developers.plazbot.com/cli/opportunities/list/

### Listar oportunidades

Muestra las oportunidades (deals) del workspace, de la más reciente a la más antigua. Puedes filtrar por pipeline, por fase del pipeline, por contacto o aplicar los filtros de una vista guardada. También funciona como `plazbot deals list`.

```bash
plazbot opportunities list [options]
```

### Parámetros

| Parámetro | Flag | Requerido | Descripción |
|-----------|------|-----------|-------------|
| Pipeline | `--pipeline <pipelineId>` | No | Solo las oportunidades de este pipeline. Los IDs salen de [`plazbot workspace show pipelines`](https://developers.plazbot.com/cli/workspace). |
| Fase | `--stage <stageId>` | No | Solo las oportunidades en esta fase del pipeline. |
| Contacto | `-c, --contact <contactId>` | No | Solo las oportunidades de un contacto. |
| Vista | `--view <viewId>` | No | Aplica los filtros de una vista guardada ([`plazbot views list`](https://developers.plazbot.com/cli/views/list)). |
| Límite | `--limit <n>` | No | Se detiene al juntar al menos N elementos (páginas completas de la API). Por defecto `50`. |
| Cursor | `--cursor <token>` | No | Continúa desde el `nextCursor` de una llamada anterior. |
| Todo | `--all` | No | Trae todas las páginas, hasta 5000 elementos (ignora `--limit`). |
| Workspace | `-w, --workspace <id>` | No | Workspace donde se ejecuta. Por defecto, el activo. |
| Zona | `-z, --zone <zone>` | No | `LA` o `EU`. Por defecto, la zona de la sesión. |
| JSON | `--json` | No | Imprime el resultado como JSON. |

Con `--json` la salida es siempre `{ "data": [...], "nextCursor": "..." | null }`. Si `nextCursor` no es `null`, pásalo a `--cursor` para traer la página siguiente. Más detalles en [Scripting y agentes de IA](https://developers.plazbot.com/cli/ia/scripting).

### Ejemplos

```bash
# Últimas oportunidades
plazbot opportunities list

# Todas las oportunidades de un pipeline, en JSON
plazbot opportunities list --pipeline pip_AbcDef123 --all --json

# Oportunidades de un contacto
plazbot opportunities list -c con_AbcDef123
```

### Resultado

```text
Opportunities (2)
────────────────────────────────────────
┌────────────────────────────┬──────────────────┬────────┬────────────────────────────┬────────────────────────────┬──────────┬──────────────────┐
│ ID                         │ Name             │ Amount │ Contact                    │ Stage                      │ Win/loss │ Created          │
├────────────────────────────┼──────────────────┼────────┼────────────────────────────┼────────────────────────────┼──────────┼──────────────────┤
│ opp_AbcDef123              │ Plan anual ACME  │ 1500   │ con_AbcDef123              │ pst_AbcDef123              │ 0        │ 2026-08-30 12:45 │
└────────────────────────────┴──────────────────┴────────┴────────────────────────────┴────────────────────────────┴──────────┴──────────────────┘
```

| Columna | Descripción |
|---------|-------------|
| ID | ID de la oportunidad (`opp_...`). |
| Name | Nombre de la oportunidad. |
| Amount | Monto estimado. |
| Contact | Contacto asociado (vacío si no tiene). |
| Stage | Fase del pipeline. |
| Win/loss | Estado de cierre (`winLossStatus`): `0` abierta. |
| Created | Fecha de creación (UTC). |

### Salida JSON

```json
{
"data": [
  {
    "id": "opp_AbcDef123",
    "name": "Plan anual ACME",
    "opportCode": "OP000005",
    "description": "",
    "amount": 1500,
    "contactId": "con_AbcDef123",
    "assignedComercialId": "usr_AbcDef123",
    "pipelineId": "pip_AbcDef123",
    "stageId": "pst_AbcDef123",
    "expirationDate": "2026-09-14T00:00:00",
    "opportStatus": 1,
    "winLossStatus": 0,
    "finalAmount": 0,
    "activities": [],
    "files": [],
    "creationDate": "2026-08-30T12:45:19.615Z"
  }
],
"nextCursor": null
}
```

### Errores comunes

| Mensaje | Causa | Solución |
|---------|-------|----------|
| `You are not signed in.` | No hay sesión. | Ejecuta [`plazbot login`](https://developers.plazbot.com/cli/login). |
| `Invalid --limit "x".` | `--limit` no es un entero positivo. | Usa un número, o `--all`. |