---
title: "Retrieve a list of Estimates"
method: GET
path: "/v2/estimates"
tags: ["Estimates"]
---

# Retrieve a list of Estimates

`GET /v2/estimates`

Retrieves a paginated list of Estimates, optionally filtered by date range.

## Query parameters

- `pageSize` number
- `page` number
- `dateProperty` 'updated' | 'created'
- `dateOperator` 'prev' | 'next' | 'between'
- `date` string

## Headers

- `Authorization` string, required

## Response `200`

A paginated list of Estimates.

- ResponseEstimatesV2Dto
  - `pageSize` number — The maximum number of items returned per page.
  - `page` number — The current page number.
  - `totalResults` number — The total number of results.
  - `hasMore` boolean — Whether there are more results.
  - `data` ResponseAllEstimateV2Dto[] — A list of Estimates.
    - `id` string — The ID of the estimate (prefix `ES-`).
    - `status` string — The status of the estimate.
    - `serialId` string — The interval of the estimate.
    - `name` string — The name of the estimate.
    - `description` string — The description of the estimate.
    - `notes` string — The estimate note.
    - `imageUrl` string — The image URL of the estimate.
    - `clientId` string — The ID of the associated client (prefix `CL-`).
    - `jobId` string — The ID of the associated job or lead (prefix `JOB-` or `LD-`).
    - `taxPercent` number — The estimate tax percent.
    - `taxableAmount` number — The estimate taxable amount.
    - `taxAmount` number — The estimate tax amount.
    - `isDepositPercentage` boolean — The estimate deposit percentage or amount.
    - `deposit` number — The deposit amount or percentage needed.
    - `subTotal` number — The estimate subtotal before tax and discounts.
    - `total` number — The total amount of the estimate.
    - `declineReason` string — The decline reason of the estimate.
    - `sentDate` string, date-time — The sent date of the estimate.
    - `estimateDate` string, date-time — The date of the estimate.
    - `lastViewedDate` string, date-time — The last viewed date of the estimate.
    - `statusUpdatedAt` string, date-time — The date and time the status was last updated.
    - `updated` string, date-time — The date and time the estimate was last updated.
    - `created` string, date-time — The date and time the estimate was created.

## Other responses

- `400` — Invalid query parameters.
- `401` — Missing or invalid authentication token.

---

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