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

# Categories

> GHG Protocol classification

## Description

**Categories** follow the GHG Protocol (Scope 1, 2, 3) to classify consumptions and emissions.

## Endpoint

```
GET /api/v1/categories?level=scope|category|subcategory
```

## Levels

| Level         | Description            |
| ------------- | ---------------------- |
| `scope`       | Scope 1, 2, 3          |
| `category`    | Main categories        |
| `subcategory` | Detailed subcategories |

## Usage

When creating consumptions, you must send the `categoryId` (UUID) obtained from `GET /api/v1/categories?level=subcategory`.

For vehicles, typical categories include:

* `LAND_TRANSPORTATION`, `AIR_TRANSPORTATION`
* `MARITIME_TRANSPORTATION`, `RAIL_TRANSPORTATION`
* `FORESTRY_MACHINERY`, `FARM_MACHINERY`, `INDUSTRIAL_MACHINERY`