📉 Liabilities

Liability and obligation tracking

List liabilities

get

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

/api/v1.0/organisation/{org_uid}/liabilities/

Get a paginated list of liabilities with optional filters

Authorizations

cookieAuthbasicAuth

sessionidstringRequired

Path parameters

org_uidstringRequired

Query parameters

classificationstringOptional

Filter liabilities by classification

creditorstringOptional

Filter liabilities by creditor name

liability_typestringOptional

Filter liabilities by type

namestringOptional

Filter liabilities by name/title (case-insensitive partial match)

overduebooleanOptional

Filter only overdue liabilities (true/false)

searchstringOptional

Search liabilities by name, code, reference number, or creditor

statusstringOptional

Filter liabilities by status (pending, overdue, paid, etc.)

Responses

200Success

application/json

401

Unauthorized

403

Forbidden

get

/api/v1.0/organisation/{org_uid}/liabilities/

HTTPcURLJavaScriptPython

GET /api/v1.0/organisation/{org_uid}/liabilities/ HTTP/1.1
Host: skhokho.ai
Accept: */*

[
  {
    "unique_id": "text",
    "name": "text",
    "liability_code": "text",
    "reference_number": "text",
    "liability_type": "accounts_payable",
    "classification": "current",
    "original_amount": "text",
    "current_balance": "text",
    "remaining_balance": "text",
    "paid_amount": "text",
    "liability_date": "2026-02-04",
    "due_date": "2026-02-04",
    "status": "pending",
    "priority": "low",
    "creditor_name": "text",
    "is_overdue": true,
    "date_created": "2026-02-04T19:40:46.437Z"
  }
]

Create liability

post

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

/api/v1.0/organisation/{org_uid}/liabilities/create/

Create a new liability

Authorizations

cookieAuthbasicAuth

sessionidstringRequired

Path parameters

org_uidstringRequired

Body

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

Full serializer for Liability creation and updates. Handles translatable fields correctly.

namestring · min: 1 · max: 300Required

descriptionstring · nullableOptional

liability_codestring · max: 100 · nullableOptional

reference_numberstring · max: 200 · nullableOptional

liability_typestring · enumOptional

• accounts_payable - Accounts Payable
• notes_payable - Notes Payable
• loans_payable - Loans Payable
• mortgage_payable - Mortgage Payable
• bonds_payable - Bonds Payable
• accrued_expenses - Accrued Expenses
• deferred_revenue - Deferred Revenue
• tax_payable - Tax Payable
• salary_payable - Salary/Wages Payable
• interest_payable - Interest Payable
• rent_payable - Rent Payable
• utilities_payable - Utilities Payable
• lease_obligations - Lease Obligations
• warranty_obligations - Warranty Obligations
• legal_obligations - Legal Obligations
• other - Other

Possible values:

classificationstring · enumOptional

• current - Current Liability
• non_current - Non-Current Liability
• contingent - Contingent Liability

Possible values:

original_amountstring · decimalRequired

Original amount is required and must be non-negative.

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

current_balancestring · decimalRequired

Current outstanding balance

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

paid_amountstring · decimalOptional

Total amount paid so far

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

interest_ratestring · decimal · nullableOptional

Annual interest rate percentage

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

liability_datestring · dateRequired

Liability date is required.

due_datestring · date · nullableOptional

payment_datestring · date · nullableOptional

maturity_datestring · date · nullableOptional

statusstring · enumOptional

• pending - Pending
• overdue - Overdue
• paid - Paid
• partially_paid - Partially Paid
• disputed - Disputed
• cancelled - Cancelled
• deferred - Deferred

Possible values:

prioritystring · enumOptional

• low - Low
• medium - Medium
• high - High
• critical - Critical

Possible values:

creditor_namestring · max: 300 · nullableOptional

creditor_contactstring · max: 200 · nullableOptional

creditor_emailstring · email · max: 254 · nullableOptional

creditor_phonestring · max: 50 · nullableOptional

payment_termsstring · max: 200 · nullableOptional

late_fee_ratestring · decimal · nullableOptional

Late payment fee percentage

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

categorystring · max: 200 · nullableOptional

departmentstring · max: 200 · nullableOptional

project_referencestring · max: 200 · nullableOptional

supporting_documentstring · binary · nullableOptional

Upload contract, invoice, or agreement document (PDF, DOC, DOCX, JPG, PNG)

Responses

201Success

application/json

400

Bad Request

401

Unauthorized

403

Forbidden

post

/api/v1.0/organisation/{org_uid}/liabilities/create/

HTTPcURLJavaScriptPython

POST /api/v1.0/organisation/{org_uid}/liabilities/create/ HTTP/1.1
Host: skhokho.ai
Content-Type: application/json
Accept: */*
Content-Length: 639

