---
title: "Convert a value between units with the site's exact factors"
method: GET
path: "/convert"
tags: ["Units"]
---

# Convert a value between units with the site's exact factors

`GET /convert`

## Request

- Base URL: `https://api.craftquantities.com/v1`
- URL: `https://api.craftquantities.com/v1/convert`
- Auth: none declared

## Query parameters

- `value` number, required
- `from` string, required
- `to` string, required
- `dimension` string
- `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 converted value and the factor.

- union
  - object
    - `value` number, required
    - `from` object, required
      - `unit` string, required
      - `symbol` string, required
      - `label` string, required
    - `to` object, required
      - `unit` string, required
      - `symbol` string, required
      - `label` string, required
      - `value` number, required
    - `dimension` string, required
    - `factor` number, nullable, 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.

---

[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)