{"openapi":"3.1.0","info":{"title":"Units of Measure Codes API","version":"1.0.0","description":"The UN/ECE Recommendation 20 unit-of-measure codes — the codes used to identify units of measure in trade documents, invoices and EDI messages — as an API. The reference a customs, ERP or e-invoicing system needs. Each unit (for example KGM = kilogram, MTR = metre, LTR = litre, C62 = one/each, TNE = tonne, MTK = square metre) carries a 2–3 character common code, a name, the unit symbol, a description and a status (active or deprecated). Look a code up, reverse-look-up the code(s) for a symbol (kg → KGM), search by name or symbol, or list every code filtered by status. This is the unit-of-measure CODE register — distinct from unit-api, which performs unit-conversion maths. Served from memory — always fast.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/unitcodes-api","description":"oanor gateway"}],"tags":[{"name":"Lookup"},{"name":"Search"},{"name":"List"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/code":{"get":{"operationId":"get_v1_code","tags":["Lookup"],"summary":"Unit by UN/ECE common code","description":"","parameters":[{"name":"code","in":"query","required":true,"description":"UN/ECE common code","schema":{"type":"string"},"example":"KGM"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"unit":{"code":"KGM","name":"kilogram","active":true,"status":"active","symbol":"kg","description":"A unit of mass equal to one thousand grams."}},"meta":{"timestamp":"2026-06-08T18:25:03.411Z","request_id":"aa150d53-cc2b-4219-a5f0-83cda7eba7c9"},"status":"ok","message":"Unit code retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/symbol":{"get":{"operationId":"get_v1_symbol","tags":["Lookup"],"summary":"Codes for a unit symbol","description":"","parameters":[{"name":"symbol","in":"query","required":true,"description":"Unit symbol","schema":{"type":"string"},"example":"kg"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":1,"units":[{"code":"KGM","name":"kilogram","active":true,"status":"active","symbol":"kg","description":"A unit of mass equal to one thousand grams."}],"symbol":"kg"},"meta":{"timestamp":"2026-06-08T18:25:03.542Z","request_id":"728b4d0a-5b37-4b10-9a53-eeef9f48345c"},"status":"ok","message":"Symbol lookup retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Search"],"summary":"Search unit codes","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Search query (min 2 chars)","schema":{"type":"string"},"example":"metre"},{"name":"limit","in":"query","required":false,"description":"Max results (1-100)","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":25,"query":"metre","total":491,"units":[{"code":"23","name":"gram per cubic centimetre","active":true,"status":"active","symbol":"g/cm³"},{"code":"25","name":"gram per square centimetre","active":true,"status":"active","symbol":"g/cm²"},{"code":"28","name":"kilogram per square metre","active":true,"status":"active","symbol":"kg/m²"},{"code":"2J","name":"cubic centimetre per second","active":true,"status":"active","symbol":"cm³/s"},{"code":"2M","name":"centimetre per second","active":true,"status":"active","symbol":"cm/s"},{"code":"2X","name":"metre per minute","active":true,"status":"active","symbol":"m/min"},{"code":"33","name":"kilopascal square metre per gram","active":true,"status":"active","symbol":"kPa·m²/g"},{"code":"34","name":"kilopascal per millimetre","active":true,"status":"active","symbol":"kPa/mm"},{"code":"35","name":"millilitre per square centimetre second","active":true,"status":"active","symbol":"ml/(cm²·s)"},{"code":"4H","name":"micrometre (micron)","active":true,"status":"active","symbol":"µm"},{"code":"4P","name":"newton per metre","active":true,"status":"active","symbol":"N/m"},{"code":"73","name":"ampere tum per centimetre","active":false,"status":"deprecated"},{"code":"92","name":"calorie per cubic centimetre","active":false,"status":"deprecated"},{"code":"A10","name":"ampere square metre per joule second","active":true,"status":"active","symbol":"A·m²/(J·s)"},{"code":"A19","name":"becquerel per cubic metre","active":true,"status":"active","symbol":"Bq/m³"},{"code":"A2","name":"ampere per centimetre","active":true,"status":"active","symbol":"A/cm"},{"code":"A24","name":"candela per square metre","active":true,"status":"active","symbol":"cd/m²"},{"code":"A26","name":"coulomb metre","active":true,"status":"active","symbol":"C·m"},{"code":"A27","name":"coulomb metre squared per volt","active":true,"status":"active","symbol":"C·m²/V"},{"code":"A28","name":"coulomb per cubic centimetre","active":true,"status":"active","symbol":"C/cm³"},{"code":"A29","name":"coulomb per cubic metre","active":true,"status":"active","symbol":"C/m³"},{"code":"A3","name":"ampere per millimetre","active":true,"status":"active","symbol":"A/mm"},{"code":"A30","name":"coulomb per cubic millimetre","active":true,"status":"active","symbol":"C/mm³"},{"code":"A33","name":"coulomb per square centimetre","active":true,"status":"active","symbol":"C/cm²"},{"code":"A34","name":"coulomb per square metre","active":true,"status":"active","symbol":"C/m²"}]},"meta":{"timestamp":"2026-06-08T18:25:03.670Z","request_id":"92331006-7418-40d7-99f3-df04e8b91a43"},"status":"ok","message":"Search results retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/list":{"get":{"operationId":"get_v1_list","tags":["List"],"summary":"List unit codes","description":"","parameters":[{"name":"status","in":"query","required":false,"description":"active or deprecated","schema":{"type":"string"},"example":"active"},{"name":"limit","in":"query","required":false,"description":"Page size (1-500)","schema":{"type":"string"},"example":"50"},{"name":"offset","in":"query","required":false,"description":"Offset","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":50,"total":1755,"units":[{"code":"10","name":"group","active":true,"status":"active","description":"A unit of count defining the number of groups (group: set of items classified together)."},{"code":"11","name":"outfit","active":true,"status":"active","description":"A unit of count defining the number of outfits (outfit: a complete set of equipment / materials / objects used for a specific purpose)."},{"code":"13","name":"ration","active":true,"status":"active","description":"A unit of count defining the number of rations (ration: a single portion of provisions)."},{"code":"14","name":"shot","active":true,"status":"active","description":"A unit of liquid measure, especially related to spirits."},{"code":"15","name":"stick, military","active":true,"status":"active","description":"A unit of count defining the number of military sticks (military stick: bombs or paratroops released in rapid succession from an aircraft)."},{"code":"1I","name":"fixed rate","active":true,"status":"active","description":"A unit of quantity expressed as a predetermined or set rate for usage of a facility or service."},{"code":"20","name":"twenty foot container","active":true,"status":"active","description":"A unit of count defining the number of shipping containers that measure 20 foot in length."},{"code":"21","name":"forty foot container","active":true,"status":"active","description":"A unit of count defining the number of shipping containers that measure 40 foot in length."},{"code":"22","name":"decilitre per gram","active":true,"status":"active","symbol":"dl/g"},{"code":"23","name":"gram per cubic centimetre","active":true,"status":"active","symbol":"g/cm³"},{"code":"24","name":"theoretical pound","active":true,"status":"active","description":"A unit of mass defining the expected mass of material expressed as the number of pounds."},{"code":"25","name":"gram per square centimetre","active":true,"status":"active","symbol":"g/cm²"},{"code":"27","name":"theoretical ton","active":true,"status":"active","description":"A unit of mass defining the expected mass of material, expressed as the number of tons."},{"code":"28","name":"kilogram per square metre","active":true,"status":"active","symbol":"kg/m²"},{"code":"2A","name":"radian per second","active":true,"status":"active","symbol":"rad/s","description":"Refer ISO/TC12 SI Guide"},{"code":"2B","name":"radian per second squared","active":true,"status":"active","symbol":"rad/s²","description":"Refer ISO/TC12 SI Guide"},{"code":"2C","name":"roentgen","active":true,"status":"active","symbol":"R"},{"code":"2G","name":"volt AC","active":true,"status":"active","symbol":"V","description":"A unit of electric potential in relation to alternating current (AC)."},{"code":"2H","name":"volt DC","active":true,"status":"active","symbol":"V","description":"A unit of electric potential in relation to direct current (DC)."},{"code":"2I","name":"British thermal unit (international table) per hour","active":true,"status":"active","symbol":"BtuIT/h"},{"code":"2J","name":"cubic centimetre per second","active":true,"status":"active","symbol":"cm³/s"},{"code":"2K","name":"cubic foot per hour","active":true,"status":"active","symbol":"ft³/h"},{"code":"2L","name":"cubic foot per minute","active":true,"status":"active","symbol":"ft³/min"},{"code":"2M","name":"centimetre per second","active":true,"status":"active","symbol":"cm/s"},{"code":"2N","name":"decibel","active":true,"status":"active","symbol":"dB"},{"code":"2P","name":"kilobyte","active":true,"status":"active","symbol":"kbyte","description":"A unit of information equal to 10³ (1000) bytes."},{"code":"2Q","name":"kilobecquerel","active":true,"status":"active","symbol":"kBq"},{"code":"2R","name":"kilocurie","active":true,"status":"active","symbol":"kCi"},{"code":"2U","name":"megagram","active":true,"status":"active","symbol":"Mg"},{"code":"2X","name":"metre per minute","active":true,"status":"active","symbol":"m/min"},{"code":"2Y","name":"milliroentgen","active":true,"status":"active","symbol":"mR"},{"code":"2Z","name":"millivolt","active":true,"status":"active","symbol":"mV"},{"code":"33","name":"kilopascal square metre per gram","active":true,"status":"active","symbol":"kPa·m²/g"},{"code":"34","name":"kilopascal per millimetre","active":true,"status":"active","symbol":"kPa/mm"},{"code":"35","name":"millilitre per square centimetre second","active":true,"status":"active","symbol":"ml/(cm²·s)"},{"code":"37","name":"ounce per square foot","active":true,"status":"active","symbol":"oz/ft²"},{"code":"38","name":"ounce per square foot per 0,01inch","active":true,"status":"active","symbol":"oz/(ft²/cin)"},{"code":"3B","name":"megajoule","active":true,"status":"active","symbol":"MJ"},{"code":"3C","name":"manmonth","active":true,"status":"active","description":"A unit of count defining the number of months for a person or persons to perform an undertaking."},{"code":"40","name":"millilitre per second","active":true,"status":"active","symbol":"ml/s"},{"code":"41","name":"millilitre per minute","active":true,"status":"active","symbol":"ml/min"},{"code":"4C","name":"centistokes","active":true,"status":"active","symbol":"cSt"},{"code":"4G","name":"microlitre","active":true,"status":"active","symbol":"µl"},{"code":"4H","name":"micrometre (micron)","active":true,"status":"active","symbol":"µm"},{"code":"4K","name":"milliampere","active":true,"status":"active","symbol":"mA"},{"code":"4L","name":"megabyte","active":true,"status":"active","symbol":"Mbyte","description":"A unit of information equal to 10⁶ (1000000) bytes."},{"code":"4M","name":"milligram per hour","active":true,"status":"active","symbol":"mg/h"},{"code":"4N","name":"megabecquerel","active":true,"status":"active","symbol":"MBq"},{"code":"4O","name":"microfarad","active":true,"status":"active","symbol":"µF"},{"code":"4P","name":"newton per metre","active":true,"status":"active","symbol":"N/m"}]},"meta":{"timestamp":"2026-06-08T18:25:03.796Z","request_id":"7ae94565-7d66-4aac-b264-95cda19f2d4c"},"status":"ok","message":"Unit codes listed successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"service":"unitcodes-api","endpoints":{"GET /v1/code":"Unit by UN/ECE common code (code=, e.g. KGM).","GET /v1/list":"List unit codes (status=active|deprecated, limit, offset).","GET /v1/meta":"This document.","GET /v1/search":"Search by code, name or symbol (q=, e.g. metre).","GET /v1/symbol":"Codes for a unit symbol (symbol=, e.g. kg)."},"description":"UN/ECE Recommendation 20 units-of-measure codes for trade, invoicing and EDI: 2–3 character common code, name, symbol, description and status. Look up a code, reverse-look-up from a symbol, search, or list. Distinct from unit-api (conversion maths). No key.","total_codes":2136,"active_codes":1755,"deprecated_codes":381},"meta":{"timestamp":"2026-06-08T18:25:03.896Z","request_id":"a6ef240a-1d6f-40cb-b1c5-b7e612bdd83b"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":13000,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":600,"monthly_call_quota":150000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1600,"monthly_call_quota":800000,"rps_limit":25,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3800,"monthly_call_quota":4000000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/unitcodes-api"}