---
title: "GET /Estimates"
method: GET
path: "/Estimates"
tags: ["Estimates"]
---

# GET /Estimates

`GET /Estimates`

## Query parameters

- `status` string
- `clientId` string
- `patientId` string
- `appointmentId` string
- `page` union
  - integer
  - string, int32
- `pageSize` union
  - integer
  - string, int32

## Response `200`

OK

- EstimateListResponseDto
  - `items` EstimateSummaryDto[]
    - `id` string
    - `estimateNumber` string
    - `clientName` string, nullable
    - `patientId` string, nullable — The estimate's patient, if any (null for client-only/POS estimates). Client-scoped lists (the client record page) need it to label rows and hand off to payments.
    - `patientName` string, nullable
    - `status` string
    - `selectedTier` string, nullable
    - `itemCount` union
      - integer
      - string, int32
    - `total` union — Sum of the lines' (UnitPrice × Quantity) + DispenseFee. For the linkable-estimate picker.
      - number, double
      - string, double
    - `appointmentId` string, nullable — The appointment this estimate is tied to, if any (null for standalone/POS estimates).
    - `invoiceId` string, nullable — The invoice this estimate was converted into, if any. Non-null = already converted.
    - `invoiceStatus` string, nullable — Status of the converted invoice (string? EstimateSummaryDto.InvoiceStatus as a string), or null if not converted. Lets the estimates list surface real payment state ("Paid" / "Partially Paid" / "Combined") instead of a flat "Invoiced" once an invoice exists.
    - `invoiceNumber` string, nullable — Human-readable number of the converted invoice, or null if not converted.
    - `invoiceItemCount` union — Line count of the converted invoice, or null if not converted. The bill can differ from the quote — dispenses and additions at billing time land on the invoice only — so converted rows must not present the estimate's own ItemCount/Total as the bill's.
      - integer
      - string, int32
    - `invoiceTotal` union — Grand total of the converted invoice (its TotalAmount), or null if not converted.
      - number, double
      - string, double
    - `mergedIntoInvoiceId` string, nullable — When this estimate's invoice was combined into another bill, the successor combined invoice's id. Null unless the invoice is Superseded via a merge. Grouping key for the nested combined view.
    - `mergedIntoInvoiceNumber` string, nullable — Human-readable number of the combined (successor) invoice, for the nested parent header.
    - `mergedIntoInvoiceStatus` string, nullable — Status of the combined (successor) invoice, for the nested parent's badge.
    - `createdAt` string, date-time
  - `total` union
    - integer
    - string, int32

---

[API](https://skmtc.net/clinicos/apis/pawthosx-business-api-v1.md) · [All operations](https://skmtc.net/clinicos/apis/pawthosx-business-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clinicos/pawthosx-business-api-v1/versions/a905bde4e796/schema)