💸 Expenses

Expense recording and management

List expenses

get

/api/v1.0/organisation/{org_id}/expenses/

List all expenses for an organization

Authorizations

AuthorizationstringRequired

Path parameters

org_idstringRequired

Query parameters

account_idstringOptional

Filter by account unique_id

employee_idstringOptional

Filter by employee unique_id

from_datestringOptional

Filter expenses from this expense_date (YYYY-MM-DD)

searchstringOptional

Search expense_number or title

statusstring · enumOptional

Filter by expense status

Possible values:

to_datestringOptional

Filter expenses up to this expense_date (YYYY-MM-DD)

vendor_idstringOptional

Filter by vendor unique_id

Responses

200Success

application/json

Lightweight version for list views.

unique_idstring · max: 100 · nullableOptional

titlestringRequired

expense_numberstring · max: 100Required

statusstring · enumOptional

draft - Draft
submitted - Submitted for Approval
approved - Approved
paid - Paid
rejected - Rejected
reimbursed - Reimbursed

Possible values:

status_displaystringRead-onlyRequired

expense_datestring · dateRequired

amountstring · decimalRequiredPattern: ^-?\d{0,13}(?:\.\d{0,2})?$

tax_amountstring · decimalOptionalPattern: ^-?\d{0,13}(?:\.\d{0,2})?$

total_amountstring · decimalRead-onlyRequiredPattern: ^-?\d{0,10}(?:\.\d{0,2})?$

date_createdstring · date-time · nullableRead-onlyRequired

401

Unauthorized

403

Forbidden

get/api/v1.0/organisation/{org_id}/expenses/