{
  "name": "text",
  "description": "text",
  "liability_code": "text",
  "reference_number": "text",
  "liability_type": "accounts_payable",
  "classification": "current",
  "original_amount": "text",
  "current_balance": "text",
  "paid_amount": "text",
  "interest_rate": "text",
  "liability_date": "2026-02-04",
  "due_date": "2026-02-04",
  "payment_date": "2026-02-04",
  "maturity_date": "2026-02-04",
  "status": "pending",
  "priority": "low",
  "creditor_name": "text",
  "creditor_contact": "text",
  "creditor_email": "[email protected]",
  "creditor_phone": "text",
  "payment_terms": "text",
  "late_fee_rate": "text",
  "category": "text",
  "department": "text",
  "project_reference": "text",
  "supporting_document": "binary"
}

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

{
  "unique_id": "text",
  "name": "text",
  "description": "text",
  "liability_code": "text",
  "reference_number": "text",
  "liability_type": "accounts_payable",
  "classification": "current",
  "original_amount": "text",
  "current_balance": "text",
  "remaining_balance": "text",
  "paid_amount": "text",
  "interest_rate": "text",
  "liability_date": "2026-02-04",
  "due_date": "2026-02-04",
  "payment_date": "2026-02-04",
  "maturity_date": "2026-02-04",
  "status": "pending",
  "priority": "low",
  "creditor_name": "text",
  "creditor_contact": "text",
  "creditor_email": "[email protected]",
  "creditor_phone": "text",
  "payment_terms": "text",
  "late_fee_rate": "text",
  "category": "text",
  "department": "text",
  "project_reference": "text",
  "supporting_document_url": "https://example.com",
  "created_by": {
    "unique_id": "text",
    "full_name": "text"
  },
  "is_overdue": true,
  "days_until_due": 1,
  "date_created": "2026-02-04T19:40:46.437Z",
  "last_updated": "2026-02-04T19:40:46.437Z"
}

Retrieve liability

get

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

/api/v1.0/organisation/{org_uid}/liabilities/{unique_id}/

Get detailed information about a specific liability

Authorizations

cookieAuthbasicAuth

sessionidstringRequired

Path parameters

org_uidstringRequired

unique_idstringRequired

Responses

200Success

application/json

401

Unauthorized

403

Forbidden

404

Not Found

get

/api/v1.0/organisation/{org_uid}/liabilities/{unique_id}/

HTTPcURLJavaScriptPython

