Fetch Sale
Retrieve a single invoice using this endpoint. By passing the invoice_code to the endpoint.
Endpoint
GET
https://app.xtrakit.com/api/v1/sales/{invoice_code}
Headers
Authorization: Bearer API_KEY
Path Parameters
Parameters
Type
Description
invoice_code
string
Required
An invoice code is a unique code to retrieve a single sale. Should be passed through the URL
Sample Requests
<?php
$invoice_code = 'YOUR_INVOICE_CODE'; // Replace 'YOUR_INVOICE_CODE' with your actual invoice Code
$url = 'https://app.xtrakit.com/api/v1/sales/' . $invoice_code;
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => $url,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_HTTPHEADER => array(
'Authorization: Bearer API_KEY', // Replace 'API_KEY' with your actual API key
'Content-Type: application/json'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>
Sample Response
{
"status": 200,
"message": "Sale found",
"data": {
"sales": {
"id": 32,
"invoice_code": 324232,
"invoice_number": "INV-000001",
"customer_id": "42",
"sub_total_amount": "100.00",
"total_amount": "200.00",
"amount_paid": "200.00",
"discount": "0.00",
"invoice_type": "pos",
"invoice_colour": "#FFFFFF",
"invoice_note": null,
"invoice_terms": "Thanks for doing business",
"payment_internal_note": null,
"payment_date": "2024-08-04",
"payment_type": "2024-08-04",
"payment_status": "paid",
"issued_by": "Jones Nathal",
"due_date": "2024-08-30",
"reminder_date": "2024-08-25",
"reminder_message": null,
"created_at": "2024-08-04 08:23:45",
"updated_at": "2024-08-04 02:00:43"
},
"sales-item": [
{
"id": 45,
"invoice_code": "324232",
"invoice_number": "INV-000001",
"item_name": "Web Design",
"description": "Including hosting",
"unit_price": "100.00",
"quantity": "2",
"tax": "0.00",
"created_at": "2024-08-04 08:23:45",
"updated_at": "2024-08-04 02:00:43"
},
...
],
"sales-payment": [
{
"invoice_code": "324232",
"customer_name": "Peter Amos",
"amount_paid": "200.00",
"payment_method": "Cash",
"internal_payment_note": null,
"issued_by": "Jones Nathal",
"payment_at": "2024-08-04 08:23:45",
"created_at": "2024-08-04 08:23:45",
"updated_at": "2024-08-04 02:00:43"
},
...
]
}
}
Last updated