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

# Get commuting distances by vehicle and fuel type



## OpenAPI

````yaml openapi/findity-admin-api.json GET /carbonemissions/commutingoverview
openapi: 3.1.0
info:
  title: Findity Admin API
  description: Findity Admin API
  version: 1.0.0
servers:
  - url: https://stage-api.findity.com/api/v1/admin
  - url: https://api.findity.com/api/v1/admin
security:
  - bearerAuth: []
paths:
  /carbonemissions/commutingoverview:
    get:
      tags:
        - Carbon emissions
      summary: Get commuting distances by vehicle and fuel type
      operationId: getDistanceByVehicleAndFuelType
      parameters:
        - $ref: '#/components/parameters/organizationId'
        - $ref: '#/components/parameters/fromDate'
        - $ref: '#/components/parameters/toDate'
        - $ref: '#/components/parameters/abbreviation'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DistanceByVehicleAndFuelType'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/404Error'
components:
  parameters:
    organizationId:
      in: query
      name: organizationId
      required: true
      description: The organization id of the carbon emissions
      schema:
        $ref: '#/components/schemas/Uuid'
      example: 05b8daba9ba14a49846fe77883248cf0
    fromDate:
      in: query
      name: fromDate
      required: false
      description: Used for filtering
      schema:
        type: string
        format: date
      example: '2020-01-20'
    toDate:
      in: query
      name: toDate
      required: false
      description: Used for filtering
      schema:
        type: string
        format: date
      example: '2018-01-23'
    abbreviation:
      in: query
      name: include
      required: false
      description: >-
        Optional comma-separated list of extra fields to include. Currently
        supports meta.abbreviation
      schema:
        type: array
        items:
          type: string
          enum:
            - meta.abbreviation
  schemas:
    DistanceByVehicleAndFuelType:
      type: object
      properties:
        data:
          type: object
          properties:
            vehicleTypes:
              $ref: '#/components/schemas/VehicleTypesSection'
            fuelTypes:
              $ref: '#/components/schemas/FuelTypesSection'
      example:
        data:
          vehicleTypes:
            meta: {}
            data:
              - carType: PRIVATE_CAR
                fuelTypes:
                  - fuelType: PETROL
                    totalDistance: 120
                    distanceUnit: km
                  - fuelType: DIESEL
                    totalDistance: 80
                    distanceUnit: km
          fuelTypes:
            meta:
              abbreviation:
                totalDistance: 200
                distanceUnit: km
            data:
              - fuelType: PETROL
                totalDistance: 120
                distanceUnit: km
              - fuelType: DIESEL
                totalDistance: 80
                distanceUnit: km
    404Error:
      type: object
      properties:
        result:
          type: string
        code:
          type: string
        description:
          type: string
      example:
        result: error
        code: ORGANIZATION_NOT_FOUND
        description: 'Failed to get organization for id: {orgId}'
    Uuid:
      type: string
      pattern: ^[0-9a-fA-F]{32}$
      description: UUID without dashes (32-character hex string)
    VehicleTypesSection:
      type: object
      properties:
        meta:
          type: object
          description: >-
            Metadata related to vehicle types. Currently empty, reserved for
            future use.
        data:
          type: array
          items:
            $ref: '#/components/schemas/VehicleTypeDistance'
    FuelTypesSection:
      type: object
      properties:
        meta:
          type: object
          description: >-
            Optional metadata for fuel type totals. Present only when
            `include=meta.abbreviation` is requested.
          properties:
            abbreviation:
              type: object
              properties:
                totalDistance:
                  type: number
                  description: Grand total distance across all fuel types.
                distanceUnit:
                  type: string
                  description: Unit of distance for the grand total.
        data:
          type: array
          items:
            $ref: '#/components/schemas/FuelTypeDistance'
    VehicleTypeDistance:
      type: object
      properties:
        carType:
          type: string
          description: Type of vehicle (e.g., PRIVATE_CAR, COMPANY_CAR, MOTORCYCLE)
        fuelTypes:
          type: array
          description: List of fuel type distances for this vehicle type
          items:
            $ref: '#/components/schemas/FuelTypeDistance'
      example:
        carType: PRIVATE_CAR
        fuelTypes:
          - fuelType: PETROL
            totalDistance: 120
            distanceUnit: km
          - fuelType: DIESEL
            totalDistance: 80
            distanceUnit: km
          - fuelType: ELECTRIC
            totalDistance: 0
            distanceUnit: km
          - fuelType: HYBRID
            totalDistance: 0
            distanceUnit: km
          - fuelType: HYDROGEN
            totalDistance: 0
            distanceUnit: km
          - fuelType: UNSPECIFIED
            totalDistance: 0
            distanceUnit: km
    FuelTypeDistance:
      type: object
      properties:
        fuelType:
          type: string
          description: >-
            Type of fuel (e.g., PETROL, DIESEL, ELECTRIC, HYBRID, HYDROGEN,
            UNSPECIFIED)
        totalDistance:
          type: number
          description: Total distance for this fuel type
        distanceUnit:
          type: string
          description: Unit of distance
      example:
        - fuelType: PETROL
          totalDistance: 120
          distanceUnit: km
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````