> ## Documentation Index > Fetch the complete documentation index at: https://docs.catenatelematics.com/llms.txt > Use this file to discover all available pages before exploring further. # List fleet summaries > **Deprecated.** Use `/v2/intelligence/analytics/fleets` instead. Retrieve aggregated metrics for each fleet including vehicle counts, driver counts, and connection health. ## OpenAPI ````yaml https://api.catenatelematics.com/v2/telematics/openapi.json get /v2/telematics/analytics/fleets openapi: 3.1.0 info: title: Telematics Data Service - REST API description: Telematics Data Service REST API. version: 0.1.0 servers: - url: https://api.catenatelematics.com description: Catena Telematics API security: [] tags: - name: Fleet Operations & Tracking description: >- Endpoints for tracking vehicles, trailers, assets, and trip activity — including locations, movements, and operational telemetry. Useful for monitoring utilization and real-time operational status. - name: Safety & Driver Behavior description: >- Endpoints that provide safety-related insights such as harsh braking, speeding, and other driver behavior events. Supports risk analysis and safety program automation. - name: Compliance & Regulation description: >- Endpoints covering regulated requirements including DVIR inspections, Hours of Service (HOS), violations, and IFTA fuel tax reporting. Helps organizations meet DOT/FMCSA and interstate regulatory obligations. - name: Maintenance & Vehicle Health description: >- Endpoints providing data for vehicle condition monitoring and maintenance workflows, such as DVIR defects and diagnostic sensor events. Enables early issue detection and reduced downtime. - name: Drivers & Users description: >- Endpoints related to driver and user identities, assignments, and operational context. Supports linking operational and safety data to specific individuals. - name: Reference Data (Supporting Tables) description: >- Lookup tables and enumerations that supply standardized codes, metadata, and classifications used across the API. - name: Analytics (deprecated) description: >- Endpoints providing analytical insights and aggregated data for vehicles, fleets, drivers, and trailers. paths: /v2/telematics/analytics/fleets: get: tags: - Analytics (deprecated) summary: List fleet summaries description: >- **Deprecated.** Use `/v2/intelligence/analytics/fleets` instead. Retrieve aggregated metrics for each fleet including vehicle counts, driver counts, and connection health. operationId: list_fleet_summaries_deprecated parameters: - name: fleet_ids in: query required: false schema: anyOf: - type: array items: type: string format: uuid maxItems: 100 - type: 'null' description: >- Limit results to specific fleets using Catena's fleet IDs. *For your own fleet identifiers, use `fleet_refs` instead* To specify multiple values, repeat the parameter for each value (e.g., `?fleet_ids=id1&fleet_ids=id2`). title: Fleet Ids description: >- Limit results to specific fleets using Catena's fleet IDs. *For your own fleet identifiers, use `fleet_refs` instead* To specify multiple values, repeat the parameter for each value (e.g., `?fleet_ids=id1&fleet_ids=id2`). - name: fleet_refs in: query required: false schema: anyOf: - type: array items: type: string maxItems: 100 - type: 'null' description: >- Limit results to specific fleets using your organization's fleet reference identifiers. To specify multiple values, repeat the parameter for each value (e.g., `?fleet_refs=ref1&fleet_refs=ref2`). title: Fleet Refs description: >- Limit results to specific fleets using your organization's fleet reference identifiers. To specify multiple values, repeat the parameter for each value (e.g., `?fleet_refs=ref1&fleet_refs=ref2`). - name: connection_id in: query required: false schema: anyOf: - type: string format: uuid - type: 'null' description: >- Limit results to a specific provider connection. This is the UUID assigned by Catena when your fleet connects to a TSP. title: Connection Id description: >- Limit results to a specific provider connection. This is the UUID assigned by Catena when your fleet connects to a TSP. - name: sort_by in: query required: false schema: anyOf: - type: string - type: 'null' description: >- The name of the field to sort results by. If not provided, results will be ordered by `occurred_at`. title: Sort By description: >- The name of the field to sort results by. If not provided, results will be ordered by `occurred_at`. - name: sort_order in: query required: false schema: enum: - asc - desc type: string description: >- The order of sorting, either `asc` for ascending or `desc` for descending. Defaults to `asc` if `sort_by` is provided without `sort_order`. default: asc title: Sort Order description: >- The order of sorting, either `asc` for ascending or `desc` for descending. Defaults to `asc` if `sort_by` is provided without `sort_order`. - name: cursor in: query required: false schema: anyOf: - type: string - type: 'null' description: Cursor for the next page title: Cursor description: Cursor for the next page - name: size in: query required: false schema: type: integer maximum: 1000 minimum: 1 description: Page size default: 300 title: Size description: Page size responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/_CursorPage_FleetSummary_' '400': content: application/json: schema: $ref: '#/components/schemas/BadRequest' description: Bad Request '401': content: application/json: schema: $ref: '#/components/schemas/Unauthorized' description: Unauthorized '403': content: application/json: schema: $ref: '#/components/schemas/Forbidden' description: Forbidden '404': content: application/json: schema: $ref: '#/components/schemas/NotFound' description: Not Found '405': content: application/json: schema: $ref: '#/components/schemas/MethodNotAllowed' description: Method Not Allowed '409': content: application/json: schema: $ref: '#/components/schemas/Conflict' description: Conflict '422': content: application/json: schema: $ref: '#/components/schemas/UnprocessableEntity' description: Unprocessable Entity '429': content: application/json: schema: $ref: '#/components/schemas/TooManyRequests' description: Too Many Requests '500': content: application/json: schema: $ref: '#/components/schemas/InternalServerError' description: Internal Server Error '501': content: application/json: schema: $ref: '#/components/schemas/NotImplementedResponse' description: Not Implemented deprecated: true security: - Bearer: - telematics:read components: schemas: _CursorPage_FleetSummary_: properties: items: items: $ref: '#/components/schemas/FleetSummary' type: array title: Items total: type: integer minimum: 0 title: Total current_page: anyOf: - type: string - type: 'null' title: Current Page description: Cursor to refetch the current page current_page_backwards: anyOf: - type: string - type: 'null' title: Current Page Backwards description: Cursor to refetch the current page starting from the last item previous_page: anyOf: - type: string - type: 'null' title: Previous Page description: Cursor for the previous page next_page: anyOf: - type: string - type: 'null' title: Next Page description: Cursor for the next page type: object required: - items - total title: _CursorPage[FleetSummary] BadRequest: properties: code: type: integer title: Code default: 400 message: type: string title: Message default: Bad Request detail: anyOf: - type: string - type: 'null' title: Detail type: object title: BadRequest Unauthorized: properties: code: type: integer title: Code default: 401 message: type: string title: Message default: Unauthorized detail: anyOf: - type: string - type: 'null' title: Detail type: object title: Unauthorized Forbidden: properties: code: type: integer title: Code default: 403 message: type: string title: Message default: Forbidden detail: anyOf: - type: string - type: 'null' title: Detail type: object title: Forbidden NotFound: properties: code: type: integer title: Code default: 404 message: type: string title: Message default: Not Found detail: anyOf: - type: string - type: 'null' title: Detail type: object title: NotFound MethodNotAllowed: properties: code: type: integer title: Code default: 405 message: type: string title: Message default: Method Not Allowed detail: anyOf: - type: string - type: 'null' title: Detail type: object title: MethodNotAllowed Conflict: properties: code: type: integer title: Code default: 409 message: type: string title: Message default: Conflict detail: anyOf: - type: string - type: 'null' title: Detail type: object title: Conflict UnprocessableEntity: properties: code: type: integer title: Code default: 422 message: type: string title: Message default: Invalid Request Body detail: anyOf: - items: $ref: '#/components/schemas/ValidationErrorDetail' type: array - type: 'null' title: Detail type: object title: UnprocessableEntity TooManyRequests: properties: code: type: integer title: Code default: 429 message: type: string title: Message default: Too Many Requests detail: anyOf: - $ref: '#/components/schemas/RetryAfterDetail' - type: 'null' type: object title: TooManyRequests InternalServerError: properties: message: type: string title: Message default: Internal Server Error type: object title: InternalServerError NotImplementedResponse: properties: code: type: integer title: Code default: 501 message: type: string title: Message default: Not Implemented detail: anyOf: - type: string - type: 'null' title: Detail type: object title: NotImplementedResponse FleetSummary: properties: fleet_ref: anyOf: - type: string - type: 'null' title: Fleet Ref description: >- Your assigned reference ID for this fleet. Null if no reference was provided during connection setup. fleet_ids: items: type: string format: uuid type: array title: Fleet Ids description: >- List of Catena fleet IDs associated with this reference (multiple if the same fleet reconnected). connections: type: integer title: Connections description: Number of active data connections for this fleet. default: 0 drivers: type: integer title: Drivers description: Total number of drivers associated with this fleet. default: 0 vehicles: type: integer title: Vehicles description: Total number of vehicles associated with this fleet. default: 0 vehicles_with_locations: type: integer title: Vehicles With Locations description: >- Number of vehicles that have reported at least one location update (indicates active telematics). default: 0 type: object required: - fleet_ref title: FleetSummary description: |- Aggregated metrics for a fleet, grouped by your fleet reference. Use this to populate fleet management tables or summary cards showing connection health, driver count, vehicle count, and location coverage. ValidationErrorDetail: properties: path: type: string title: Path input: type: string title: Input message: type: string title: Message error_type: type: string title: Error Type type: object required: - path - input - message - error_type title: ValidationErrorDetail RetryAfterDetail: properties: retry_after_seconds: type: integer title: Retry After Seconds message: type: string title: Message type: object required: - retry_after_seconds - message title: RetryAfterDetail securitySchemes: Bearer: type: oauth2 flows: clientCredentials: refreshUrl: >- https://auth.catenatelematics.com/realms/catena/protocol/openid-connect/token scopes: {} tokenUrl: >- https://auth.catenatelematics.com/realms/catena/protocol/openid-connect/token authorizationCode: refreshUrl: >- https://auth.catenatelematics.com/realms/catena/protocol/openid-connect/token scopes: {} authorizationUrl: >- https://auth.catenatelematics.com/realms/catena/protocol/openid-connect/auth tokenUrl: >- https://auth.catenatelematics.com/realms/catena/protocol/openid-connect/token ````