---
title: "List Accounts"
method: GET
path: "/accounts"
tags: ["Accounts"]
---

# List Accounts

`GET /accounts`

## Request

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

Allows you to see information about the corresponding account(s) related to
a given API key or Organization, such as the company name and address.

:::info
This endpoint does not require you to pass in the `Account-Token`
header. When not using an Organization Token, the API key must be
passed in via the Authorization header as this API key is
what is used to lookup the associated accounts.

If this endpoint is authenticated using an Organization Token, all owner account
memberships for accounts associated with the organization will be returned.
:::

## Query parameters

- `start_cursor` string
- `per_page` integer
- `filter` object
  - `account_name` union
    - object
      - `like` string, required
    - object
      - `eq` string, required
  - `account_url_token` EqFilter
    - `eq` 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'
  - `created_at` 'asc' | 'desc'
  - `updated_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
        - `account_name` union
          - object
            - `like` string, required
          - object
            - `eq` string, required
      - object
        - `account_url_token` EqFilter
          - `eq` 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
        - `updated_at` 'asc' | 'desc'
      - object
        - `created_at` 'asc' | 'desc'
      - object
        - `id` 'asc' | 'desc'
  - `records` Account[]
    - `id` integer
    - `created_at` string, date-time: The date and time at which this record was created.
    - `updated_at` string, date-time: The date and time at which this record was most recently updated.
    - `account_membership_id` integer
    - `name` string, required: The name of the Account.
    - `logo_url` string, nullable: The logo of the Account.
    - `user_type` 'admin' | 'owner' | 'regular' | 'guest', required: The membership type of the current `User`.
    - `token` string, required: The URL token used to identify the Account.
    - `time_24_format` boolean, required: Whether or not this Account uses 24 hour time format.
    - `currency_symbol` string, required: The default currency symbols used by the Account.
    - `organization_id` integer, nullable: The ID of the organization this Account belongs to.
    - `organization_type` 'channel_reseller' | 'simple_reseller' | 'vendor_partner', nullable
    - `city` string, nullable, required: The city the Account belongs to.
    - `region` string, nullable, required: The region the Account belongs to.
    - `postal_code` string, nullable, required: The postal code or ZIP code the Account belongs to.
    - `street_address` string, nullable, required: The street address of the Account.
    - `street_address_line_2` string, nullable: Street address line 2 of the Account.
    - `country` string, nullable, required: The country of the Account.
    - `read_vehicles` boolean, required: Whether or not the Account can view Vehicles.
    - `manage_vehicles` boolean, required: Whether or not the Account can manage Vehicles.
    - `create_vehicles` boolean, required: Whether or not the Account can create Vehicles.
    - `read_fuel_entries` boolean, required: Whether or not the Account can view Fuel Entries.
    - `manage_fuel_entries` boolean, required: Whether or not the Account can manage Fuel Entries.
    - `read_service_entries` boolean, required: Whether or not the Account can view Service Entries.
    - `manage_service_entries` boolean, required: Whether or not the Account can manage Service Entries.
    - `read_issues` boolean, required: Whether or not the Account can view Issues.
    - `manage_issues` boolean, required: Whether or not the Account can manage Issues.
    - `read_work_orders` boolean, required: Whether or not the Account can view Work Orders.
    - `manage_work_orders` boolean, required: Whether or not the Account can manage Work Orders.
    - `read_service_reminders` boolean, required: Whether or not the Account can view Service Reminders.
    - `manage_service_reminders` boolean, required: Whether or not the Account can manage Service Reminders.
    - `read_vehicle_renewal_reminders` boolean, required: Whether or not the Account can view Vehicle Renewal Reminders.
    - `manage_vehicle_renewal_reminders` boolean, required: Whether or not the Account can manage Vehicle Renewal Reminders.
    - `read_comments` boolean, required: Whether or not the Account can view Comments.
    - `manage_comments` boolean, required: Whether or not the Account can manage Comments.
    - `read_meter_entries` boolean, required: Whether or not the Account can view Meter Entries.
    - `manage_meter_entries` boolean, required: Whether or not the Account can manage Meter Entries.
    - `read_groups` boolean, required: Whether or not the Account can view Groups.
    - `read_contacts` boolean, required: Whether or not the Account can view Contacts.
    - `fleetio_manage` boolean, required: Whether or not the Account is subscribed to a Fleetio plan.
    - `inspections` boolean, required: Whether or not the Account has inspections enabled.
    - `update_parts` boolean, required: Whether or not the Account can update Parts.
    - `update_inventory` boolean, required: Whether or not the Account can update inventory.
    - `allowed_part_location_ids` integer[], required: The Part Locations allowed to be updated.
    - `new_inventory_permissions` boolean, required: Whether or not the Account can create new inventory.
    - `plan` string, required: The name of the Account's currently active Subscription Plan.
    - `state` 'trialing' | 'assessing' | 'active' | 'past_due' | 'soft_failure', required: The state of the Account's Subscription.
    - `default_meter_unit` string, nullable, required: The default meter volume unit used by the Account.
    - `default_fuel_volume_unit` string, nullable, required: The default fuel volume unit used by the Account.
    - `default_system_of_measurement` 'imperial' | 'metric', nullable, required: The default system of measurement used by the Account.
    - `tax_settings` object, required
      - `tax_free_labor` boolean, nullable: Configure's whether or not to include labor costs when calculating taxes. [More info](https://help.fleetio.com/s/article/Account-Settings#tax)
      - `tax_2` boolean, nullable: Enables a secondary tax field option (Tax 2) when calculating the total amount for Work Orders and Service Entries. [More info](https://help.fleetio.com/s/article/Account-Settings#tax)
      - `default_tax_1` string, nullable: Specify the value to be used automatically in the _Tax 1_ field for [Work Orders](/docs/api/work-orders) and [Service Entries](/docs/api/service-entries). This is the default but this tax can be changed per record. [More info](https://help.fleetio.com/s/article/Account-Settings#tax)
      - `default_tax_2` string, nullable: Specify the value to be used automatically in the _Tax 2_ field for [Work Orders](/docs/api/work-orders) and [Service Entries](/docs/api/service-entries). This is the default but this tax can be changed per record. [More info](https://help.fleetio.com/s/article/Account-Settings#tax)
      - `default_tax_type` 'fixed' | 'percentage', nullable: Specify if the default setting for charging sales tax on [Work Orders](/docs/api/work-orders) and [Service Entries](/docs/api/service-entries) is a fixed amount, or a percentage. This is the default but this can be changed per record. [More info](https://help.fleetio.com/s/article/Account-Settings#tax)
    - `next_work_order_number` integer, required: What the next `Work Order`'s number will be in the sequence.
    - `offline_inspections` boolean, nullable, required: Whether or not the Account can perform offline inspections.
    - `inspections_new_item_type_beta` boolean, nullable, required
    - `paying_customer` boolean, nullable, required: Whether or not the Account is a paying customer.
    - `is_demo` boolean, nullable, required: Whether or not the Account is in demo mode.
    - `require_group` boolean, nullable, required: Whether or not `Contacts`/`Users` must be assigned to a `Group`.
    - `require_a_meter_entry_on_service_entry_or_completed_work_order` boolean, nullable, required: Whether or not a `Meter Entry` is required when submitting a `Service Entry` or completed `Work Order`.
    - `excluded_vehicle_type_ids_from_required_meter_readings` integer[], required: The `Vehicle Type` ids exempt from the `Meter Entry` requirement above. Empty when no exclusions are configured.
    - `excluded_vehicle_type_ids_from_required_repair_priority_class` integer[], required: The `Vehicle Type` ids exempt from the `Repair Priority Class` requirement. Empty when no exclusions are configured.
    - `has_ro_notification_subscription` boolean, nullable, required: Whether or not the Account is subscribed to `Repair Order` notifications.
    - `require_an_inventory_location_on_wo_part_line_items` boolean, nullable, required: Whether or not a `Part` line item on a `Work Order` must have a location.
    - `use_forecasted_dates_for_service_reminders` boolean, nullable, required: Whether or not forecasted dates are used for `Service Reminders`.
    - `require_a_rpc_on_service_entry_or_completed_work_order` boolean, nullable, required: Whether or not a repair priority class is required when submitting a `Service Entry` or completed `Work Order`.
    - `vmrs_system_enabled` boolean, nullable, required: Whether or not the Vehicle Maintenance Reporting Standards system is enabled.
    - `vmrs_assembly_enabled` boolean, nullable, required: Whether or not the VMRS assembly element identification is enabled.
    - `vmrs_component_enabled` boolean, nullable, required: Whether or not the VMRS component identification is enabled.
    - `disable_reason_for_repair_editing` boolean, nullable, required: Whether or not the reason for repair can be edited.
    - `disable_system_assembly_component_editing` boolean, nullable, required: Whether or not the VMRS assembly or component information can be edited.
    - `require_vmrs_reason_for_repair_on_service_line_items_as_of` string, datetime, nullable, required: The date when the VMRS reason for repair is required on service line items. If `null`, the VMRS reason for repair is not required.
    - `require_vmrs_system_group_on_service_line_items_as_of` string, datetime, nullable, required: The date when the VMRS system group is required on service line items. If `null`, the VMRS system group is not required.
    - `go_session_timeout_minutes` string, nullable: The amount of time in minutes that should pass before a `User` is required to log in again on Fleetio Go. If value is an empty string, the session does not timeout.
    - `live_map_enabled` boolean, required: Whether or not the live vehicle location map is enabled for the Account.

## 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`: 1 warning, 4 info
  - added the new `vendor_partner` enum value to the `records/items/organization_type` response property for the response status `200`
  - for the `query` request parameter `per_page`, the min was decreased from `2.00` to `1.00`
  - added the required property `records/items/excluded_vehicle_type_ids_from_required_meter_readings` to the response with the `200` status
  - added the required property `records/items/excluded_vehicle_type_ids_from_required_repair_priority_class` to the response with the `200` status
  - …1 more
- **2025-09-06** `6daa53a03224`: 2 info
  - added the optional property `records/items/organization_id` to the response with the `200` status
  - added the optional property `records/items/organization_type` to the response with the `200` status

[Operation history](https://skmtc.dev/fleetio/apis/fleetio-developer-api/changes/accounts/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)