Get a todo - GetBill Integrations

Get Single Todo

Authentication

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

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

Path Parameters

Parameter	Type	Description
`type`	string	Todo type: `agreement`, `debtor_request`, or `ai_detection`
`id`	string	Encrypted todo ID (for agreements: debt ID; for disputes: dispute ID)

Response

{
  "todo": {
    "id": "enc_234",
    "type": "debtor_request",
    "status": "suggested",
    "title": "Payment Already Made",
    "description": "Customer claims payment was already made",
    "theme": "Payment Issues",
    "detected_content": "I already paid this bill last month",
    "ai_confidence": 85,
    "source": "portal",
    "admin_notes": null,
    "debt": {
      "id": "enc_456",
      "reference": "INV-2024-001",
      "amount": 1500.00,
      "status": "status.default.on_hold",
      "status_id": "enc_2"
    },
    "followup_id": null,
    "call_id": null,
    "audio_url": null,
    "pdf_url": null,
    "media_urls_expire_at": null,
    "created_at": "2024-01-15T10:30:00+00:00",
    "reviewed_at": null,
    "updated_at": "2024-01-15T11:00:00+00:00",
    "collection_paused": true
  }
}

When audio_url or pdf_url are present, they are pre-signed S3 URLs valid for 1 hour. The media_urls_expire_at field indicates when they expire.