GET /api/v1.0/organisation/{org_id}/expenses/ HTTP/1.1
Host: skhokho.ai
Authorization: Basic username:password
Accept: */*

[
  {
    "unique_id": "text",
    "title": "text",
    "expense_number": "text",
    "status": "draft",
    "status_display": "text",
    "expense_date": "2026-01-01",
    "amount": "text",
    "tax_amount": "text",
    "total_amount": "text",
    "employee": {
      "unique_id": "text",
      "full_name": "text"
    },
    "vendor": {
      "unique_id": "text",
      "name": "text"
    },
    "date_created": "2026-01-01T00:00:00.000Z"
  }
]

Create expense

post

/api/v1.0/organisation/{org_id}/expenses/create/

Create a new expense

Authorizations

AuthorizationstringRequired

Path parameters

org_idstringRequired

Body

Comprehensive serializer for Expense model.

unique_idstring · max: 100 · nullableOptional

titlestring · min: 1Required

descriptionstring · nullableOptional

notesstring · nullableOptional

expense_numberstring · min: 1 · max: 100Required

account_idstring · min: 1Write-onlyRequired

statusstring · enumOptional

draft - Draft
submitted - Submitted for Approval
approved - Approved
paid - Paid
rejected - Rejected
reimbursed - Reimbursed

Possible values:

expense_datestring · dateRequired

amountstring · decimalRequiredPattern: ^-?\d{0,13}(?:\.\d{0,2})?$

tax_amountstring · decimalOptionalPattern: ^-?\d{0,13}(?:\.\d{0,2})?$

vendor_idstring · min: 1 · nullableWrite-onlyOptional

employee_idstring · min: 1 · nullableWrite-onlyOptional

receiptstring · binary · nullableOptional

Receipt or supporting document

vat_processedbooleanOptional

Whether VAT has been processed for reconciliation

Responses

201Success

application/json

Comprehensive serializer for Expense model.

unique_idstring · max: 100 · nullableOptional

titlestringRequired

descriptionstring · nullableOptional

notesstring · nullableOptional

expense_numberstring · max: 100Required

statusstring · enumOptional

draft - Draft
submitted - Submitted for Approval
approved - Approved
paid - Paid
rejected - Rejected
reimbursed - Reimbursed

Possible values:

status_displaystringRead-onlyRequired

expense_datestring · dateRequired

submitted_datestring · date-time · nullableRead-onlyRequired

approved_datestring · date-time · nullableRead-onlyRequired

paid_datestring · date-time · nullableRead-onlyRequired

amountstring · decimalRequiredPattern: ^-?\d{0,13}(?:\.\d{0,2})?$

tax_amountstring · decimalOptionalPattern: ^-?\d{0,13}(?:\.\d{0,2})?$

total_amountstring · decimalRead-onlyRequiredPattern: ^-?\d{0,10}(?:\.\d{0,2})?$

receiptstring · uri · nullableOptional

Receipt or supporting document

receipt_urlstring · nullableRead-onlyRequired

vat_processedbooleanOptional

Whether VAT has been processed for reconciliation

vat_processed_datestring · date-time · nullableRead-onlyRequired

date_createdstring · date-time · nullableRead-onlyRequired

last_updatedstring · date-time · nullableRead-onlyRequired

400

Bad Request

401

Unauthorized

403

Forbidden

post/api/v1.0/organisation/{org_id}/expenses/create/

POST /api/v1.0/organisation/{org_id}/expenses/create/ HTTP/1.1
Host: skhokho.ai
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 276

{
  "unique_id": "text",
  "title": "text",
  "description": "text",
  "notes": "text",
  "expense_number": "text",
  "account_id": "text",
  "status": "draft",
  "expense_date": "2026-01-01",
  "amount": "text",
  "tax_amount": "text",
  "vendor_id": "text",
  "employee_id": "text",
  "receipt": "binary",
  "vat_processed": true
}

{
  "unique_id": "text",
  "title": "text",
  "description": "text",
  "notes": "text",
  "expense_number": "text",
  "account": {
    "unique_id": "text",
    "account_code": "text",
    "name": "text",
    "account_type": "asset"
  },
  "status": "draft",
  "status_display": "text",
  "expense_date": "2026-01-01",
  "submitted_date": "2026-01-01T00:00:00.000Z",
  "approved_date": "2026-01-01T00:00:00.000Z",
  "paid_date": "2026-01-01T00:00:00.000Z",
  "amount": "text",
  "tax_amount": "text",
  "total_amount": "text",
  "vendor": {
    "unique_id": "text",
    "name": "text"
  },
  "employee": {
    "unique_id": "text",
    "full_name": "text"
  },
  "approved_by": {
    "unique_id": "text",
    "full_name": "text"
  },
  "receipt": "https://example.com",
  "receipt_url": "text",
  "vat_processed": true,
  "vat_processed_date": "2026-01-01T00:00:00.000Z",
  "created_by": {
    "unique_id": "text",
    "full_name": "text"
  },
  "date_created": "2026-01-01T00:00:00.000Z",
  "last_updated": "2026-01-01T00:00:00.000Z"
}

Retrieve expense

get

/api/v1.0/organisation/{org_id}/expenses/{expense_id}/

Retrieve a specific expense with full details

Authorizations

AuthorizationstringRequired

Path parameters

expense_idstringRequired

org_idstringRequired

Responses

200Success

application/json

Comprehensive serializer for Expense model.

unique_idstring · max: 100 · nullableOptional

titlestringRequired

descriptionstring · nullableOptional

notesstring · nullableOptional

expense_numberstring · max: 100Required

statusstring · enumOptional

draft - Draft
submitted - Submitted for Approval
approved - Approved
paid - Paid
rejected - Rejected
reimbursed - Reimbursed

Possible values:

status_displaystringRead-onlyRequired

expense_datestring · dateRequired

submitted_datestring · date-time · nullableRead-onlyRequired

approved_datestring · date-time · nullableRead-onlyRequired

paid_datestring · date-time · nullableRead-onlyRequired

amountstring · decimalRequiredPattern: ^-?\d{0,13}(?:\.\d{0,2})?$

tax_amountstring · decimalOptionalPattern: ^-?\d{0,13}(?:\.\d{0,2})?$

total_amountstring · decimalRead-onlyRequiredPattern: ^-?\d{0,10}(?:\.\d{0,2})?$

receiptstring · uri · nullableOptional

Receipt or supporting document

receipt_urlstring · nullableRead-onlyRequired

vat_processedbooleanOptional

Whether VAT has been processed for reconciliation

vat_processed_datestring · date-time · nullableRead-onlyRequired

date_createdstring · date-time · nullableRead-onlyRequired

last_updatedstring · date-time · nullableRead-onlyRequired

401

Unauthorized

403

Forbidden

404

Not Found

get/api/v1.0/organisation/{org_id}/expenses/{expense_id}/

GET /api/v1.0/organisation/{org_id}/expenses/{expense_id}/ HTTP/1.1
Host: skhokho.ai
Authorization: Basic username:password
Accept: */*

