---
title: "Fetch bill of quantities list."
method: GET
path: "/bill_of_quantities/fetch"
tags: ["Projects|Bill of quantities"]
---

# Fetch bill of quantities list.

`GET /bill_of_quantities/fetch`

This endpoint enables you to retrieve a list of bills of quantities, with optional filters available, as well as
an offset and limit parameter.
In the context of geoCapture, a bill of quantities is a document commonly utilized in the construction industry
and service sectors to provide a comprehensive description of all the work needed for a specific project. The
document specifies each task and material, with their respective specifications and quantities. When coordinating
a project, it is essential to provide a clear and detailed overview of all tasks, materials and quantities
required. A bill of quantities acts as a comprehensive outline, similar to a shopping list that specifies the
exact amount of each item needed. All measurements are in metric units such as metres, square metres, cubic
metres, kilograms or litres. In geoCapture, one can customize units to fit specific needs.

For example, if you are managing the development of a garden area around a corporate building, your bill of
quantities might include:<br>
Topsoil (45 cubic meters)<br>
Grass sod (186 square meters)<br>
Maple trees (10 trees, approximately 4.5 meters tall)<br>
Labor for installation (40 man-hours)<br>
Watering and maintenance services for the initial 30 days

## Query parameters

- `filter[byIds][]` integer[]
- `filter[byImportKeys][]` string[]
- `filter[byExternalIds][]` string[]
- `filter[from]` string
- `filter[to]` string
- `offset` integer
- `limit` integer

## Response `200`

Success Response:

- StandardBillOfQuantitiesFetchResponse
  - `data` object[] — The list of bills of quantities.
    - `id` integer — The internal id of the bill of quantities.
    - `externalId` string — The external id.
    - `offerNumber` string — The offer number.
    - `addendum` string — The number of the addendum of this bill of quantities.
    - `text1` string — The name.
    - `date` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx
    - `totalValue` number — The total Value.
    - `currency` string — The currency.
  - `offset` integer — Number of skipepd records.
  - `totalCount` integer — Total number of available bills of quantities. (Only calculated if offset is 0)

---

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