This endpoint retrieves detailed information about a specific deduction record by its unique identifier. Use this method to view all deduction details including amount, category, associated driver or truck, payment status, and creation metadata.

Deductions are asset-specific financial adjustments and can be associated with either a driver or a truck, but not both simultaneously.

Request Parameters

The following parameters are required in the URL path or query:

Parameter	Type	Required	Description
version	String	Yes	The API version to use.
id	String	Yes	The unique identifier (`Id`) of the deduction to retrieve.

Example CURL Request

curl --location 'https://integrations.alvys.com/api/p/v1/deductions/00000000-dd44-0000-0000-8a1fa91b607a' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Response Body Parameters

The following parameters are included in the response body:

Parameter	Type	Required	Description
Id	String	Yes	The unique identifier of the deduction.
Type	String	Yes	Type of record (`"Deduction"`).
GroupId	String	No	Group ID if the deduction belongs to a recurring group or rule.
Description	String	Yes	Description of the deduction.
Category	String	Yes	Deduction category (e.g., Fuel, Advance, Drug Test).
Amount.Amount	Number	Yes	Deduction amount (negative for deductions).
Amount.Currency	Integer	Yes	ISO numeric currency code (e.g., 840 for USD).
DriverId	String	Conditionally	The Driver ID linked to the deduction.
TruckId	String	Conditionally	The Truck ID linked to the deduction.
OwnerOperatorId	String	No	The Owner Operator ID of the truck or driver.
Date	String (Date)	Yes	The effective date of the deduction (date only, without time).
IsPaid	Boolean	No	Indicates whether the deduction has been paid.
CreatedAt	String (Date-Time)	No	Timestamp when the deduction was created (UTC).
CreatedBy	String	Yes	Client ID or User ID of the person who created the deduction.

Example Response

{
  "Id": "00000000-dd44-0000-0000-8a1fa91b607a",
  "Type": "Deduction",
  "GroupId": "344571de-57b4-4163-a0cc-d7981fa65994",
  "Description": "Drug Test Fee",
  "Category": "Drug Test",
  "Amount": {
    "Amount": -50,
    "Currency": 840
  },
  "DriverId": "DR2517534557938191",
  "OwnerOperatorId": "DR25165000003445290",
  "Date": "2025-10-07",
  "IsPaid": false,
  "CreatedAt": "2025-10-09T08:30:54.873Z",
  "CreatedBy": "MhAeS5345435fbvccvbfUdTdXOMgVSGyp"
}

Versioning

The version parameter in the URL path specifies which version of the API you are using. Including the version number ensures that your integration remains stable as the API evolves. For more details, refer to the Versioning page.

Rate Limits

All endpoints are subject to standard rate limits to ensure consistent API performance. For details, see the Rate Limits section.

200OK

400Bad Request

404Not Found

422Unprocessable Content