> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chemcloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Lists dangerous goods UN numbers



## OpenAPI

````yaml https://app.chemcloud.com.au/api-docs/public/buyer/v1/openapi.yaml get /api/public/buyer/v1/dangerous_goods_un_numbers
openapi: 3.0.1
info:
  title: ChemCloud Buyer API
  version: v1
  description: >
    ## Rate limits


    | Scope | Limit |

    |---|---|

    | Requests per API key | 6,000 per minute |

    | Requests with no `X-API-KEY` header, per IP address | 30 per minute |

    | Invalid API keys, per IP address | 20 in 10 minutes, then a 1 hour ban |


    A throttled request returns `429 Too Many Requests` with a JSON body

    `{"error": "Too many requests. Retry in N seconds."}` and a `Retry-After`
    header (seconds).

    A banned IP address returns `429` with `Retry-After: 3600` for every request
    until the ban expires.
servers:
  - url: https://app.chemcloud.com.au
    description: Production
security: []
paths:
  /api/public/buyer/v1/dangerous_goods_un_numbers:
    get:
      tags:
        - Dangerous Goods UN Numbers
      summary: Lists dangerous goods UN numbers
      parameters:
        - name: query
          in: query
          required: false
          schema:
            type: string
          description: >-
            Narrows the list to entries matching every term against the UN
            number and proper shipping name
      responses:
        '200':
          description: Dangerous goods UN numbers
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                      example: 99999a99-b888-777c-666d-55555555555e
                      description: >-
                        Send this as dangerous_goods_un_number_id on a buyer
                        product
                    un_number:
                      type: string
                      example: UN1203
                    proper_shipping_name:
                      type: string
                      example: MOTOR SPIRIT or GASOLINE or PETROL
                    class_or_division:
                      type: string
                      nullable: true
                      example: '3'
                    subsidiary_risk:
                      type: string
                      nullable: true
                      example: '6.1'
                    packing_group:
                      type: string
                      nullable: true
                      example: II
                      description: Null on entries that carry no packing group
                    label:
                      type: string
                      example: >-
                        UN1203, MOTOR SPIRIT or GASOLINE or PETROL, Class 3, PG
                        II
                      description: >-
                        What a buyer product reports as its
                        dangerous_goods_un_number
                  required:
                    - id
                    - un_number
                    - proper_shipping_name
                    - label
        '401':
          description: Unauthorized
      security:
        - apiKey: []
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-API-KEY

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.