{
  "unique_id": "text",
  "title": "text",
  "description": "text",
  "notes": "text",
  "expense_number": "text",
  "account": {
    "unique_id": "text",
    "account_code": "text",
    "name": "text",
    "account_type": "asset"
  },
  "status": "draft",
  "status_display": "text",
  "expense_date": "2026-01-01",
  "submitted_date": "2026-01-01T00:00:00.000Z",
  "approved_date": "2026-01-01T00:00:00.000Z",
  "paid_date": "2026-01-01T00:00:00.000Z",
  "amount": "text",
  "tax_amount": "text",
  "total_amount": "text",
  "vendor": {
    "unique_id": "text",
    "name": "text"
  },
  "employee": {
    "unique_id": "text",
    "full_name": "text"
  },
  "approved_by": {
    "unique_id": "text",
    "full_name": "text"
  },
  "receipt": "https://example.com",
  "receipt_url": "text",
  "vat_processed": true,
  "vat_processed_date": "2026-01-01T00:00:00.000Z",
  "created_by": {
    "unique_id": "text",
    "full_name": "text"
  },
  "date_created": "2026-01-01T00:00:00.000Z",
  "last_updated": "2026-01-01T00:00:00.000Z"
}

Update expense

put

/api/v1.0/organisation/{org_id}/expenses/{expense_id}/update/

Update an existing expense

Authorizations

AuthorizationstringRequired

Path parameters

expense_idstringRequired

org_idstringRequired

Body

Comprehensive serializer for Expense model.

unique_idstring · max: 100 · nullableOptional

titlestring · min: 1Required

descriptionstring · nullableOptional

notesstring · nullableOptional

expense_numberstring · min: 1 · max: 100Required

account_idstring · min: 1Write-onlyRequired

statusstring · enumOptional

draft - Draft
submitted - Submitted for Approval
approved - Approved
paid - Paid
rejected - Rejected
reimbursed - Reimbursed

Possible values:

expense_datestring · dateRequired

amountstring · decimalRequiredPattern: ^-?\d{0,13}(?:\.\d{0,2})?$

tax_amountstring · decimalOptionalPattern: ^-?\d{0,13}(?:\.\d{0,2})?$

vendor_idstring · min: 1 · nullableWrite-onlyOptional

employee_idstring · min: 1 · nullableWrite-onlyOptional

receiptstring · binary · nullableOptional

Receipt or supporting document

vat_processedbooleanOptional

Whether VAT has been processed for reconciliation

Responses

200Success

application/json

Comprehensive serializer for Expense model.

unique_idstring · max: 100 · nullableOptional

titlestringRequired

descriptionstring · nullableOptional

notesstring · nullableOptional

expense_numberstring · max: 100Required

statusstring · enumOptional

draft - Draft
submitted - Submitted for Approval
approved - Approved
paid - Paid
rejected - Rejected
reimbursed - Reimbursed

Possible values:

status_displaystringRead-onlyRequired

expense_datestring · dateRequired

submitted_datestring · date-time · nullableRead-onlyRequired

approved_datestring · date-time · nullableRead-onlyRequired

paid_datestring · date-time · nullableRead-onlyRequired

amountstring · decimalRequiredPattern: ^-?\d{0,13}(?:\.\d{0,2})?$

tax_amountstring · decimalOptionalPattern: ^-?\d{0,13}(?:\.\d{0,2})?$

total_amountstring · decimalRead-onlyRequiredPattern: ^-?\d{0,10}(?:\.\d{0,2})?$

receiptstring · uri · nullableOptional

Receipt or supporting document

receipt_urlstring · nullableRead-onlyRequired

vat_processedbooleanOptional

Whether VAT has been processed for reconciliation

vat_processed_datestring · date-time · nullableRead-onlyRequired

date_createdstring · date-time · nullableRead-onlyRequired

last_updatedstring · date-time · nullableRead-onlyRequired

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

put/api/v1.0/organisation/{org_id}/expenses/{expense_id}/update/

PUT /api/v1.0/organisation/{org_id}/expenses/{expense_id}/update/ HTTP/1.1
Host: skhokho.ai
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 276

{
  "unique_id": "text",
  "title": "text",
  "description": "text",
  "notes": "text",
  "expense_number": "text",
  "account_id": "text",
  "status": "draft",
  "expense_date": "2026-01-01",
  "amount": "text",
  "tax_amount": "text",
  "vendor_id": "text",
  "employee_id": "text",
  "receipt": "binary",
  "vat_processed": true
}