GET /api/v1.0/organisation/{org_uid}/liabilities/{unique_id}/ HTTP/1.1
Host: skhokho.ai
Accept: */*

{
  "unique_id": "text",
  "name": "text",
  "description": "text",
  "liability_code": "text",
  "reference_number": "text",
  "liability_type": "accounts_payable",
  "classification": "current",
  "original_amount": "text",
  "current_balance": "text",
  "remaining_balance": "text",
  "paid_amount": "text",
  "interest_rate": "text",
  "liability_date": "2026-02-04",
  "due_date": "2026-02-04",
  "payment_date": "2026-02-04",
  "maturity_date": "2026-02-04",
  "status": "pending",
  "priority": "low",
  "creditor_name": "text",
  "creditor_contact": "text",
  "creditor_email": "[email protected]",
  "creditor_phone": "text",
  "payment_terms": "text",
  "late_fee_rate": "text",
  "category": "text",
  "department": "text",
  "project_reference": "text",
  "supporting_document_url": "https://example.com",
  "created_by": {
    "unique_id": "text",
    "full_name": "text"
  },
  "is_overdue": true,
  "days_until_due": 1,
  "date_created": "2026-02-04T19:40:46.437Z",
  "last_updated": "2026-02-04T19:40:46.437Z"
}

Update liability

put

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

/api/v1.0/organisation/{org_uid}/liabilities/{unique_id}/update/

Update liability information (PUT for full update, PATCH for partial)

Authorizations

cookieAuthbasicAuth

sessionidstringRequired

Path parameters

org_uidstringRequired

unique_idstringRequired

Body

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

Full serializer for Liability creation and updates. Handles translatable fields correctly.

namestring · min: 1 · max: 300Required

descriptionstring · nullableOptional

liability_codestring · max: 100 · nullableOptional

reference_numberstring · max: 200 · nullableOptional

liability_typestring · enumOptional

• accounts_payable - Accounts Payable
• notes_payable - Notes Payable
• loans_payable - Loans Payable
• mortgage_payable - Mortgage Payable
• bonds_payable - Bonds Payable
• accrued_expenses - Accrued Expenses
• deferred_revenue - Deferred Revenue
• tax_payable - Tax Payable
• salary_payable - Salary/Wages Payable
• interest_payable - Interest Payable
• rent_payable - Rent Payable
• utilities_payable - Utilities Payable
• lease_obligations - Lease Obligations
• warranty_obligations - Warranty Obligations
• legal_obligations - Legal Obligations
• other - Other

Possible values:

classificationstring · enumOptional

• current - Current Liability
• non_current - Non-Current Liability
• contingent - Contingent Liability

Possible values:

original_amountstring · decimalRequired

Original amount is required and must be non-negative.

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

current_balancestring · decimalRequired

Current outstanding balance

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

paid_amountstring · decimalOptional

Total amount paid so far

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

interest_ratestring · decimal · nullableOptional

Annual interest rate percentage

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

liability_datestring · dateRequired

Liability date is required.

due_datestring · date · nullableOptional

payment_datestring · date · nullableOptional

maturity_datestring · date · nullableOptional

statusstring · enumOptional

• pending - Pending
• overdue - Overdue
• paid - Paid
• partially_paid - Partially Paid
• disputed - Disputed
• cancelled - Cancelled
• deferred - Deferred

Possible values:

prioritystring · enumOptional

• low - Low
• medium - Medium
• high - High
• critical - Critical

Possible values:

creditor_namestring · max: 300 · nullableOptional

creditor_contactstring · max: 200 · nullableOptional

creditor_emailstring · email · max: 254 · nullableOptional

creditor_phonestring · max: 50 · nullableOptional

payment_termsstring · max: 200 · nullableOptional

late_fee_ratestring · decimal · nullableOptional

Late payment fee percentage

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

categorystring · max: 200 · nullableOptional

departmentstring · max: 200 · nullableOptional

project_referencestring · max: 200 · nullableOptional

supporting_documentstring · binary · nullableOptional

Upload contract, invoice, or agreement document (PDF, DOC, DOCX, JPG, PNG)

Responses

200Success

application/json

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

put

/api/v1.0/organisation/{org_uid}/liabilities/{unique_id}/update/

HTTPcURLJavaScriptPython

PUT /api/v1.0/organisation/{org_uid}/liabilities/{unique_id}/update/ HTTP/1.1
Host: skhokho.ai
Content-Type: application/json
Accept: */*
Content-Length: 639

{
  "name": "text",
  "description": "text",
  "liability_code": "text",
  "reference_number": "text",
  "liability_type": "accounts_payable",
  "classification": "current",
  "original_amount": "text",
  "current_balance": "text",
  "paid_amount": "text",
  "interest_rate": "text",
  "liability_date": "2026-02-04",
  "due_date": "2026-02-04",
  "payment_date": "2026-02-04",
  "maturity_date": "2026-02-04",
  "status": "pending",
  "priority": "low",
  "creditor_name": "text",
  "creditor_contact": "text",
  "creditor_email": "[email protected]",
  "creditor_phone": "text",
  "payment_terms": "text",
  "late_fee_rate": "text",
  "category": "text",
  "department": "text",
  "project_reference": "text",
  "supporting_document": "binary"
}

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

