# Add Expense

## Endpoint

<mark style="color:yellow;">**`POST`**</mark> `https://api.xtrakit.com/api/v1/expenses/add`

## Headers

`Authorization: Bearer API_KEY`

## **Body Parameters**

<table><thead><tr><th>Parameters</th><th width="100">Type</th><th>Description</th></tr></thead><tbody><tr><td><p>expense_type</p><p><em><strong>string</strong></em></p></td><td>Required</td><td>The type of the expense.</td></tr><tr><td><p>expense_description</p><p><em><strong>string</strong></em></p></td><td>Optional</td><td>A detailed description of the expense.</td></tr><tr><td><p>expense_amount</p><p><em><strong>decimal(10,2)</strong></em></p></td><td>Required</td><td>The amount of the expense  in this format: <code>10.00</code></td></tr><tr><td><p>payment_method</p><p><em><strong>string</strong></em></p></td><td>Required</td><td>The method used for payment.</td></tr><tr><td><p>expense_image</p><p><em><strong>string</strong></em></p></td><td>Optional</td><td>URL to an image or receipt associated with the expense.</td></tr><tr><td><p>created_by</p><p><em><strong>string</strong></em></p></td><td>Required</td><td>The user who created the record.</td></tr></tbody></table>

## Sample Requests <a href="#sample-requests" id="sample-requests"></a>

{% tabs %}
{% tab title="PHP" %}
{% code fullWidth="true" %}

```php
<?php

$data = [
  'expense_type' => "Office Supplies",
  'expense_description' => 'Purchased new printer ink'
  'expense_amount' => "200.00", 
  'payment_method' => "MOMO", 
  'expense_image' => "https://url-to-image.com/image.jpg", 
  'created_by' => "Benjamin" 
  ];

$url = 'https://api.xtrakit.com/api/v1/expenses/add';

$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 => 'POST',
  CURLOPT_POSTFIELDS => $data,
  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;

?>

```

{% endcode %}
{% endtab %}

{% tab title="NodeJS" %}

```javascript
const axios = require('axios');

const data = {
  'expense_type': "Office Supplies",
  'expense_description': 'Purchased new printer ink'
  'expense_amount': "200.00", 
  'payment_method': "MOMO", 
  'expense_image': "https://url-to-image.com/image.jpg", 
  'created_by': "Benjamin" 
  };

const config = {
    method: 'post',
    url: `https://api.xtrakit.com/api/v1/expenses/add`,
    headers: {
        'Authorization': 'Bearer API_KEY', // Replace 'API_KEY' with your actual API key
        "Content-Type": "application/json"
    },
    data: data 
};

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

{% endtab %}

{% tab title="Python" %}

```python
import requests

data = {
  'expense_type': "Office Supplies",
  'expense_description': 'Purchased new printer ink'
  'expense_amount': "200.00", 
  'payment_method': "MOMO", 
  'expense_image': "https://url-to-image.com/image.jpg", 
  'created_by': "Benjamin" 
  }

url = f'https://api.xtrakit.com/api/v1/expenses/add'

headers = {
    "Authorization": "Bearer API_KEY" # Replace 'API_KEY' with your actual API key
    "Content-Type": "application/json"
}

try:
    response = requests.post(url, headers=headers, json=data)
    print(response.json())
except requests.exceptions.RequestException as e:
    print(e)
```

{% endtab %}
{% endtabs %}

## Sample Response

{% tabs %}
{% tab title="Success" %}

```json
{
    "status": 200,
    "message": "Expense added successfully",
    "data": {
        "expense": {
            "id": 2,
            "expense_type": "Office Supplies",
            "expense_description": "Purchased new printer ink",
            "expense_amount": "200.00",
            "payment_method": "MOMO",
            "expense_image": "https://url-to-image.com/image.jpg",
            "created_by": "Benjamin",
            "created_at": "2024-08-04 08:23:45",
            "updated_at": "2024-08-04 02:00:43"
        }
    }
}
```

{% endtab %}

{% tab title="Error" %}

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

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

{% endtab %}
{% endtabs %}