---
title: "A whole-job takeoff's measurements, build-up choices and calculators"
method: GET
path: "/takeoff/{id}"
tags: ["Takeoffs"]
---

# A whole-job takeoff's measurements, build-up choices and calculators

`GET /takeoff/{id}`

## Request

- Base URL: `https://api.craftquantities.com/v1`
- URL: `https://api.craftquantities.com/v1/takeoff/{id}`
- Auth: none declared

## Path parameters

- `id` string, required

## Query parameters

- `detail` 'full' | 'summary': full (the default): the whole answer. summary: the result lines, the citation line and the page only — fewer tokens to read.
- `format` 'json' | 'md'

## Response `200`

What the takeoff asks for.

- union
  - object
    - `takeoff` object, required
      - `id` string, required
      - `name` string, required
      - `category` string, required
      - `description` string, required
      - `url` string, required: The takeoff's page on craftquantities.com.
    - `measurements` object[], required
      - `id` string, required
      - `label` string, required
      - `help` string
      - `dimension` string
      - `acceptedUnits` string[]
      - `opening` object, required
      - `basis` object: Where a figure comes from: a source the site publishes, or the reason there is none.
        - `unsourced` string
        - `source` object
          - `kind` string, required
    - `choices` object[], required
      - `id` string, required
      - `label` string, required
      - `options` object[], required
      - `opening` object, required
    - `steps` object[], required
    - `excludes` string[], required
    - `citation` object, required
      - `author` string, required
      - `title` string, required
      - `version` string, nullable
      - `sourcesChecked` string, nullable
      - `url` string, required
      - `accessDate` string, nullable, required
      - `formats` object, required
        - `plain` string, required
        - `apa` string, required
        - `harvard` string, required
        - `bibtex` string, required
    - `licence` object, required
      - `name` string, required
      - `url` string, required
      - `attribution` string, required
  - object
    - `detail` 'summary', required
    - `tool` string, required
    - `title` string, required
    - `lines` object[], required: The result lines, as the report's table gives them.
    - `notes` string[], required: What a professional must decide, when to call one, a false-friend warning, that adoption is local: kept in every summary.
    - `citation` string, required: The one citation line, built from the answer's own data.
    - `url` string, nullable, required
    - `open` string, nullable, required
    - `more` string, nullable, required

## Other responses

- `400`: The request was refused; every problem is listed.
- `404`: The request was refused; every problem is listed.

---

[API](https://skmtc.dev/craftquantities/apis/craft-quantities-engine-api.md) · [All operations](https://skmtc.dev/craftquantities/apis/craft-quantities-engine-api/llms.txt) · [OpenAPI document](https://skmtc.dev/craftquantities/apis/craft-quantities-engine-api/revisions/a69883abc23b?raw)