---
agentTools:
  projectIndex: https://docs.wastehero.io/llms.txt
---

# Get Waste Fractions

# OpenAPI definition

```json
{
  "openapi": "3.0.2",
  "info": {
    "title": "WasteHero REST API",
    "description": "\nWelcome to the WasteHero REST API. Using this API you will be able to retrieve metrics from your WasteHero account. \n\nAPI endpoints have the throttling enabled and configured in a customer company settings.\n Default is 120 requests per minute.\n",
    "version": "3.0"
  },
  "servers": [
    {
      "url": "https://platform-api.wastehero.io",
      "description": "Production environment"
    }
  ],
  "paths": {
    "/api/v3/waste_fraction/": {
      "get": {
        "tags": [
          "Waste fraction"
        ],
        "summary": "Get Waste Fractions",
        "operationId": "get_waste_fractions_api_v3_waste_fraction__get",
        "parameters": [
          {
            "required": false,
            "schema": {
              "title": "Limit",
              "maximum": 50,
              "minimum": 1,
              "type": "integer",
              "default": 10
            },
            "name": "limit",
            "in": "query"
          },
          {
            "required": false,
            "schema": {
              "title": "Offset",
              "minimum": 0,
              "type": "integer",
              "default": 0
            },
            "name": "offset",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/APIV3LimitOffsetPaginator_WasteFractionOutputSerializerV3_"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        },
        "security": [
          {
            "PlatformAPIKey": []
          }
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "APIV3LimitOffsetPaginator_WasteFractionOutputSerializerV3_": {
        "title": "APIV3LimitOffsetPaginator[WasteFractionOutputSerializerV3]",
        "required": [
          "items",
          "total",
          "limit",
          "offset",
          "has_next",
          "has_previous"
        ],
        "type": "object",
        "properties": {
          "items": {
            "title": "Items",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/WasteFractionOutputSerializerV3"
            }
          },
          "total": {
            "title": "Total",
            "minimum": 0,
            "type": "integer"
          },
          "limit": {
            "title": "Limit",
            "minimum": 1,
            "type": "integer"
          },
          "offset": {
            "title": "Offset",
            "minimum": 0,
            "type": "integer"
          },
          "has_next": {
            "title": "Has Next",
            "type": "boolean"
          },
          "has_previous": {
            "title": "Has Previous",
            "type": "boolean"
          }
        },
        "description": "A paginator that uses limit and offset as pagination parameters.\nExtended with has_next and has_previous fields to add pagination metadata."
      },
      "HTTPValidationError": {
        "title": "HTTPValidationError",
        "type": "object",
        "properties": {
          "detail": {
            "title": "Detail",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ValidationError"
            }
          }
        }
      },
      "ProjectOutputSerializerV3": {
        "title": "ProjectOutputSerializerV3",
        "required": [
          "id",
          "name"
        ],
        "type": "object",
        "properties": {
          "id": {
            "title": "Id",
            "type": "string"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "description": {
            "title": "Description",
            "type": "string"
          },
          "creating_demo_data": {
            "title": "Creating Demo Data",
            "type": "boolean",
            "default": false
          }
        }
      },
      "ValidationError": {
        "title": "ValidationError",
        "required": [
          "loc",
          "msg",
          "type"
        ],
        "type": "object",
        "properties": {
          "loc": {
            "title": "Location",
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "msg": {
            "title": "Message",
            "type": "string"
          },
          "type": {
            "title": "Error Type",
            "type": "string"
          }
        }
      },
      "WasteFractionOutputSerializerV3": {
        "title": "WasteFractionOutputSerializerV3",
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "title": "Id",
            "type": "string"
          },
          "project": {
            "$ref": "#/components/schemas/ProjectOutputSerializerV3"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "waste_type": {
            "title": "Waste Type",
            "type": "string"
          },
          "waste_category": {
            "title": "Waste Category",
            "type": "string"
          },
          "waste_substance": {
            "title": "Waste Substance",
            "type": "string"
          },
          "weight_factor": {
            "title": "Weight Factor",
            "type": "number"
          }
        }
      }
    },
    "securitySchemes": {
      "PlatformAPIKey": {
        "type": "apiKey",
        "description": "\nYou can find your API key in the settings section on app.wastehero.io. When you have the key it should be added as an Authorization header with the name X-API-Key.\n",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "_id": {
    "buffer": {
      "0": 100,
      "1": 199,
      "2": 86,
      "3": 211,
      "4": 157,
      "5": 89,
      "6": 18,
      "7": 0,
      "8": 12,
      "9": 100,
      "10": 34,
      "11": 175
    }
  }
}
```