--- title: "Get sale (including credit note)" method: GET path: "/sales/{sale_id}" tags: ["Sales"] --- # Get sale (including credit note) `GET /sales/{sale_id}` ## Request - Base URL: `https://api.digitax.tech/ke/v2` - URL: `https://api.digitax.tech/ke/v2/sales/{sale_id}` - Auth: API key in header `X-API-Key` Retrieves a specific sale by its ID, including credit notes. ## Path parameters - `sale_id` string, required: The DigiTax ID of the sale. ## Response `200` Success - Sale - `id` string, required: The DigiTax ID of the sale. - `date` string, required: The receipt date (DD/MM/YYYY), as printed on the physical receipt - `time` string, required: The time shown on the receipt. - `trader_invoice_number` string, required: The invoice reference from your system. It must be unique across sales and credit notes in the business. References from failed transactions can be reused. - `receipt_type_code` string, required: The code identifying the receipt type, such as S for an invoice or R for a credit note. - `credit_note_reason` string: The reason code for the credit note. Values are `01` (Missing Quantity), `02` (Missing Data), `03` (Damaged), `04` (Wasted), `05` (Material Shortage), and `06` (Refund). - `sale_detail_url` string, url, required: The URL for accessing the sale details. - `serial_number` string, required: The receipt serial number issued by KRA. - `receipt_number` integer, required: The receipt number associated with the sale. - `invoice_number` integer, required: The invoice number associated with the sale. - `customer_id` string, required: The DigiTax ID of the customer associated with the sale. - `customer_name` string, required: The name of the customer associated with the sale. - `customer_tin` string, required: The tax identification number of the customer. - `customer_phone_number` string: The customer's phone number. - `customer_email` string: The customer's email address. - `internal_data` string, required: The internal data returned for the sale. - `receipt_signature` string, required: The signature associated with the receipt. - `etims_url` string, url, required: The URL for viewing the receipt in the eTIMS. - `original_sale_id` string: The DigiTax ID of the original sale. - `offline_url` string, url: The URL for accessing the sale receipt offline. - `status` 'PENDING' | 'FAILED' | 'COMPLETED': status against KRA - `sales_tax_summary` object, required: Taxable amounts, tax rates, and tax amounts grouped by tax category. - `taxable_amount_a` number, required: Total taxable amount for exempt items (tax type A). - `taxable_amount_b` number, required: Total taxable amount for items subject to 16% VAT (tax type B). - `taxable_amount_c` number, required: Total taxable amount for zero-rated items (tax type C). - `taxable_amount_d` number, required: Total taxable amount for non-VAT items (tax type D). - `taxable_amount_e` number, required: Total taxable amount for items subject to 8% VAT (tax type E). - `tax_rate_a` integer, required: Tax rate percentage for exempt items (tax type A). - `tax_rate_b` integer, required: Tax rate percentage for items subject to 16% VAT (tax type B). - `tax_rate_c` integer, required: Tax rate percentage for zero-rated items (tax type C). - `tax_rate_d` integer, required: Tax rate percentage for non-VAT items (tax type D). - `tax_rate_e` integer, required: Tax rate percentage for items subject to 8% VAT (tax type E). - `catering_levy_rate` integer: The catering levy rate applied to the sale. - `service_charge_rate` integer: The service charge rate associated with the sale. - `tax_amount_a` number, required: Total tax amount for exempt items (tax type A). - `tax_amount_b` number, required: Total tax amount for items subject to 16% VAT (tax type B). - `tax_amount_c` number, required: Total tax amount for zero-rated items (tax type C). - `tax_amount_d` number, required: Total tax amount for non-VAT items (tax type D). - `tax_amount_e` number, required: Total tax amount for items subject to 8% VAT (tax type E). - `catering_levy_amount` number: The total catering levy amount for the sale. - `service_charge_amount` number: The total service charge amount for the sale. - `item_list` SaleItem[]: The list of items included in the sale. - `id` string, required: The DigiTax ID of the sale item. - `quantity` number, required: The quantity of the item sold. - `unit_price` number, required: The price per unit. - `total_amount` number, required: The total amount for the sale item. - `taxable_amount` number, required: The amount subject to tax. - `tax_amount` number, required: The total tax amount for the sale item. - `tax_rate` number, required: The tax rate percentage applied to the sale item. - `tax_type_code` string, required: The code identifying the tax category applied to the sale item. - `discount_rate` number, required: The discount rate applied to the sale item. - `discount_amount` number, required: The discount amount for the sale item. - `etims_item_code` string, required: The item code used to identify the item in eTIMS. - `is_stockable` boolean, required: Indicates whether the item is stockable, meaning its quantity can be tracked as inventory. Physical goods are stockable; services are not. - `item_id` string, required: The DigiTax ID of the item associated with the sale. - `kra_response_message` string: The optional KRA-provided error message. This is only provided if a sale has failed. ## Other responses - `default`: Error response ## Changes - **2026-11-03** `6a186b8718c5`: 2 info - added the optional property `credit_note_reason` to the response with the `200` status - added the optional property `kra_response_message` to the response with the `200` status [Operation history](https://skmtc.dev/digitax/apis/digitax-kenya-api-endpoints/changes/sales/:sale_id/get.md) --- [API](https://skmtc.dev/digitax/apis/digitax-kenya-api-endpoints.md) - [All operations](https://skmtc.dev/digitax/apis/digitax-kenya-api-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/digitax/apis/digitax-kenya-api-endpoints/revisions/6a186b8718c5?raw)