---
title: "List Service Entries"
method: GET
path: "/service_entries"
tags: ["Service Entries"]
---

# List Service Entries

`GET /service_entries`

## Request

- Base URL: `https://secure.fleetio.com/api`
- URL: `https://secure.fleetio.com/api/service_entries`
- Auth: API key in header `Authorization` and API key in header `Account-Token`
- TypeScript: <https://skmtc.dev/fleetio/apis/fleetio-developer-api/docs/service_entries/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a list of Service Entries belonging to your account.

## Query parameters

- `start_cursor` string
- `per_page` integer
- `filter` object
  - `reference` union
    - object
      - `like` string, required
    - object
      - `eq` string, required
  - `status` IncludeFilter
    - `include` string, required
  - `labels` IncludeFilter
    - `include` string, required
  - `completed_at` union
    - object
      - `lt` string, required
    - object
      - `lte` string, required
    - object
      - `gt` string, required
    - object
      - `gte` string, required
  - `created_at` union
    - object
      - `lt` string, required
    - object
      - `lte` string, required
    - object
      - `gt` string, required
    - object
      - `gte` string, required
  - `updated_at` union
    - object
      - `lt` string, required
    - object
      - `lte` string, required
    - object
      - `gt` string, required
    - object
      - `gte` string, required
- `sort` object
  - `id` 'asc' | 'desc'
  - `completed_at` 'asc' | 'desc'
  - `updated_at` 'asc' | 'desc'
  - `created_at` 'asc' | 'desc'

## Response `200`

OK

