---
search:
  tags:
    - sales
    - GET
seo:
  description: >-
    What are Sales Estimates? Sales Estimates provides a unified overview of…
    Reference for the GET /sales/estimates/grid endpoint in the Leadtime Public
    API API.
sidebar:
  badge: GET
  label: Get sales estimates grid
title: Get sales estimates grid
type: openapi-operation
---
**What are Sales Estimates?**
Sales Estimates provides a unified overview of all ongoing offers and sales opportunities in Leadtime. This endpoint combines two types of estimates into a single grid view:
- **Project Documents**: Detailed estimates linked to larger projects, created through the project planning process with products, modules, and custom items
- **Express Quotations**: Quick estimates created directly from tickets for smaller, ad-hoc customer requests

**What data is returned:**
The response includes a paginated grid of estimate items with comprehensive pricing information:
- Each item represents either a project document estimate or an express quotation
- Only the latest estimate per project or task is returned (older versions are excluded)
- Pricing breakdown includes fixed prices, subscription prices, and per-unit prices
- Aggregated totals across all filtered results are provided at the response level

**Pricing components:**
Each estimate can have three types of pricing:
- **Fixed Price**: One-time charges for services or products
- **Subscriptions**: Recurring prices (monthly, quarterly, semi-annually, or annually)
- **Per Unit**: Prices based on quantity (e.g., price per user or workspace)

The response includes both individual item pricing and aggregated totals (totalPriceFixed, totalPriceSubscriptions, totalPricePerUnit) across all filtered results.

**Estimate types:**
- **PROJECT_DOCUMENT**: Estimates created as part of project planning, typically more detailed and structured
- **EXPRESS_QUOTATION**: Quick estimates created from tickets, ideal for small add-on tasks or support services

**Estimate statuses:**
- **Draft**: Estimate is being prepared and has not been sent
- **WaitingForApproval**: Estimate is pending internal approval before sending
- **Final**: Estimate has been finalized and approved
- **Pending**: Express quotation has been sent to customer, awaiting response
- **Accepted**: Customer has accepted the estimate
- **Rejected**: Customer has rejected the estimate
- **Parked**: Estimate has been set aside temporarily

**Access restrictions:**
- This endpoint is restricted to employees only. Organization members (external contacts) cannot access it
- Results are automatically filtered by the user's project access permissions
- Only estimates for projects the user has access to are returned

**Supported operations:**
- Filter by type, organization, project, task, status, pricing components, creator, and creation date
- Sort by any field including title, organization, project, status, pricing, and dates
- Quick search across estimate titles
- Pagination with configurable page size
- Field selection to return only specific fields in the response

**Use cases:**
- Generate sales pipeline reports showing all active estimates
- Track revenue potential across different estimate types
- Monitor estimate status distribution (draft, pending, accepted, etc.)
- Analyze pricing breakdowns by organization or project
- Export estimate data for external reporting tools

Retrieves a paginated grid of estimates with filtering and sorting capabilities. Quick search available on: title, displayTitle. Filterable fields: id, type, title, displayTitle, organizationId, projectId, taskId, createdAt, status, priceFixed, priceSubscriptions, pricePerUnit, createdById, offerNumber. Sortable fields: id, type, title, displayTitle, organizationId, organizationName, projectId, projectName, taskId, taskShortNumber, createdAt, status, total, priceFixed, priceSubscriptions, pricePerUnit, createdById, createdByName, offerNumber.

<Operation source="api-reference" id="salesestimatescontroller-getestimatesgrid" />