{
  "unique_id": "text",
  "title": "text",
  "description": "text",
  "notes": "text",
  "expense_number": "text",
  "account": {
    "unique_id": "text",
    "account_code": "text",
    "name": "text",
    "account_type": "asset"
  },
  "status": "draft",
  "status_display": "text",
  "expense_date": "2026-01-01",
  "submitted_date": "2026-01-01T00:00:00.000Z",
  "approved_date": "2026-01-01T00:00:00.000Z",
  "paid_date": "2026-01-01T00:00:00.000Z",
  "amount": "text",
  "tax_amount": "text",
  "total_amount": "text",
  "vendor": {
    "unique_id": "text",
    "name": "text"
  },
  "employee": {
    "unique_id": "text",
    "full_name": "text"
  },
  "approved_by": {
    "unique_id": "text",
    "full_name": "text"
  },
  "receipt": "https://example.com",
  "receipt_url": "text",
  "vat_processed": true,
  "vat_processed_date": "2026-01-01T00:00:00.000Z",
  "created_by": {
    "unique_id": "text",
    "full_name": "text"
  },
  "date_created": "2026-01-01T00:00:00.000Z",
  "last_updated": "2026-01-01T00:00:00.000Z"
}

Update expense

patch

/api/v1.0/organisation/{org_id}/expenses/{expense_id}/update/

Update an existing expense

Authorizations

AuthorizationstringRequired

Path parameters

expense_idstringRequired

org_idstringRequired

Body

Comprehensive serializer for Expense model.

unique_idstring · max: 100 · nullableOptional

titlestring · min: 1Optional

descriptionstring · nullableOptional

notesstring · nullableOptional

expense_numberstring · min: 1 · max: 100Optional

account_idstring · min: 1Write-onlyOptional

statusstring · enumOptional

draft - Draft
submitted - Submitted for Approval
approved - Approved
paid - Paid
rejected - Rejected
reimbursed - Reimbursed

Possible values:

expense_datestring · dateOptional

amountstring · decimalOptionalPattern: ^-?\d{0,13}(?:\.\d{0,2})?$

tax_amountstring · decimalOptionalPattern: ^-?\d{0,13}(?:\.\d{0,2})?$

vendor_idstring · min: 1 · nullableWrite-onlyOptional

employee_idstring · min: 1 · nullableWrite-onlyOptional

receiptstring · binary · nullableOptional

Receipt or supporting document

vat_processedbooleanOptional

Whether VAT has been processed for reconciliation

Responses

200Success

application/json

Comprehensive serializer for Expense model.

unique_idstring · max: 100 · nullableOptional

titlestringRequired

descriptionstring · nullableOptional

notesstring · nullableOptional

expense_numberstring · max: 100Required

statusstring · enumOptional

draft - Draft
submitted - Submitted for Approval
approved - Approved
paid - Paid
rejected - Rejected
reimbursed - Reimbursed

Possible values:

status_displaystringRead-onlyRequired

expense_datestring · dateRequired

submitted_datestring · date-time · nullableRead-onlyRequired

approved_datestring · date-time · nullableRead-onlyRequired

paid_datestring · date-time · nullableRead-onlyRequired

amountstring · decimalRequiredPattern: ^-?\d{0,13}(?:\.\d{0,2})?$

tax_amountstring · decimalOptionalPattern: ^-?\d{0,13}(?:\.\d{0,2})?$

total_amountstring · decimalRead-onlyRequiredPattern: ^-?\d{0,10}(?:\.\d{0,2})?$

receiptstring · uri · nullableOptional

Receipt or supporting document

receipt_urlstring · nullableRead-onlyRequired

vat_processedbooleanOptional

Whether VAT has been processed for reconciliation

vat_processed_datestring · date-time · nullableRead-onlyRequired

date_createdstring · date-time · nullableRead-onlyRequired

last_updatedstring · date-time · nullableRead-onlyRequired

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

patch/api/v1.0/organisation/{org_id}/expenses/{expense_id}/update/

PATCH /api/v1.0/organisation/{org_id}/expenses/{expense_id}/update/ HTTP/1.1
Host: skhokho.ai
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 276

{
  "unique_id": "text",
  "title": "text",
  "description": "text",
  "notes": "text",
  "expense_number": "text",
  "account_id": "text",
  "status": "draft",
  "expense_date": "2026-01-01",
  "amount": "text",
  "tax_amount": "text",
  "vendor_id": "text",
  "employee_id": "text",
  "receipt": "binary",
  "vat_processed": true
}

{
  "unique_id": "text",
  "title": "text",
  "description": "text",
  "notes": "text",
  "expense_number": "text",
  "account": {
    "unique_id": "text",
    "account_code": "text",
    "name": "text",
    "account_type": "asset"
  },
  "status": "draft",
  "status_display": "text",
  "expense_date": "2026-01-01",
  "submitted_date": "2026-01-01T00:00:00.000Z",
  "approved_date": "2026-01-01T00:00:00.000Z",
  "paid_date": "2026-01-01T00:00:00.000Z",
  "amount": "text",
  "tax_amount": "text",
  "total_amount": "text",
  "vendor": {
    "unique_id": "text",
    "name": "text"
  },
  "employee": {
    "unique_id": "text",
    "full_name": "text"
  },
  "approved_by": {
    "unique_id": "text",
    "full_name": "text"
  },
  "receipt": "https://example.com",
  "receipt_url": "text",
  "vat_processed": true,
  "vat_processed_date": "2026-01-01T00:00:00.000Z",
  "created_by": {
    "unique_id": "text",
    "full_name": "text"
  },
  "date_created": "2026-01-01T00:00:00.000Z",
  "last_updated": "2026-01-01T00:00:00.000Z"
}

