# List draft invoice histories

Retrieve draft invoice histories with basic pagination support

Provides paginated access to draft invoice history records.

Real Example:
bash
curl --location 'https://{{host}}/v1/draft_invoice_histories' \
--header 'Authorization: bearer {{token}}' \
--header 'Content-Type: application/json' \
--data '{
  "pageSize": 25,
  "page": 0
}'

Endpoint: POST /gql/v1/draft_invoice_histories
Version: 1.0.0
Security: BearerAuth

## Request fields (application/json):

  - `pageSize` (integer)
    Maximum number of records to return

  - `page` (integer)
    Number of records to skip for pagination

## Response 200 fields (application/json):

  - `draftInvoices` (array)

  - `draftInvoices.clientId` (integer)
    Client identifier
    Example: 7720

  - `draftInvoices.invoiceId` (integer)
    Invoice identifier
    Example: 125890

  - `draftInvoices.jobId` (integer)
    Associated job/project identifier
    Example: 2514

  - `draftInvoices.client` (object)
    Client summary information

  - `draftInvoices.client.active` (boolean)
    Example: true

  - `draftInvoices.client.clientRef` (string)
    Example: "TF-2024-789"

  - `draftInvoices.client.name` (string)
    Example: "TechFlow Enterprises"

  - `draftInvoices.client.pmsRef` (string)
    Example: "240815"

  - `draftInvoices.draftInvoice` (object)
    Draft invoice metadata

  - `draftInvoices.draftInvoice.approvedAt` (string)
    Example: "2024-03-15T14:32:18+00:00"

  - `draftInvoices.draftInvoice.arTranId` (integer)
    Example: 125890

  - `draftInvoices.draftInvoice.approverStaffId` (integer)
    Example: 301

  - `draftInvoices.draftInvoice.approvedByStaffId` (integer)
    Example: 301

  - `draftInvoices.draftInvoice.invoiceId` (integer)
    Example: 125890

  - `draftInvoices.draftInvoice.isActive` (boolean)
    Example: true

  - `draftInvoices.draftInvoice.pms_invoice_number` (string)
    Example: "INV-2024-4850"

  - `draftInvoices.draftInvoice.status` (string)
    Example: "APPROVED"

  - `total` (object)

  - `total.aggregate` (object)

  - `total.aggregate.count` (integer)
    Total number of draft invoice history records matching criteria
    Example: 94


## Response 400 fields

## Response 401 fields

## Response 500 fields