---
title: "List Bill Drafts"
method: GET
path: "/coa/api/v1/bill-draft"
tags: ["Accounts Payable"]
---

# List Bill Drafts

`GET /coa/api/v1/bill-draft`

GET list (customer-scoped, AG Grid server-side: paginate / sort / filter) + POST UI upload.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

- PaginatedBillDraftReadList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` BillDraftRead[], required
    - `id` integer, required
    - `customer` integer, required
    - `entity` integer, nullable
    - `source` 'email' | 'ui_upload', required — * `email` - Email * `ui_upload` - UI Upload
    - `source_file` integer, nullable
    - `sender_email` string, nullable
    - `recipient_alias` string, nullable
    - `email_subject` string, nullable
    - `status` 'parsing' | 'parse_failed' | 'not_a_bill' | 'needs_review' | 'unassigned' | 'ready' | 'promoted' | 'discarded', required — * `parsing` - Parsing * `parse_failed` - Parse Failed * `not_a_bill` - Not a Bill * `needs_review` - Needs Review * `unassigned` - Unassigned * `ready` - Ready * `promoted` - Promoted * `discarded` - Discarded
    - `parse_error` string, nullable
    - `extracted_vendor_name` string, nullable
    - `extracted_bill_number` string, nullable
    - `extracted_bill_date` string, date, nullable
    - `extracted_due_date` string, date, nullable
    - `extracted_currency` string, nullable
    - `extracted_total_amount` number, double, nullable
    - `extracted_line_items` unknown
    - `field_confidence` unknown
    - `resolved_vendor` integer, nullable
    - `dedup_hash` string, nullable, required
    - `promoted_bill` integer, nullable, required
    - `discard_reason` string, nullable
    - `created_at` string, date-time, required
    - `created_by` integer, nullable, required
    - `last_modified_at` string, date-time, required

---

[API](https://skmtc.net/campfire/apis/campfire-developer-apis.md) · [All operations](https://skmtc.net/campfire/apis/campfire-developer-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/campfire/campfire-developer-apis/revisions/6945ebc3180e/schema)