- object
  - `start_cursor` string, nullable: The current start cursor of the records returned.
  - `next_cursor` string, nullable: The next cursor to retrieve the next page of records.
  - `per_page` integer: The maximum number of records returned.
  - `estimated_remaining_count` integer: The number of remaining records including the returned records, up to a maximum of 500.
  - `filtered_by` union[]: The filters applied to the returned record set.
    - union
      - object
        - `reference` union
          - object
            - `like` string, required
          - object
            - `eq` string, required
      - object
        - `status` IncludeFilter
          - `include` string, required
      - object
        - `labels` IncludeFilter
          - `include` string, required
      - object
        - `completed_at` union
          - object
            - `lt` string, required
          - object
            - `lte` string, required
          - object
            - `gt` string, required
          - object
            - `gte` string, required
      - object
        - `created_at` union
          - object
            - `lt` string, required
          - object
            - `lte` string, required
          - object
            - `gt` string, required
          - object
            - `gte` string, required
      - object
        - `updated_at` union
          - object
            - `lt` string, required
          - object
            - `lte` string, required
          - object
            - `gt` string, required
          - object
            - `gte` string, required
  - `sorted_by` union[]: The sorts applied to the returned record set.
    - union
      - object
        - `completed_at` 'asc' | 'desc'
      - object
        - `updated_at` 'asc' | 'desc'
      - object
        - `created_at` 'asc' | 'desc'
      - object
        - `id` 'asc' | 'desc'
  - `records` ServiceEntrySummary[]
    - `auto_integrate_repair_order_status` 'approved' | 'auto_approved' | 'awaiting_reconciliation' | 'awaiting_invoice' | 'awaiting_payment' | 'completed' | 'failed_reconciliation' | 'invoiced' | 'needs_approval' | 'needs_reapproval' | 'paid' | 'rejected', nullable, required: The Auto Integrate `Repair Order` status for this Service Entry.
    - `images_count` integer, required: The number of images associated with this Service Entry.
    - `documents_count` integer, required: The number of documents associated with this Service Entry.
    - `comments_count` integer, required: The number of comments associated with this Service Entry.
    - `id` integer, required
    - `completed_at` string, date-time, nullable, required: The date and time at which the Service Entry was completed.
    - `reference` string, nullable, required: A reference number for this Service Entry.
    - `started_at` string, date-time, nullable, required: The date and time at which the Service Entry was started.
    - `status` 'pending' | 'completed', required: The status of this Service Entry.
    - `general_notes` string, nullable, required: General notes for this Service Entry.
    - `vehicle_id` integer, required
    - `vendor_id` integer, nullable, required
    - `work_order_id` integer, nullable, required
    - `is_sample` boolean, required: Indicates whether or not this Service Entry is a sample. Sample Service Entries are not included in reports.
    - `primary_meter_entry` VehicleMeterEntry, nullable, required: A Meter Entry
      - `id` integer
      - `created_at` string, date-time
      - `updated_at` string, date-time
      - `auto_voided_at` string, date-time, nullable: The date and time at which this Meter Entry was automatically voided. Formatted according to ISO-8601 in `User`'s local time.
      - `category` 'starting' | 'ending' | 'nightly' | 'manual', nullable: A category to describe the function of this Meter Entry.
      - `meter_type` 'secondary', nullable: Indicates whether or not this Meter is a secondary Meter.
      - `meterable_id` integer, nullable
      - `meterable_type` 'FuelEntry' | 'Issue' | 'PurchaseDetail' | 'ServiceEntry' | 'SubmittedInspectionItem' | 'VehicleAssignment' | 'WorkOrder', nullable: The type of the object with which this Meter Entry is associated.
      - `value` string: The current value of the meter.
      - `vehicle_id` integer, nullable
      - `void` boolean: Indicates whether or not this Meter Entry has been voided.
      - `type` 'GpsMeterEntry', nullable
      - `date` string, date: The date on which this Meter Entry was recorded. Formatted according to ISO-8601.
    - `secondary_meter_entry` VehicleMeterEntry, nullable: A Meter Entry
      - `id` integer
      - `created_at` string, date-time
      - `updated_at` string, date-time
      - `auto_voided_at` string, date-time, nullable: The date and time at which this Meter Entry was automatically voided. Formatted according to ISO-8601 in `User`'s local time.
      - `category` 'starting' | 'ending' | 'nightly' | 'manual', nullable: A category to describe the function of this Meter Entry.
      - `meter_type` 'secondary', nullable: Indicates whether or not this Meter is a secondary Meter.
      - `meterable_id` integer, nullable
      - `meterable_type` 'FuelEntry' | 'Issue' | 'PurchaseDetail' | 'ServiceEntry' | 'SubmittedInspectionItem' | 'VehicleAssignment' | 'WorkOrder', nullable: The type of the object with which this Meter Entry is associated.
      - `value` string: The current value of the meter.
      - `vehicle_id` integer, nullable
      - `void` boolean: Indicates whether or not this Meter Entry has been voided.
      - `type` 'GpsMeterEntry', nullable
      - `date` string, date: The date on which this Meter Entry was recorded. Formatted according to ISO-8601.
    - `attachment_permissions` AttachmentPermissions, nullable
      - `read_photos` boolean: Indicates whether the user has read permission for photos.
      - `manage_photos` boolean: Indicates whether the user has permission to manage (eg. upload, delete) photos.
      - `read_documents` boolean: Indicates whether the user has read permission for documents.
      - `manage_documents` boolean: Indicates whether the user has permission to manage (eg. upload, delete) documents.
    - `custom_fields` CustomFields, nullable: *Full details on working with Custom Fields [here](/docs/overview/custom-fields).
    - `labels` object[], required
      - `id` integer
      - `name` string
    - `vendor` VendorMini, nullable: A Vendor
      - `name` string, required: The name of the Vendor.
      - `phone` string, nullable, required: The phone number of the Vendor.
      - `city` string, nullable, required: The city of the Vendor.
      - `region` string, nullable, required: The region, state, province, or territory of the Vendor.
      - `postal_code` string, nullable, required: The postal code or ZIP code of the Vendor.
      - `country` string, nullable, required: The country of the Vendor.
      - `external_id` string, nullable, required: The external identifier of the Vendor.
    - `vehicle` VehicleMini: A Vehicle
      - `id` integer, required
      - `name` string, required: This vehicle's name.
      - `color` string, nullable: The color of this Vehicle.
      - `license_plate` string, nullable: The license plate number of this Vehicle.
      - `vin` string, nullable: The Vehicle Identification Number of this Vehicle.
      - `year` string, nullable: This Vehicle's model year.
      - `make` string, nullable: The name of this Vehicle's manufacturer.
      - `model` string, nullable: The name of the model of this Vehicle.
      - `trim` string, nullable: The trim level of this Vehicle.
      - `registration_expiration_month` integer, nullable: The month in which this Vehicle's registration expires.
      - `registration_state` string, nullable: The state, province, or territory in which this Vehicle is registered.
      - `default_image_url_small` string, nullable: The URL of a small-sized version of the default image for this Vehicle.
    - `discount_type` 'fixed' | 'percentage', nullable: The type of discount applied to this record.
    - `discount_percentage` string, nullable: The discount percentage. This field should be present when `discount_type` is set to `percentage`.
    - `tax_1_type` string: The primary tax type.
    - `tax_1_percentage` string, nullable: The primary tax percentage.
    - `tax_2_type` string, nullable: The secondary tax type.
    - `tax_2_percentage` string, nullable: The secondary tax percentage.
    - `labor_subtotal_cents` integer: The pre-tax subtotal amount for labor.
    - `parts_subtotal_cents` integer: The pre-tax subtotal amount for parts.
    - `fees_cents` integer: The fees amount. This is the sum of any `ServiceEntryFeeLineItem`s present.
    - `subtotal_cents` integer: The pre-tax subtotal amount.
    - `discount_cents` integer: The discount amount.
    - `tax_1_cents` integer: The primary tax amount.
    - `tax_2_cents` integer: The secondary tax amount.
    - `total_amount_cents` integer: The total amount.
    - `labor_time_in_seconds` integer, nullable: The sum, in seconds, of the duration of all labor line items of the Work Order that created this Service Entry, if applicable. This field is only relevant when the Service Entry is created from a Work Order.

## Other responses

- `400`: The format or parameters of the request was invalid
- `401`: Request could not be authenticated
- `500`: Something unexpected happened

## Changes

- **2026-11-06** `49558d744bd7`: 5 info
  - for the `query` request parameter `per_page`, the min was decreased from `2.00` to `1.00`
  - added the required property `records/items/auto_integrate_repair_order_status` to the response with the `200` status
  - added the required property `records/items/comments_count` to the response with the `200` status
  - added the required property `records/items/documents_count` to the response with the `200` status
  - …1 more

[Operation history](https://skmtc.dev/fleetio/apis/fleetio-developer-api/changes/service_entries/get.md)

---

[API](https://skmtc.dev/fleetio/apis/fleetio-developer-api.md) - [All operations](https://skmtc.dev/fleetio/apis/fleetio-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fleetio/apis/fleetio-developer-api/revisions/49558d744bd7?raw)