--- title: "Create Acquisition" method: POST path: "/acquisitions" tags: ["Vehicle Acquisitions"] --- # Create Acquisition `POST /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: (a function with typed inputs; its response is checked against the schema) Creates a new Acquisition ## Request body - object - `acquisition_type` 'loan' | 'lease', required: The acquisition type of the asset. - `vehicle_id` integer, required - `vendor_id` integer, nullable - `lender_id` integer, nullable - `monthly_cost` number, float: Total amount that will be paid each month including any taxes and fees. - `capitalized_cost` number, float: Capitalized cost per month of the `Vehicle`. - `down_payment_amount` number, float: For `loan` type Acquisitions, the amount of the initial down payment. - `residual_value` number, float: For `lease` type Acquisitions, the value of the Vehicle at the end of the lease. - `purchase_price` number, float: For `loan` type Acquisitions, the total purchase price of the `Vehicle`. - `acquisition_date` string, date: The date on which the Acquisition occurred or began. - `acquisition_end_date` string, date: The date on which the Acquisition ends or is scheduled to end. We recommend using [ISO-8601](/docs/overview/date-formatting) formatted dates to avoid ambiguity. - `first_payment_date` string, date: The date of the first payment for the Acquisition, if applicable. We recommend using [ISO-8601](/docs/overview/date-formatting) formatted dates to avoid ambiguity. - `number_of_payments` integer: 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: For `lease` type Acquisitions, this number represents the number of miles allowed each year, before additional charges will be incurred. - `loan_amount` number, float: For `loan` type Acquisitions, the total principal amount at the start of the loan. - `mileage_charge` number, float: For `lease` type Acquisitions, the amount charged for each mile over the mileage cap. - `annual_percentage_rate` number, float: For `loan` type acquisitions, the annual percentage rate for the loan. - `reference_number` string: Optional data for collecting information such as the invoice number, transaction id, or receipt number. - `notes` string: Optional free text field for additional notes. ## Response `200` OK - Acquisition: An Acquisition - `id` integer - `vehicle_id` integer, required - `acquisition_type` 'loan' | 'lease', required: The acquisition type of the asset. - `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` number, float, 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` number, float, nullable, required: For `loan` type Acquisitions, the total principal amount at the start of the loan. - `down_payment_amount` number, float, nullable, required: For `loan` type Acquisitions, the amount of the initial down payment. - `monthly_cost` number, float, nullable, required: Total amount that will be paid each month including any taxes and fees. - `capitalized_cost` number, float, nullable, required: Capitalized cost per month of the `Vehicle`. - `residual_value` number, float, nullable, required: For `lease` type Acquisitions, the value of the `Vehicle` at the end of the lease. - `purchase_price` number, float, nullable, required: For `loan` type Acquisitions, the total purchase price of the `Vehicle`. - `mileage_charge` number, float, 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` object, nullable, required: The `Vehicle` related to the Acquisition. - `lender` object, nullable, required: The `Lender` related to the Acquisition. - `vendor` object, nullable, required: The `Vendor` related to the Acquisition. ## Other responses - `401`: Request could not be authenticated - `403`: Insufficient permission to perform this operation - `422`: Unprocessable Entity - `500`: Something unexpected happened ## Changes - **2025-11-08** `ca477d7c3ebf`: 2 info - added the new optional request property `acquisition_end_date` - added the optional property `acquisition_end_date` to the response with the `200` status [Operation history](https://skmtc.dev/fleetio/apis/fleetio-developer-api/changes/acquisitions/post.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)