List Expenses

A list of all expenses may be obtained using this endpoint. For emphasis on specific results, you can add filters based on business code, expense type, and other variables.

Endpoint

GET https://app.xtrakit.com/api/v1/expenses

Headers

Authorization: Bearer API_KEY

Query Parameters

Parameters	Type	Description
expense_type string	Optional	Filter expenses by expense type.
created_at datetime	Optional	Start date for filtering expenses records (format: YYYY-MM-DD H:m:s)
updated_at date	Optional	End date for filtering expenses records (format: YYYY-MM-DD)

Sample Requests

PHP

<?php
$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://app.xtrakit.com/api/v1/expenses',
  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;

?>

NodeJS

const axios = require('axios');

const config = {
    method: 'get',
    url: 'https://app.xtrakit.com/api/v1/expenses',
    headers: {
        'Authorization': 'Bearer API_KEY' // Replace 'API_KEY' with your actual API key
    }
};

axios(config).then(function(response) {
    console.log(JSON.stringify(response.data));
}).catch(function(error) {
    console.error(error);
});

Python

import requests

url = "https://app.xtrakit.com/api/v1/expenses"

headers = {
    "Authorization": "Bearer API_KEY" # Replace 'API_KEY' with your actual API key
}

response = requests.get(url, headers=headers)
print(response.json())

Sample Response

Success

{
    "status": 200,
    "message": "Expenses found: 20",
    "data": {
        "expenses": {
            "id": 1,
            "user_id": "f93c5a51-ffa4-4aef-a45b-4cdec1c8cc10",
            "business_code": "15848484",
            "expense_type": "Travel",
            "expense_description": "Flight ticket to Kumasi",
            "expense_amount": "200.00",
            "payment_method": "MOMO",
            "expense_image": "https://url-to-image.com/image.jpg",
            "created_by": "Edward",
            "created_at": "2024-08-04 08:23:45",
            "updated_at": "2024-08-04 02:00:43"
        },
        ...
    }
}

Error

{
    "status": 401,
    "error": "Authentication invalid"
},

{
    "status": 401,
    "error": "Unauthorized: Invalid API Key"
}