Listar oportunidades

GET

/api/deals

Paginación, filtros y búsqueda. Cada fila trae el estado de seguimiento calculado al vuelo: next_follow_up_date (próxima tarea abierta con fecha de hoy en adelante), has_overdue / overdue_count / oldest_overdue_date (tareas abiertas vencidas) y open_tasks. Las fechas de seguimiento son días de negocio (YYYY-MM-DD) en la zona horaria de la cuenta.

Solicitud

Parámetros de consulta

Parámetros de Header

Respuestas

🟢200

application/json

Bodyapplication/json

🟠400ForbiddenAccess

🟠403ForbiddenAccess

🟠429TooManyRequests

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

curl --location 'https://app.mgpanel.co/api/deals?page=&limit=&status=&pipelineId=&stageId=&clientId=&search=&has_overdue=&due_before=&due_after=&sort=' \
--header 'X-Account-Nick: {{ACCOUNT_NICK}}' \
--header 'Authorization: Bearer {{API_KEY}}' \
--header 'Content-Type: application/json'

Ejemplo de Respuesta

200 - Éxito

{
    "success": true,
    "deals": [
        {
            "deal_id": "6a75270628689b3abb285300",
            "name": "Saul (Fraynd) — reactivación",
            "status": 1,
            "status_label": "active",
            "client_id": "63d5375f2ca4e6e967444bf2",
            "client_name": "Saúl Fraynd",
            "pipeline_id": "67f848e074f86048d6e01fa1",
            "pipeline_name": "Ventas",
            "stage_id": "67f848e074f86048d6e01fa2",
            "stage_name": "Nuevo",
            "value": {
                "expected": 0,
                "currency": "USD"
            },
            "next_follow_up_date": "2026-10-02",
            "next_follow_up_note_id": "6abae44bd1b204c516601833",
            "has_overdue": false,
            "overdue_count": 0,
            "oldest_overdue_date": null,
            "open_tasks": 1,
            "date": "2026-08-07T00:29:58.808Z"
        }
    ],
    "pagination": {
        "page": 1,
        "limit": 20,
        "total": 1,
        "pages": 1
    },
    "today": "2026-09-30",
    "timezone": "America/Panama"
}

Modificado en 2026-10-08 13:23:32

Listar etiquetas CRM

Crear oportunidad