💳 Bills

Accounts payable and bill management

List bills

get

https://skhokho.aihttp://102.209.118.152:8000https://dev.skhokho.ai

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

List all bills for an organization

Authorizations

basicAuthcookieAuth

AuthorizationstringRequired

Path parameters

org_idstringRequired

Query parameters

from_datestring · dateOptional

Filter bills from this bill_date (YYYY-MM-DD)

overduebooleanOptional

Filter overdue bills (true/false)

searchstringOptional

Search bill_number, supplier_invoice_number, or bill title

statusstring · enumOptional

Filter by bill status

Possible values:

to_datestring · dateOptional

Filter bills up to this bill_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

bill_numberstring · max: 100Required

supplier_invoice_numberstring · max: 100 · nullableOptional

statusstring · enumOptional

• received - Received
• approved - Approved for Payment
• paid - Paid
• partially_paid - Partially Paid
• overdue - Overdue
• disputed - Disputed
• cancelled - Cancelled

Possible values:

status_displaystringRead-onlyRequired

bill_datestring · dateRequired

due_datestring · dateRequired

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

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

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

is_overduebooleanRead-onlyRequired

date_createdstring · date-time · nullableRead-onlyRequired

401

Unauthorized

403

Forbidden

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

HTTPcURLJavaScriptPython

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

[
  {
    "unique_id": "text",
    "title": "text",
    "bill_number": "text",
    "supplier_invoice_number": "text",
    "status": "received",
    "status_display": "text",
    "vendor": {
      "unique_id": "text",
      "name": "text"
    },
    "bill_date": "2026-08-08",
    "due_date": "2026-08-08",
    "total_amount": "text",
    "paid_amount": "text",
    "remaining_amount": "text",
    "is_overdue": true,
    "date_created": "2026-08-08T00:37:11.939Z"
  }
]

Create bill

post

https://skhokho.aihttp://102.209.118.152:8000https://dev.skhokho.ai

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

Create a new bill

Authorizations

basicAuthcookieAuth

AuthorizationstringRequired

Path parameters

org_idstringRequired

Body

application/jsonapplication/x-www-form-urlencodedmultipart/form-data

Comprehensive serializer for Bill model.

unique_idstring · max: 100 · nullableOptional

titlestring · min: 1Required

descriptionstring · nullableOptional

notesstring · nullableOptional

bill_numberstring · min: 1 · max: 100Required

supplier_invoice_numberstring · max: 100 · nullableOptional

statusstring · enumOptional

• received - Received
• approved - Approved for Payment
• paid - Paid
• partially_paid - Partially Paid
• overdue - Overdue
• disputed - Disputed
• cancelled - Cancelled

Possible values:

vendor_idstring · min: 1 · nullableWrite-onlyOptional

bill_datestring · dateRequired

due_datestring · dateRequired

received_datestring · dateOptional

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

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

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

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

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

documentstring · binary · nullableOptional

Scanned bill document (PDF, image)

Responses

201Success

application/json

Comprehensive serializer for Bill model.

unique_idstring · max: 100 · nullableOptional

titlestringRequired

descriptionstring · nullableOptional

notesstring · nullableOptional

bill_numberstring · max: 100Required

supplier_invoice_numberstring · max: 100 · nullableOptional

statusstring · enumOptional

• received - Received
• approved - Approved for Payment
• paid - Paid
• partially_paid - Partially Paid
• overdue - Overdue
• disputed - Disputed
• cancelled - Cancelled

Possible values:

status_displaystringRead-onlyRequired

bill_datestring · dateRequired

due_datestring · dateRequired

received_datestring · dateOptional

paid_datestring · date-time · nullableRead-onlyRequired

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

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

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

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

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

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

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

is_overduebooleanRead-onlyRequired

documentstring · uri · nullableOptional

Scanned bill document (PDF, image)

document_urlstring · 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}/bills/create/

HTTPcURLJavaScriptPython

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

{
  "unique_id": "text",
  "title": "text",
  "description": "text",
  "notes": "text",
  "bill_number": "text",
  "supplier_invoice_number": "text",
  "status": "received",
  "vendor_id": "text",
  "bill_date": "2026-08-08",
  "due_date": "2026-08-08",
  "received_date": "2026-08-08",
  "subtotal": "text",
  "tax_rate": "text",
  "tax_amount": "text",
  "total_amount": "text",
  "paid_amount": "text",
  "document": "binary"
}

application/jsonapplication/x-www-form-urlencodedmultipart/form-data

