{"openapi":"3.1.0","info":{"title":"Shipping Container Codes API","version":"1.0.0","description":"The ISO 6346 size-and-type codes used to identify intermodal freight containers as an API — the reference a container booking system, EDI integration or terminal operating system needs. Every shipping container is described by a 4-character code (for example 22G1 = a 20-foot general-cargo container, 45R1 = a 40-foot high-cube reefer). For each of 700+ codes the API returns a human-readable description, the container length in feet, the height in feet and the ISO group code it belongs to. Look a code up, list every code in a group, search by description (reefer, tank, open top, flat rack…), or list the whole set. Served from memory — always fast.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/containercodes-api","description":"oanor gateway"}],"tags":[{"name":"Lookup"},{"name":"Group"},{"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":"Container by ISO 6346 code","description":"","parameters":[{"name":"code","in":"query","required":true,"description":"ISO 6346 size-type code","schema":{"type":"string"},"example":"22G1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"container":{"code":"22G1","group":"22GP","height_ft":8.5,"length_ft":20,"description":"Standard Dry"}},"meta":{"timestamp":"2026-06-08T18:25:07.757Z","request_id":"c0e305e7-dff5-4660-9c23-80c75e16b20f"},"status":"ok","message":"Container 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/group":{"get":{"operationId":"get_v1_group","tags":["Group"],"summary":"All codes in an ISO group","description":"","parameters":[{"name":"group","in":"query","required":true,"description":"ISO group code","schema":{"type":"string"},"example":"22GP"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":69,"group":"22GP","containers":[{"code":"1000","group":"22GP","height_ft":8,"length_ft":10,"description":"Standard Dry"},{"code":"10G0","group":"22GP","height_ft":8,"length_ft":10,"description":"DRY CARGO/GENERAL PURPOSE"},{"code":"1200","group":"22GP","height_ft":8.5,"length_ft":10,"description":"Standard Dry"},{"code":"12G0","group":"22GP","height_ft":8.5,"length_ft":10,"description":"DRY CARGO/GENERAL PURPOSE"},{"code":"2000","group":"22GP","height_ft":8,"length_ft":20,"description":"Standard Dry"},{"code":"2001","group":"22GP","height_ft":8,"length_ft":20,"description":"Standard Dry"},{"code":"2002","group":"22GP","height_ft":8,"length_ft":20,"description":"Standard Dry"},{"code":"2003","group":"22GP","height_ft":8,"length_ft":20,"description":"Standard Dry"},{"code":"2004","group":"22GP","height_ft":8,"length_ft":20,"description":"Standard Dry"},{"code":"2025","group":"22GP","height_ft":8,"length_ft":20,"description":"Livestock Carrier"},{"code":"20G0","group":"22GP","height_ft":8,"length_ft":20,"description":"Standard Dry"},{"code":"20G1","group":"22GP","height_ft":8,"length_ft":20,"description":"Standard Dry"},{"code":"20G2","group":"22GP","height_ft":8,"length_ft":20,"description":"Standard Dry"},{"code":"20G3","group":"22GP","height_ft":8,"length_ft":20,"description":"Standard Dry"},{"code":"20GP","group":"22GP","height_ft":8,"length_ft":20,"description":"Standard Dry"},{"code":"2101","group":"22GP","height_ft":8,"length_ft":20,"description":"Standard Dry"},{"code":"2102","group":"22GP","height_ft":8,"length_ft":20,"description":"Standard Dry"},{"code":"2103","group":"22GP","height_ft":8,"length_ft":20,"description":"Standard Dry"},{"code":"2104","group":"22GP","height_ft":8,"length_ft":20,"description":"Standard Dry"},{"code":"2125","group":"22GP","height_ft":8,"length_ft":20,"description":"Livestock Carrier"},{"code":"2200","group":"22GP","height_ft":8.5,"length_ft":20,"description":"Standard Dry"},{"code":"2201","group":"22GP","height_ft":8.5,"length_ft":20,"description":"Standard Dry"},{"code":"2202","group":"22GP","height_ft":8.5,"length_ft":20,"description":"Standard Dry"},{"code":"2204","group":"22GP","height_ft":8.5,"length_ft":20,"description":"Standard Dry"},{"code":"2205","group":"22GP","height_ft":8.5,"length_ft":20,"description":"Standard Dry"},{"code":"2210","group":"22GP","height_ft":8.5,"length_ft":20,"description":"Standard Dry"},{"code":"2212","group":"22GP","height_ft":8.5,"length_ft":20,"description":"General Purpose (Hanging Garments)"},{"code":"2213","group":"22GP","height_ft":8.5,"length_ft":20,"description":"Standard Dry"},{"code":"2225","group":"22GP","height_ft":8.5,"length_ft":20,"description":"Livestock Carrier"},{"code":"22G0","group":"22GP","height_ft":8.5,"length_ft":20,"description":"Standard Dry"},{"code":"22G1","group":"22GP","height_ft":8.5,"length_ft":20,"description":"Standard Dry"},{"code":"22G2","group":"22GP","height_ft":8.5,"length_ft":20,"description":"Standard Dry"},{"code":"22G3","group":"22GP","height_ft":8.5,"length_ft":20,"description":"Standard Dry"},{"code":"22GP","group":"22GP","height_ft":8.5,"length_ft":20,"description":"Standard Dry"},{"code":"22V3","group":"22GP","height_ft":8.5,"length_ft":20,"description":"Standard Dry"},{"code":"2300","group":"22GP","height_ft":8.5,"length_ft":20,"description":"Standard Dry"},{"code":"2301","group":"22GP","height_ft":8.5,"length_ft":20,"description":"Standard Dry"},{"code":"2302","group":"22GP","height_ft":8.5,"length_ft":20,"description":"Standard Dry"},{"code":"2303","group":"22GP","height_ft":8.5,"length_ft":20,"description":"Standard Dry"},{"code":"2304","group":"22GP","height_ft":8.5,"length_ft":20,"description":"Standard Dry"},{"code":"2410","group":"22GP","height_ft":9.5,"length_ft":20,"description":"HIGH CUBE"},{"code":"24G0","group":"22GP","height_ft":9,"length_ft":20,"description":"Standard Dry"},{"code":"24G1","group":"22GP","height_ft":9,"length_ft":20,"description":"Standard Dry"},{"code":"24G2","group":"22GP","height_ft":9,"length_ft":20,"description":"Standard Dry"},{"code":"24G3","group":"22GP","height_ft":9,"length_ft":20,"description":"Standard Dry"},{"code":"24GP","group":"22GP","height_ft":9,"length_ft":20,"description":"Standard Dry"},{"code":"2500","group":"22GP","height_ft":8.5,"length_ft":20,"description":"Standard Dry"},{"code":"25G0","group":"22GP","height_ft":9,"length_ft":20,"description":"Standard Dry High Cube"},{"code":"25GP","group":"22GP","height_ft":9.5,"length_ft":20,"description":"High Cube"},{"code":"2600","group":"22GP","height_ft":4.25,"length_ft":20,"description":"Standard Dry"},{"code":"26G0","group":"22GP","height_ft":9.5,"length_ft":20,"description":"Standard Dry"},{"code":"26G1","group":"22GP","height_ft":9.5,"length_ft":20,"description":"Standard Dry"},{"code":"26G2","group":"22GP","height_ft":9.5,"length_ft":20,"description":"Standard Dry"},{"code":"26G3","group":"22GP","height_ft":9.5,"length_ft":20,"description":"Standard Dry"},{"code":"26GP","group":"22GP","height_ft":9.5,"length_ft":20,"description":"Standard Dry"},{"code":"28G0","group":"22GP","height_ft":4.25,"length_ft":20,"description":"Standard Dry"},{"code":"28GP","group":"22GP","height_ft":4.25,"length_ft":20,"description":"Standard Dry"},{"code":"28U1","group":"22GP","height_ft":4.25,"length_ft":20,"description":"BIN HALF HEIGHT (OPEN TOP)"},{"code":"28U2","group":"22GP","height_ft":8.5,"length_ft":20,"description":"OPENING(S) AT ONE OR BOTH ENDS, PLUS REMV TOP MEMB"},{"code":"28UT","group":"22GP","height_ft":8.5,"length_ft":20,"description":"OPENING(S) AT ONE OR BOTH ENDS, PLUS REMV TOP MEMB"},{"code":"2994","group":"22GP","height_ft":4,"length_ft":20,"description":"Air/Surface"},{"code":"2999","group":"22GP","height_ft":0,"length_ft":20,"description":"SLIDER CHASSIS"},{"code":"3000","group":"22GP","height_ft":8,"length_ft":30,"description":"Standard Dry"},{"code":"30G0","group":"22GP","height_ft":8,"length_ft":30,"description":"DRY CARGO/GENERAL PURPOSE"},{"code":"3200","group":"22GP","height_ft":8.5,"length_ft":30,"description":"Standard Dry"},{"code":"32G0","group":"22GP","height_ft":8.5,"length_ft":30,"description":"DRY CARGO/GENERAL PURPOSE"},{"code":"3399","group":"22GP","height_ft":0,"length_ft":23,"description":"TRIAXLE CHASSIS"},{"code":"7999","group":"22GP","height_ft":0,"length_ft":20,"description":"SLIDER CHASSIS"},{"code":"B2G1","group":"22GP","height_ft":8.5,"length_ft":24,"description":"PASSIVE VENTS AT UPPER PART OF CARGO SPACE"}]},"meta":{"timestamp":"2026-06-08T18:25:07.885Z","request_id":"45db6ec9-b886-4cc3-9dad-ba561d63e265"},"status":"ok","message":"Group 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 container codes","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Search query (min 2 chars)","schema":{"type":"string"},"example":"reefer"},{"name":"limit","in":"query","required":false,"description":"Max results (1-200)","schema":{"type":"string"},"example":"50"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":5,"query":"reefer","total":5,"containers":[{"code":"22R1","group":"22RT","height_ft":8.5,"length_ft":20,"description":"Reefer"},{"code":"42R1","group":"42RT","height_ft":8.5,"length_ft":40,"description":"Reefer"},{"code":"4534","group":"45RT","height_ft":9.5,"length_ft":40,"description":"HIGHCUBE INTEGRATED REEFER"},{"code":"45R1","group":"45RT","height_ft":9.5,"length_ft":40,"description":"Reefer High Cube"},{"code":"L5R1","group":"L5RT","height_ft":9.5,"length_ft":45,"description":"45 Reefer High Cube"}]},"meta":{"timestamp":"2026-06-08T18:25:08.011Z","request_id":"ef756a2e-c1b8-4c91-890d-f35cd94a6538"},"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 all container codes","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Page size (1-800)","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":715,"containers":[{"code":"1000","group":"22GP","height_ft":8,"length_ft":10,"description":"Standard Dry"},{"code":"10G0","group":"22GP","height_ft":8,"length_ft":10,"description":"DRY CARGO/GENERAL PURPOSE"},{"code":"1200","group":"22GP","height_ft":8.5,"length_ft":10,"description":"Standard Dry"},{"code":"12G0","group":"22GP","height_ft":8.5,"length_ft":10,"description":"DRY CARGO/GENERAL PURPOSE"},{"code":"12TR","group":"12TR","height_ft":8,"length_ft":42,"description":"Flatbed"},{"code":"2000","group":"22GP","height_ft":8,"length_ft":20,"description":"Standard Dry"},{"code":"2001","group":"22GP","height_ft":8,"length_ft":20,"description":"Standard Dry"},{"code":"2002","group":"22GP","height_ft":8,"length_ft":20,"description":"Standard Dry"},{"code":"2003","group":"22GP","height_ft":8,"length_ft":20,"description":"Standard Dry"},{"code":"2004","group":"22GP","height_ft":8,"length_ft":20,"description":"Standard Dry"},{"code":"2010","group":"22VH","height_ft":8,"length_ft":20,"description":"Closed Vented"},{"code":"2011","group":"22VH","height_ft":8,"length_ft":20,"description":"Closed Vented"},{"code":"2013","group":"22VH","height_ft":8,"length_ft":20,"description":"Closed Ventilated"},{"code":"2015","group":"22VH","height_ft":8,"length_ft":20,"description":"Closed Ventilated"},{"code":"2017","group":"22VH","height_ft":8,"length_ft":20,"description":"Closed Ventilated"},{"code":"2020","group":"22HR","height_ft":8,"length_ft":20,"description":"Thermal Insulated"},{"code":"2025","group":"22GP","height_ft":8,"length_ft":20,"description":"Livestock Carrier"},{"code":"2030","group":"22RT","height_ft":8,"length_ft":20,"description":"Thermal Refrigerated"},{"code":"2031","group":"22RT","height_ft":8,"length_ft":20,"description":"Thermal Refrigerated"},{"code":"2032","group":"22RT","height_ft":8,"length_ft":20,"description":"Thermal Refrigerated/Heated"},{"code":"2040","group":"22RT","height_ft":8,"length_ft":20,"description":"Thermal Refrigerated"},{"code":"2041","group":"22RT","height_ft":8,"length_ft":20,"description":"Thermal Refrigerated"},{"code":"2042","group":"22RT","height_ft":8,"length_ft":20,"description":"Thermal Refrigerated"},{"code":"2043","group":"22RT","height_ft":8,"length_ft":20,"description":"Thermal Refrigerated"},{"code":"2050","group":"22UT","height_ft":8,"length_ft":20,"description":"Open Top"},{"code":"2051","group":"22UT","height_ft":8,"length_ft":20,"description":"Open Top"},{"code":"2052","group":"22UT","height_ft":8,"length_ft":20,"description":"Open Top"},{"code":"2053","group":"22UT","height_ft":8,"length_ft":20,"description":"Open Top"},{"code":"2060","group":"29PL","height_ft":8,"length_ft":20,"description":"Platform"},{"code":"2061","group":"29PL","height_ft":8,"length_ft":20,"description":"Platform"},{"code":"2062","group":"29PL","height_ft":8,"length_ft":20,"description":"Platform"},{"code":"2063","group":"22PF","height_ft":8,"length_ft":20,"description":"Flat"},{"code":"2064","group":"29PL","height_ft":8,"length_ft":20,"description":"Platform"},{"code":"2065","group":"29PL","height_ft":8,"length_ft":20,"description":"Platform"},{"code":"2066","group":"22PF","height_ft":8,"length_ft":20,"description":"Platform"},{"code":"2067","group":"22PF","height_ft":8,"length_ft":20,"description":"Platform"},{"code":"2070","group":"22TN","height_ft":8,"length_ft":20,"description":"Tank"},{"code":"2071","group":"22TN","height_ft":8,"length_ft":20,"description":"Tank"},{"code":"2072","group":"22TN","height_ft":8,"length_ft":20,"description":"Tank"},{"code":"2073","group":"22TN","height_ft":8,"length_ft":20,"description":"Tank"},{"code":"2074","group":"22TN","height_ft":8,"length_ft":20,"description":"Tank"},{"code":"2075","group":"22TN","height_ft":8,"length_ft":20,"description":"Tank"},{"code":"2076","group":"22TN","height_ft":8,"length_ft":20,"description":"Tank"},{"code":"2077","group":"22TN","height_ft":8,"length_ft":20,"description":"Tank"},{"code":"2078","group":"22TN","height_ft":8,"length_ft":20,"description":"Tank"},{"code":"2079","group":"22TN","height_ft":8,"length_ft":20,"description":"Tank"},{"code":"2080","group":"22BU","height_ft":8,"length_ft":20,"description":"Dry Bulk"},{"code":"20B0","group":"22BU","height_ft":8,"length_ft":20,"description":"Dry Bulk"},{"code":"20B1","group":"22BU","height_ft":8,"length_ft":20,"description":"Dry Bulk"},{"code":"20B3","group":"22BU","height_ft":8,"length_ft":20,"description":"Dry Bulk"}]},"meta":{"timestamp":"2026-06-08T18:25:08.119Z","request_id":"a16e1209-50fe-47f6-9921-813ec59f5daf"},"status":"ok","message":"Container 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":"containercodes-api","endpoints":{"GET /v1/code":"Container detail by ISO 6346 size-type code (code=, e.g. 22G1).","GET /v1/list":"List all container codes (limit, offset).","GET /v1/meta":"This document.","GET /v1/group":"All codes in an ISO group (group=, e.g. 22GP).","GET /v1/search":"Search codes by description, code or group (q=, e.g. reefer)."},"description":"ISO 6346 shipping-container size-and-type codes: 4-character code, description, length (feet), height (feet) and ISO group. Look up a code, list a group, search by description, or list them all. The reference a container booking, EDI or terminal system needs. No key.","total_codes":715,"total_groups":28},"meta":{"timestamp":"2026-06-08T18:25:08.274Z","request_id":"b729b9de-d9df-4237-8835-4cd6cb52826d"},"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":12000,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":800,"monthly_call_quota":140000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2100,"monthly_call_quota":700000,"rps_limit":25,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":5000,"monthly_call_quota":3500000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/containercodes-api"}