{
  "unique_id": "text",
  "name": "text",
  "description": "text",
  "liability_code": "text",
  "reference_number": "text",
  "liability_type": "accounts_payable",
  "classification": "current",
  "original_amount": "text",
  "current_balance": "text",
  "remaining_balance": "text",
  "paid_amount": "text",
  "interest_rate": "text",
  "liability_date": "2026-02-04",
  "due_date": "2026-02-04",
  "payment_date": "2026-02-04",
  "maturity_date": "2026-02-04",
  "status": "pending",
  "priority": "low",
  "creditor_name": "text",
  "creditor_contact": "text",
  "creditor_email": "[email protected]",
  "creditor_phone": "text",
  "payment_terms": "text",
  "late_fee_rate": "text",
  "category": "text",
  "department": "text",
  "project_reference": "text",
  "supporting_document_url": "https://example.com",
  "created_by": {
    "unique_id": "text",
    "full_name": "text"
  },
  "is_overdue": true,
  "days_until_due": 1,
  "date_created": "2026-02-04T19:40:46.437Z",
  "last_updated": "2026-02-04T19:40:46.437Z"
}

Update liability

patch

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

/api/v1.0/organisation/{org_uid}/liabilities/{unique_id}/update/

Update liability information (PUT for full update, PATCH for partial)

Authorizations

cookieAuthbasicAuth

sessionidstringRequired

Path parameters

org_uidstringRequired

unique_idstringRequired

Body

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

Full serializer for Liability creation and updates. Handles translatable fields correctly.

namestring · min: 1 · max: 300Optional

descriptionstring · nullableOptional

liability_codestring · max: 100 · nullableOptional

reference_numberstring · max: 200 · nullableOptional

liability_typestring · enumOptional

• accounts_payable - Accounts Payable
• notes_payable - Notes Payable
• loans_payable - Loans Payable
• mortgage_payable - Mortgage Payable
• bonds_payable - Bonds Payable
• accrued_expenses - Accrued Expenses
• deferred_revenue - Deferred Revenue
• tax_payable - Tax Payable
• salary_payable - Salary/Wages Payable
• interest_payable - Interest Payable
• rent_payable - Rent Payable
• utilities_payable - Utilities Payable
• lease_obligations - Lease Obligations
• warranty_obligations - Warranty Obligations
• legal_obligations - Legal Obligations
• other - Other

Possible values:

classificationstring · enumOptional

• current - Current Liability
• non_current - Non-Current Liability
• contingent - Contingent Liability

Possible values:

original_amountstring · decimalOptional

Original amount is required and must be non-negative.

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

current_balancestring · decimalOptional

Current outstanding balance

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

paid_amountstring · decimalOptional

Total amount paid so far

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

interest_ratestring · decimal · nullableOptional

Annual interest rate percentage

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

liability_datestring · dateOptional

Liability date is required.

due_datestring · date · nullableOptional

payment_datestring · date · nullableOptional

maturity_datestring · date · nullableOptional

statusstring · enumOptional

• pending - Pending
• overdue - Overdue
• paid - Paid
• partially_paid - Partially Paid
• disputed - Disputed
• cancelled - Cancelled
• deferred - Deferred

Possible values:

prioritystring · enumOptional

• low - Low
• medium - Medium
• high - High
• critical - Critical

Possible values:

creditor_namestring · max: 300 · nullableOptional

creditor_contactstring · max: 200 · nullableOptional

creditor_emailstring · email · max: 254 · nullableOptional

creditor_phonestring · max: 50 · nullableOptional

payment_termsstring · max: 200 · nullableOptional

late_fee_ratestring · decimal · nullableOptional

Late payment fee percentage

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

categorystring · max: 200 · nullableOptional

departmentstring · max: 200 · nullableOptional

project_referencestring · max: 200 · nullableOptional

supporting_documentstring · binary · nullableOptional

Upload contract, invoice, or agreement document (PDF, DOC, DOCX, JPG, PNG)

Responses

200Success

application/json

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

patch

/api/v1.0/organisation/{org_uid}/liabilities/{unique_id}/update/

HTTPcURLJavaScriptPython