{
  "unique_id": "text",
  "title": "text",
  "description": "text",
  "notes": "text",
  "bill_number": "text",
  "supplier_invoice_number": "text",
  "status": "received",
  "status_display": "text",
  "vendor": {
    "unique_id": "text",
    "name": "text"
  },
  "bill_date": "2026-08-08",
  "due_date": "2026-08-08",
  "received_date": "2026-08-08",
  "paid_date": "2026-08-08T00:37:11.939Z",
  "subtotal": "text",
  "tax_rate": "text",
  "tax_amount": "text",
  "total_amount": "text",
  "paid_amount": "text",
  "remaining_amount": "text",
  "payment_percentage": "text",
  "is_overdue": true,
  "document": "https://example.com",
  "document_url": "text",
  "created_by": {
    "unique_id": "text",
    "full_name": "text"
  },
  "date_created": "2026-08-08T00:37:11.939Z",
  "last_updated": "2026-08-08T00:37:11.939Z"
}

Retrieve bill

get

https://skhokho.aihttp://102.209.118.152:8000https://dev.skhokho.ai

/api/v1.0/organisation/{org_id}/bills/{bill_id}/

Retrieve a specific bill with full details

Authorizations

basicAuthcookieAuth

AuthorizationstringRequired

Path parameters

bill_idstringRequired

org_idstringRequired

Responses

200Success

application/json

Comprehensive serializer for Bill model.

unique_idstring · max: 100 · nullableOptional

titlestringRequired

descriptionstring · nullableOptional

notesstring · nullableOptional

bill_numberstring · max: 100Required

supplier_invoice_numberstring · max: 100 · nullableOptional

statusstring · enumOptional

• received - Received
• approved - Approved for Payment
• paid - Paid
• partially_paid - Partially Paid
• overdue - Overdue
• disputed - Disputed
• cancelled - Cancelled

Possible values:

status_displaystringRead-onlyRequired

bill_datestring · dateRequired

due_datestring · dateRequired

received_datestring · dateOptional

paid_datestring · date-time · nullableRead-onlyRequired

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

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

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

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

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

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

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

is_overduebooleanRead-onlyRequired

documentstring · uri · nullableOptional

Scanned bill document (PDF, image)

document_urlstring · 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}/bills/{bill_id}/

HTTPcURLJavaScriptPython

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

{
  "unique_id": "text",
  "title": "text",
  "description": "text",
  "notes": "text",
  "bill_number": "text",
  "supplier_invoice_number": "text",
  "status": "received",
  "status_display": "text",
  "vendor": {
    "unique_id": "text",
    "name": "text"
  },
  "bill_date": "2026-08-08",
  "due_date": "2026-08-08",
  "received_date": "2026-08-08",
  "paid_date": "2026-08-08T00:37:11.939Z",
  "subtotal": "text",
  "tax_rate": "text",
  "tax_amount": "text",
  "total_amount": "text",
  "paid_amount": "text",
  "remaining_amount": "text",
  "payment_percentage": "text",
  "is_overdue": true,
  "document": "https://example.com",
  "document_url": "text",
  "created_by": {
    "unique_id": "text",
    "full_name": "text"
  },
  "date_created": "2026-08-08T00:37:11.939Z",
  "last_updated": "2026-08-08T00:37:11.939Z"
}

Update bill

put

https://skhokho.aihttp://102.209.118.152:8000https://dev.skhokho.ai

/api/v1.0/organisation/{org_id}/bills/{bill_id}/update/

Update an existing bill

Authorizations

basicAuthcookieAuth

AuthorizationstringRequired

Path parameters

bill_idstringRequired

org_idstringRequired

Body

application/jsonapplication/x-www-form-urlencodedmultipart/form-data

Comprehensive serializer for Bill model.

unique_idstring · max: 100 · nullableOptional

titlestring · min: 1Required

descriptionstring · nullableOptional

notesstring · nullableOptional

bill_numberstring · min: 1 · max: 100Required

supplier_invoice_numberstring · max: 100 · nullableOptional

statusstring · enumOptional

• received - Received
• approved - Approved for Payment
• paid - Paid
• partially_paid - Partially Paid
• overdue - Overdue
• disputed - Disputed
• cancelled - Cancelled

Possible values:

vendor_idstring · min: 1 · nullableWrite-onlyOptional

bill_datestring · dateRequired

due_datestring · dateRequired

received_datestring · dateOptional

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

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

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

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

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

documentstring · binary · nullableOptional

Scanned bill document (PDF, image)

Responses

200Success

application/json

Comprehensive serializer for Bill model.

unique_idstring · max: 100 · nullableOptional

titlestringRequired

descriptionstring · nullableOptional

notesstring · nullableOptional

bill_numberstring · max: 100Required