Perform expense action

get

/api/v1.0/organisation/{org_id}/expenses/{expense_id}/action/

Perform an action on an expense using query parameter.

**Available Actions:**
- `submit` - Submit a draft expense for approval
- `approve` - Approve a submitted expense
- `reject` - Reject a submitted expense (supports optional `reason` parameter)
- `mark_paid` - Mark an approved expense as paid

**Examples:**
- `/expenses/{id}/action?action=submit`
- `/expenses/{id}/action?action=approve`
- `/expenses/{id}/action?action=reject&reason=Missing+receipts`
- `/expenses/{id}/action?action=mark_paid`

Authorizations

AuthorizationstringRequired

Path parameters

expense_idstringRequired

org_idstringRequired

Query parameters

actionstring · enumRequired

The action to perform on the expense

Possible values:

reasonstringOptional

Reason for rejection (only used with action=reject)

Responses

200Success

application/json

Comprehensive serializer for Expense model.

unique_idstring · max: 100 · nullableOptional

titlestringRequired

descriptionstring · nullableOptional

notesstring · nullableOptional

expense_numberstring · max: 100Required

statusstring · enumOptional

draft - Draft
submitted - Submitted for Approval
approved - Approved
paid - Paid
rejected - Rejected
reimbursed - Reimbursed

Possible values:

status_displaystringRead-onlyRequired

expense_datestring · dateRequired

submitted_datestring · date-time · nullableRead-onlyRequired

approved_datestring · date-time · nullableRead-onlyRequired

paid_datestring · date-time · nullableRead-onlyRequired

amountstring · decimalRequiredPattern: ^-?\d{0,13}(?:\.\d{0,2})?$

tax_amountstring · decimalOptionalPattern: ^-?\d{0,13}(?:\.\d{0,2})?$

total_amountstring · decimalRead-onlyRequiredPattern: ^-?\d{0,10}(?:\.\d{0,2})?$

receiptstring · uri · nullableOptional

Receipt or supporting document

receipt_urlstring · nullableRead-onlyRequired

vat_processedbooleanOptional

Whether VAT has been processed for reconciliation

vat_processed_datestring · date-time · nullableRead-onlyRequired

date_createdstring · date-time · nullableRead-onlyRequired

last_updatedstring · date-time · nullableRead-onlyRequired

400

Bad Request - Invalid action or invalid state transition

401

Unauthorized

403

Forbidden

404

Not Found

get/api/v1.0/organisation/{org_id}/expenses/{expense_id}/action/

GET /api/v1.0/organisation/{org_id}/expenses/{expense_id}/action/?action=approve HTTP/1.1
Host: skhokho.ai
Authorization: Basic username:password
Accept: */*

{
  "unique_id": "text",
  "title": "text",
  "description": "text",
  "notes": "text",
  "expense_number": "text",
  "account": {
    "unique_id": "text",
    "account_code": "text",
    "name": "text",
    "account_type": "asset"
  },
  "status": "draft",
  "status_display": "text",
  "expense_date": "2026-01-01",
  "submitted_date": "2026-01-01T00:00:00.000Z",
  "approved_date": "2026-01-01T00:00:00.000Z",
  "paid_date": "2026-01-01T00:00:00.000Z",
  "amount": "text",
  "tax_amount": "text",
  "total_amount": "text",
  "vendor": {
    "unique_id": "text",
    "name": "text"
  },
  "employee": {
    "unique_id": "text",
    "full_name": "text"
  },
  "approved_by": {
    "unique_id": "text",
    "full_name": "text"
  },
  "receipt": "https://example.com",
  "receipt_url": "text",
  "vat_processed": true,
  "vat_processed_date": "2026-01-01T00:00:00.000Z",
  "created_by": {
    "unique_id": "text",
    "full_name": "text"
  },
  "date_created": "2026-01-01T00:00:00.000Z",
  "last_updated": "2026-01-01T00:00:00.000Z"
}

Previous🏦 Accounts

Next💳 Bills

Last updated 7 months ago