PATCH /api/v1.0/organisation/{org_uid}/liabilities/{unique_id}/update/ HTTP/1.1
Host: skhokho.ai
Content-Type: application/json
Accept: */*
Content-Length: 639

{
  "name": "text",
  "description": "text",
  "liability_code": "text",
  "reference_number": "text",
  "liability_type": "accounts_payable",
  "classification": "current",
  "original_amount": "text",
  "current_balance": "text",
  "paid_amount": "text",
  "interest_rate": "text",
  "liability_date": "2026-02-04",
  "due_date": "2026-02-04",
  "payment_date": "2026-02-04",
  "maturity_date": "2026-02-04",
  "status": "pending",
  "priority": "low",
  "creditor_name": "text",
  "creditor_contact": "text",
  "creditor_email": "[email protected]",
  "creditor_phone": "text",
  "payment_terms": "text",
  "late_fee_rate": "text",
  "category": "text",
  "department": "text",
  "project_reference": "text",
  "supporting_document": "binary"
}

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

{
  "unique_id": "text",
  "name": "text",
  "description": "text",
  "liability_code": "text",
  "reference_number": "text",
  "liability_type": "accounts_payable",
  "classification": "current",
  "original_amount": "text",
  "current_balance": "text",
  "remaining_balance": "text",
  "paid_amount": "text",
  "interest_rate": "text",
  "liability_date": "2026-02-04",
  "due_date": "2026-02-04",
  "payment_date": "2026-02-04",
  "maturity_date": "2026-02-04",
  "status": "pending",
  "priority": "low",
  "creditor_name": "text",
  "creditor_contact": "text",
  "creditor_email": "[email protected]",
  "creditor_phone": "text",
  "payment_terms": "text",
  "late_fee_rate": "text",
  "category": "text",
  "department": "text",
  "project_reference": "text",
  "supporting_document_url": "https://example.com",
  "created_by": {
    "unique_id": "text",
    "full_name": "text"
  },
  "is_overdue": true,
  "days_until_due": 1,
  "date_created": "2026-02-04T19:40:46.437Z",
  "last_updated": "2026-02-04T19:40:46.437Z"
}

Perform action on liability

get

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

/api/v1.0/organisation/{org_uid}/liabilities/{unique_id}/action/

Perform actions on a liability (mark_paid, mark_overdue). Uses query parameters.

Authorizations

cookieAuthbasicAuth

sessionidstringRequired

Path parameters

org_uidstringRequired

unique_idstringRequired

Query parameters

actionstring · enumRequired

Action to perform: mark_paid or mark_overdue

Possible values:

Responses

200Success

application/json

400

Bad Request - Invalid action

401

Unauthorized

403

Forbidden

404

Not Found

get

/api/v1.0/organisation/{org_uid}/liabilities/{unique_id}/action/

HTTPcURLJavaScriptPython

GET /api/v1.0/organisation/{org_uid}/liabilities/{unique_id}/action/?action=mark_overdue HTTP/1.1
Host: skhokho.ai
Accept: */*

{
  "unique_id": "text",
  "name": "text",
  "description": "text",
  "liability_code": "text",
  "reference_number": "text",
  "liability_type": "accounts_payable",
  "classification": "current",
  "original_amount": "text",
  "current_balance": "text",
  "remaining_balance": "text",
  "paid_amount": "text",
  "interest_rate": "text",
  "liability_date": "2026-02-04",
  "due_date": "2026-02-04",
  "payment_date": "2026-02-04",
  "maturity_date": "2026-02-04",
  "status": "pending",
  "priority": "low",
  "creditor_name": "text",
  "creditor_contact": "text",
  "creditor_email": "[email protected]",
  "creditor_phone": "text",
  "payment_terms": "text",
  "late_fee_rate": "text",
  "category": "text",
  "department": "text",
  "project_reference": "text",
  "supporting_document_url": "https://example.com",
  "created_by": {
    "unique_id": "text",
    "full_name": "text"
  },
  "is_overdue": true,
  "days_until_due": 1,
  "date_created": "2026-02-04T19:40:46.437Z",
  "last_updated": "2026-02-04T19:40:46.437Z"
}