supplier_invoice_numberstring · max: 100 · nullableOptional

statusstring · enumOptional

• received - Received
• approved - Approved for Payment
• paid - Paid
• partially_paid - Partially Paid
• overdue - Overdue
• disputed - Disputed
• cancelled - Cancelled

Possible values:

status_displaystringRead-onlyRequired

bill_datestring · dateRequired

due_datestring · dateRequired

received_datestring · dateOptional

paid_datestring · date-time · nullableRead-onlyRequired

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

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

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

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

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

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

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

is_overduebooleanRead-onlyRequired

documentstring · uri · nullableOptional

Scanned bill document (PDF, image)

document_urlstring · 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}/bills/{bill_id}/update/

HTTPcURLJavaScriptPython

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

{
  "unique_id": "text",
  "title": "text",
  "description": "text",
  "notes": "text",
  "bill_number": "text",
  "supplier_invoice_number": "text",
  "status": "received",
  "vendor_id": "text",
  "bill_date": "2026-08-08",
  "due_date": "2026-08-08",
  "received_date": "2026-08-08",
  "subtotal": "text",
  "tax_rate": "text",
  "tax_amount": "text",
  "total_amount": "text",
  "paid_amount": "text",
  "document": "binary"
}

application/jsonapplication/x-www-form-urlencodedmultipart/form-data

{
  "unique_id": "text",
  "title": "text",
  "description": "text",
  "notes": "text",
  "bill_number": "text",
  "supplier_invoice_number": "text",
  "status": "received",
  "status_display": "text",
  "vendor": {
    "unique_id": "text",
    "name": "text"
  },
  "bill_date": "2026-08-08",
  "due_date": "2026-08-08",
  "received_date": "2026-08-08",
  "paid_date": "2026-08-08T00:37:11.939Z",
  "subtotal": "text",
  "tax_rate": "text",
  "tax_amount": "text",
  "total_amount": "text",
  "paid_amount": "text",
  "remaining_amount": "text",
  "payment_percentage": "text",
  "is_overdue": true,
  "document": "https://example.com",
  "document_url": "text",
  "created_by": {
    "unique_id": "text",
    "full_name": "text"
  },
  "date_created": "2026-08-08T00:37:11.939Z",
  "last_updated": "2026-08-08T00:37:11.939Z"
}

Update bill

patch

https://skhokho.aihttp://102.209.118.152:8000https://dev.skhokho.ai

/api/v1.0/organisation/{org_id}/bills/{bill_id}/update/

Update an existing bill

Authorizations

basicAuthcookieAuth

AuthorizationstringRequired

Path parameters

bill_idstringRequired

org_idstringRequired

Body

application/jsonapplication/x-www-form-urlencodedmultipart/form-data

Comprehensive serializer for Bill model.

unique_idstring · max: 100 · nullableOptional

titlestring · min: 1Optional

descriptionstring · nullableOptional

notesstring · nullableOptional

bill_numberstring · min: 1 · max: 100Optional

supplier_invoice_numberstring · max: 100 · nullableOptional

statusstring · enumOptional

• received - Received
• approved - Approved for Payment
• paid - Paid
• partially_paid - Partially Paid
• overdue - Overdue
• disputed - Disputed
• cancelled - Cancelled

Possible values:

vendor_idstring · min: 1 · nullableWrite-onlyOptional

bill_datestring · dateOptional

due_datestring · dateOptional

received_datestring · dateOptional

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

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

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

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

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

documentstring · binary · nullableOptional

Scanned bill document (PDF, image)

Responses

200Success

application/json

Comprehensive serializer for Bill model.

unique_idstring · max: 100 · nullableOptional

titlestringRequired

descriptionstring · nullableOptional

notesstring · nullableOptional

bill_numberstring · max: 100Required

supplier_invoice_numberstring · max: 100 · nullableOptional

statusstring · enumOptional

• received - Received
• approved - Approved for Payment
• paid - Paid
• partially_paid - Partially Paid
• overdue - Overdue
• disputed - Disputed
• cancelled - Cancelled

Possible values:

status_displaystringRead-onlyRequired

bill_datestring · dateRequired

due_datestring · dateRequired

received_datestring · dateOptional

paid_datestring · date-time · nullableRead-onlyRequired

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

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

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

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

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

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

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

is_overduebooleanRead-onlyRequired

documentstring · uri · nullableOptional

Scanned bill document (PDF, image)

document_urlstring · 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}/bills/{bill_id}/update/

HTTPcURLJavaScriptPython

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

