---
title: "List Acquisitions"
method: GET
path: "/acquisitions"
tags: ["Vehicle Acquisitions"]
---

# List Acquisitions

`GET /acquisitions`

## Request

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

Returns a list of your Acquisitions.

## Query parameters

- `start_cursor` string
- `per_page` integer
- `filter` object
  - `acquisition_type` AcquisitionTypeFilter
    - `eq` 'loan' | 'lease', required
  - `reference_number` union
    - object
      - `like` string, required
    - object
      - `eq` string, required
  - `vehicle_id` EqFilter
    - `eq` string, required
  - `lender_id` EqFilter
    - `eq` string, required
  - `vendor_id` EqFilter
    - `eq` string, required
  - `acquisition_date` union
    - object
      - `eq` string, required
    - 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'
  - `acquisition_date` '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
        - `acquisition_type` AcquisitionTypeFilter
          - `eq` 'loan' | 'lease', required
      - object
        - `reference_number` union
          - object
            - `like` string, required
          - object
            - `eq` string, required
      - object
        - `vehicle_id` EqFilter
          - `eq` string, required
      - object
        - `lender_id` EqFilter
          - `eq` string, required
      - object
        - `vendor_id` EqFilter
          - `eq` string, required
      - object
        - `acquisition_date` union
          - object
            - `eq` string, required
          - 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
        - `updated_at` 'asc' | 'desc'
      - object
        - `created_at` 'asc' | 'desc'
      - object
        - `id` 'asc' | 'desc'
  - `records` AcquisitionSummary[]
    - `id` integer
    - `vehicle_id` integer, required
    - `acquisition_type` 'loan' | 'lease', required
    - `vendor_id` integer, nullable, required
    - `lender_id` integer, nullable, required
    - `first_payment_date` string, date, nullable, required: The date of the first payment for the `Acquisition`, if applicable.
    - `number_of_payments` integer, nullable, required: For `lease` type Acquisitions, this number represents the number of months for which the vehicle is leased. For `loan` type Acquisitions, this number represents the number of payments until the loan is paid off.
    - `mileage_cap` integer, nullable, required: For `lease` type Acquisitions, this number represents the number of miles allowed each year, before additional charges will be incurred.
    - `annual_percentage_rate` string, nullable, required: For `loan` type Acquisitions, the annual percentage rate for the loan.
    - `reference_number` string, nullable, required: Optional data for collecting information such as the invoice number, transaction id, or receipt number.
    - `notes` string, nullable, required: Optional free text field for additional notes.
    - `loan_amount_cents` integer, nullable, required: For `loan` type Acquisitions, the total principal amount at the start of the loan.
    - `down_payment_amount_cents` integer, nullable, required: For `loan` type Acquisitions, the amount of the initial down payment.
    - `monthly_cost_cents` integer, nullable, required: Total amount that will be paid each month including any taxes and fees.
    - `capitalized_cost_cents` integer, nullable, required: Capitalized cost per month of the `Vehicle`.
    - `residual_value_cents` integer, nullable, required: For `lease` type Acquisitions, the value of the `Vehicle` at the end of the lease.
    - `purchase_price_cents` integer, nullable, required: For `loan` type Acquisitions, the total purchase price of the `Vehicle`.
    - `mileage_charge_cents` integer, nullable, required: For `lease` type Acquisitions, the amount charged for each mile over the mileage cap.
    - `acquisition_date` string, date, nullable, required: The date on which the Acquisition occurred or began.
    - `acquisition_end_date` string, date, nullable: The date on which the Acquisition ends or is scheduled to end.
    - `vehicle` VehicleMini, required: 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.
    - `lender` VendorMini, nullable, required: 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.
    - `vendor` VendorMini, nullable, required: 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.

## 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 info
  - for the `query` request parameter `per_page`, the min was decreased from `2.00` to `1.00`
- **2025-11-08** `ca477d7c3ebf`: 1 info
  - added the optional property `records/items/acquisition_end_date` to the response with the `200` status

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