Measured Size

Her bra size from her underbust and bust measurements (inches or cm, decimals allowed): her base US size, sister sizes one band each way, the UK size, EU and French sizes where their tables give the whole size, and the usual letter size (S/M/L). Use this when a shopper gives her measurements and wants her size in general. The answer includes a confidence badge and a reason: pass both on with the size. If the measurements are refused, tell her the reason given.

{
  "type": "object",
  "properties": {
    "underbust": {
      "type": "number",
      "description": "Snug around the ribcage, just under the bust, after breathing out. Decimals allowed.",
      "examples": [
        32
      ]
    },
    "bust": {
      "type": "number",
      "description": "Around the fullest part of the bust, the tape flat and not pressing in. Decimals allowed.",
      "examples": [
        38
      ]
    },
    "unit": {
      "type": "string",
      "enum": [
        "in",
        "cm"
      ],
      "default": "in",
      "description": "The unit both measurements are in: inches (in) or centimetres (cm)."
    }
  },
  "required": [
    "underbust",
    "bust"
  ],
  "additionalProperties": false
}

Her size at one brand, in that brand's own labels (for example 32E at a UK-lettered brand where her US size is 32DDD), for its band and cup bras and for its letter-sized styles, each with a confidence badge and a reason. Use this when a shopper names a brand. If the brand doesn't carry her size, the answer says so and why (for example its bands start at 34); pass that on rather than guessing. Use list_bra_brands if the brand isn't found.

{
  "type": "object",
  "properties": {
    "brand": {
      "type": "string",
      "description": "A brand name as shoppers write it (aliases accepted, any case), or an id from the brand list.",
      "examples": [
        "Wacoal"
      ]
    },
    "underbust": {
      "type": "number",
      "description": "Snug around the ribcage, just under the bust, after breathing out. Decimals allowed.",
      "examples": [
        32
      ]
    },
    "bust": {
      "type": "number",
      "description": "Around the fullest part of the bust, the tape flat and not pressing in. Decimals allowed.",
      "examples": [
        38
      ]
    },
    "unit": {
      "type": "string",
      "enum": [
        "in",
        "cm"
      ],
      "default": "in",
      "description": "The unit both measurements are in: inches (in) or centimetres (cm)."
    }
  },
  "required": [
    "brand",
    "underbust",
    "bust"
  ],
  "additionalProperties": false
}

Translate a band and cup size she wears at one brand (for example 34DD at Wacoal) into another brand's label, through Measured Size's base size. Use this only when the shopper has no measurements; measurements give a better answer. Translated sizes are rated no higher than Possible Match: tell her so. It refuses letter sizes (S/M/L), labels the first brand's record doesn't give, and brands that sell letter sizes only, with the reason.

{
  "type": "object",
  "properties": {
    "from_brand": {
      "type": "string",
      "description": "The brand whose size she knows.",
      "examples": [
        "Wacoal"
      ]
    },
    "size": {
      "type": "string",
      "description": "Her band and cup size at from_brand, as that brand labels it.",
      "examples": [
        "34DD"
      ]
    },
    "to_brand": {
      "type": "string",
      "description": "The brand to translate the size into.",
      "examples": [
        "Curvy Kate"
      ]
    }
  },
  "required": [
    "from_brand",
    "size",
    "to_brand"
  ],
  "additionalProperties": false
}

The brands Measured Size has researched, with their other names, whether they sell band and cup sizes or letter sizes, their cup letters, band and cup ranges, whether their own letter chart is on file, and when their record was last researched. Use it to find a brand's name before the other tools, or to say which brands are covered.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Optional: only brands whose name or an alias contains this text."
    }
  },
  "required": [],
  "additionalProperties": false
}