---
title: "A trade word in each market's usage, with the false-friend warning"
method: GET
path: "/term"
tags: ["Diagnoses and documents"]
---

# A trade word in each market's usage, with the false-friend warning

`GET /term`

## Request

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

## Query parameters

- `term` string, required: A trade word or phrase as one market says it, a brand name said for the product, or a misspelling: "plasterboard", "gyprock", "casing", "skirting", "eavestrough", "a yard of concrete".
- `from` 'US' | 'CA' | 'UK' | 'AU': The market whose word it is, where known.
- `to` 'US' | 'CA' | 'UK' | 'AU': The market to say it in.
- `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 concept, each market's word and any false friend, the unit traps the word raises and the market's document family.

- union
  - object
    - `engine` object, required
    - `term` string, required
    - `from` string
    - `to` string
    - `matchedBy` 'term' | 'variant' | 'within' | 'fuzzy' | 'search', required: How the word was matched: a glossary name exactly; the same name spaced, hyphenated or plural; a phrase holding a name; a misspelling of one name; or the site's ranking of the definitions.
    - `matched` object[]
      - `concept` string, required
      - `name` string, required: The glossary's own name that matched.
      - `market` string, required
      - `as` 'term' | 'also called', required
    - `readAs` string
    - `unitSystems` object[]: Each named market's primary measurement system, as the site's market registry holds it.
      - `market` string, required
      - `system` 'metric' | 'imperial', required
    - `unitTraps` object[]
      - `id` string, required
      - `title` string, required
      - `says` string, required
      - `markets` string[], required
      - `conversions` object[], required
        - `definition` string: The defining relation, where one side is not a unit of the conversion table.
        - `value` number, required
        - `from` string, required
        - `to` string, required
        - `result` number, required
        - `factor` number, nullable
        - `by` string, required: The engine's unit conversion that gave the result.
      - `page` string, required
      - `bags` object[]
        - `calculator` object, required
        - `input` string, required
        - `metric` string[], required
        - `imperial` string[], required
    - `documents` object: The family of documents that governs the concept's subject in the named market. No edition, and no claim that it matches another market's document.
      - `market` string, required
      - `place` string, required
      - `for` string: The calculator whose sources, or the document the glossary names for the concept, the subject was read from.
      - `subjects` object[], required
        - `subject` string, required
        - `documents` string[], required
      - `adoption` string, required
      - `decidedBy` string, required
      - `page` string, required
    - `concepts` object[], required
      - `slug` string, required
      - `concept` string, required
      - `url` string, required
      - `definition` string, required
      - `matchedAs` object[], required
      - `names` object[], required
        - `market` string, required
        - `term` string, required
        - `alsoCalled` string[], required
        - `exactness` 'identical' | 'close' | 'false-friend' | 'absent', required
        - `note` string, nullable, required
      - `translation` object
      - `warnings` string[], required
      - `calculators` unknown[], required
        - unknown
      - `confusions` string[], required
    - `none` string
    - `note` string
    - `links` object, 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.

---

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