{
  "unique_id": "text",
  "title": "text",
  "description": "text",
  "notes": "text",
  "bill_number": "text",
  "supplier_invoice_number": "text",
  "status": "received",
  "vendor_id": "text",
  "bill_date": "2026-08-08",
  "due_date": "2026-08-08",
  "received_date": "2026-08-08",
  "subtotal": "text",
  "tax_rate": "text",
  "tax_amount": "text",
  "total_amount": "text",
  "paid_amount": "text",
  "document": "binary"
}

application/jsonapplication/x-www-form-urlencodedmultipart/form-data

{
  "unique_id": "text",
  "title": "text",
  "description": "text",
  "notes": "text",
  "bill_number": "text",
  "supplier_invoice_number": "text",
  "status": "received",
  "status_display": "text",
  "vendor": {
    "unique_id": "text",
    "name": "text"
  },
  "bill_date": "2026-08-08",
  "due_date": "2026-08-08",
  "received_date": "2026-08-08",
  "paid_date": "2026-08-08T00:37:11.939Z",
  "subtotal": "text",
  "tax_rate": "text",
  "tax_amount": "text",
  "total_amount": "text",
  "paid_amount": "text",
  "remaining_amount": "text",
  "payment_percentage": "text",
  "is_overdue": true,
  "document": "https://example.com",
  "document_url": "text",
  "created_by": {
    "unique_id": "text",
    "full_name": "text"
  },
  "date_created": "2026-08-08T00:37:11.939Z",
  "last_updated": "2026-08-08T00:37:11.939Z"
}

Perform bill action

get

https://skhokho.aihttp://102.209.118.152:8000https://dev.skhokho.ai

/api/v1.0/organisation/{org_id}/bills/{bill_id}/action/

Perform an action on a bill using query parameter.

**Available Actions:**
- `mark_received` - Mark a pending bill as received
- `approve` - Approve a received bill for payment
- `mark_paid` - Mark an approved bill as fully paid
- `mark_partially_paid` - Mark a bill as partially paid
- `mark_disputed` - Mark a bill as disputed
- `mark_cancelled` - Mark a bill as cancelled
- `record_payment` - Record a payment made for the bill (requires `amount` parameter)

**Examples:**
- `/bills/{id}/action?action=mark_received`
- `/bills/{id}/action?action=approve`
- `/bills/{id}/action?action=mark_paid`
- `/bills/{id}/action?action=record_payment&amount=500.00`

Authorizations

basicAuthcookieAuth

AuthorizationstringRequired

Path parameters

bill_idstringRequired

org_idstringRequired

Query parameters

actionstring · enumRequired

The action to perform on the bill

Possible values:

amountnumber · doubleOptional

Payment amount (required when action=record_payment)

payment_datestringOptional

Payment date in YYYY-MM-DD format (optional, defaults to today)

Responses

200Success

application/json

Comprehensive serializer for Bill model.

unique_idstring · max: 100 · nullableOptional

titlestringRequired

descriptionstring · nullableOptional

notesstring · nullableOptional

bill_numberstring · max: 100Required

supplier_invoice_numberstring · max: 100 · nullableOptional

statusstring · enumOptional

• received - Received
• approved - Approved for Payment
• paid - Paid
• partially_paid - Partially Paid
• overdue - Overdue
• disputed - Disputed
• cancelled - Cancelled

Possible values:

status_displaystringRead-onlyRequired

bill_datestring · dateRequired

due_datestring · dateRequired

received_datestring · dateOptional

paid_datestring · date-time · nullableRead-onlyRequired

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

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

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

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

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

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

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

is_overduebooleanRead-onlyRequired

documentstring · uri · nullableOptional

Scanned bill document (PDF, image)

document_urlstring · 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}/bills/{bill_id}/action/

HTTPcURLJavaScriptPython

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

{
  "unique_id": "text",
  "title": "text",
  "description": "text",
  "notes": "text",
  "bill_number": "text",
  "supplier_invoice_number": "text",
  "status": "received",
  "status_display": "text",
  "vendor": {
    "unique_id": "text",
    "name": "text"
  },
  "bill_date": "2026-08-08",
  "due_date": "2026-08-08",
  "received_date": "2026-08-08",
  "paid_date": "2026-08-08T00:37:11.939Z",
  "subtotal": "text",
  "tax_rate": "text",
  "tax_amount": "text",
  "total_amount": "text",
  "paid_amount": "text",
  "remaining_amount": "text",
  "payment_percentage": "text",
  "is_overdue": true,
  "document": "https://example.com",
  "document_url": "text",
  "created_by": {
    "unique_id": "text",
    "full_name": "text"
  },
  "date_created": "2026-08-08T00:37:11.939Z",
  "last_updated": "2026-08-08T00:37:11.939Z"
}