---
title: "List all tracked commodities."
url: "https://developer.argaam.com/apis/macroeconomic-layer-api-sandbox-v1/versions/e4c9f983-817a-417e-bfa3-115c2b14f8bd/operations/getCommodities"
---

> Full API specification: https://developer.argaam.com/apis/macroeconomic-layer-api-sandbox-v1/versions/e4c9f983-817a-417e-bfa3-115c2b14f8bd.md

# List all tracked commodities.

`GET` `/api/v1.1/commodities`

Operation ID: `getCommodities`

Returns the full catalogue Argaam tracks: codes, names, units, reference exchanges, and category (energy, metals, agri, etc.). ### Example ``` GET /api/v1.1/commodities ```

## Responses

- `200` - Success

## OpenAPI definition

````yaml
openapi: 3.0.1
info:
  title: Macroeconomic Layer API
  version: v1.1
servers:
  - url: https://api-sandbox.argaam.com
    description: Argaam API Gateway (Sandbox)
paths:
  /api/v1.1/commodities:
    get:
      tags:
        - Commodities
      responses:
        "200":
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: "#/components/schemas/Commodity"
      summary: List all tracked commodities.
      description: "Returns the full catalogue Argaam tracks: codes, names, units,\r

        reference exchanges, and category (energy, metals, agri, etc.).\r

        \            \r

        ### Example\r

        ```\r

        GET /api/v1.1/commodities\r

        ```"
      operationId: getCommodities
      parameters: []
security:
  - ApiKeyAuth: []
components:
  schemas:
    Commodity:
      type: object
      properties:
        commodityID:
          type: integer
          format: int32
        nameEn:
          type: string
          nullable: true
        nameAr:
          type: string
          nullable: true
        type:
          type: string
          nullable: true
      additionalProperties: false
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: apikey
````