---
title: "A permanent id, an old slug or a site address to the page as it is today"
method: GET
path: "/id/{id}"
tags: ["Agent tools"]
---

# A permanent id, an old slug or a site address to the page as it is today

`GET /id/{id}`

## Request

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

## Path parameters

- `id` string, required: A permanent id (cq-c0412), a current or earlier slug, or a craftquantities.com address.

## Query parameters

- `kind` 'calculator' | 'takeoff' | 'guide' | 'example' | 'term' | 'diagnosis': Only pages of this kind.
- `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`

The page or pages it names.

- union
  - object
    - `matches` object[], required: The pages the reference names: one for an id, more where pages of different kinds share a slug.
      - `id` string, required: The permanent id: assigned once, kept whatever the page's slug or category becomes.
      - `kind` 'calculator' | 'takeoff' | 'guide' | 'example' | 'term' | 'diagnosis', required
      - `slug` string, required: The slug the page answers on today.
      - `history` string[], required: Every slug the page has had, the current one last.
      - `url` string, required: The page's address today.
      - `permanentUrl` string, required: The site's /id/ address for the page, which redirects to wherever the page is.
      - `retired` object
        - `replacedBy` string, nullable
    - `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)
