Get todo statistics - GetBill Integrations

Get Todo Statistics

Authentication

This endpoint requires a valid Bearer token with the debts:read scope.

curl -X GET https://getbill.io/external-api/v1/todos/stats \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

Query Parameters

Parameter	Type	Description	Default
`period`	string	Time period filter	since_last_month

Response

{
  "stats": {
    "agreements": {
      "total": 25,
      "active": 15,
      "pending": 7,
      "overdue": 3
    },
    "debtor_requests": {
      "total": 8,
      "by_type": {
        "portal_dispute": 4,
        "hardship": 2,
        "payment_plan": 2
      }
    },
    "ai_detections": {
      "total": 12,
      "by_type": {
        "ai_dispute": 7,
        "objection": 5
      }
    },
    "blocking_disputes": {
      "total": 8,
      "by_status": {
        "suggested": 5,
        "validated": 2,
        "rejected": 1
      }
    },
    "non_blocking_disputes": {
      "total": 12,
      "by_status": {
        "suggested": 8,
        "validated": 3,
        "rejected": 1
      }
    },
    "total": {
      "all": 45
    }
  }
}

The blocking_disputes and non_blocking_disputes keys in the stats response are kept for backward compatibility. Use debtor_requests and ai_detections for new integrations.