Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

📉 Liabilities

Liability and obligation tracking

List liabilities

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

Get a paginated list of liabilities with optional filters

Authorizations
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

Lightweight serializer for liability lists.

unique_idstring · max: 100 · nullableOptional
namestringRead-onlyRequired
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 liability amount

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

Current outstanding balance

Pattern: ^-?\d{0,13}(?:\.\d{0,2})?$
remaining_balancestring · decimalRead-onlyRequiredPattern: ^-?\d{0,13}(?:\.\d{0,2})?$
paid_amountstring · decimalOptional

Total amount paid so far

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

Date when liability was incurred

due_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
is_overduebooleanRead-onlyRequired
date_createdstring · date-time · nullableOptional
get/api/v1.0/organisation/{org_uid}/liabilities/
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-01-01",
    "due_date": "2026-01-01",
    "status": "pending",
    "priority": "low",
    "creditor_name": "text",
    "is_overdue": true,
    "date_created": "2026-01-01T00:00:00.000Z"
  }
]

Create liability

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

Create a new liability

Authorizations
sessionidstringRequired
Path parameters
org_uidstringRequired
Body

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

Detailed serializer for single liability retrieval.

unique_idstring · max: 100 · nullableOptional
namestringRead-onlyRequired
descriptionstringRead-onlyRequired
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 liability amount

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

Current outstanding balance

Pattern: ^-?\d{0,13}(?:\.\d{0,2})?$
remaining_balancestring · decimalRead-onlyRequiredPattern: ^-?\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

Date when liability was incurred

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_document_urlstring · uri · nullableRead-onlyRequired
is_overduebooleanRead-onlyRequired
days_until_dueinteger · nullableRead-onlyRequired
date_createdstring · date-time · nullableOptional
last_updatedstring · date-time · nullableOptional
post/api/v1.0/organisation/{org_uid}/liabilities/create/
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-01-01",
  "due_date": "2026-01-01",
  "payment_date": "2026-01-01",
  "maturity_date": "2026-01-01",
  "status": "pending",
  "priority": "low",
  "creditor_name": "text",
  "creditor_contact": "text",
  "creditor_email": "name@gmail.com",
  "creditor_phone": "text",
  "payment_terms": "text",
  "late_fee_rate": "text",
  "category": "text",
  "department": "text",
  "project_reference": "text",
  "supporting_document": "binary"
}
{
  "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-01-01",
  "due_date": "2026-01-01",
  "payment_date": "2026-01-01",
  "maturity_date": "2026-01-01",
  "status": "pending",
  "priority": "low",
  "creditor_name": "text",
  "creditor_contact": "text",
  "creditor_email": "name@gmail.com",
  "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-01-01T00:00:00.000Z",
  "last_updated": "2026-01-01T00:00:00.000Z"
}

Retrieve liability

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

Get detailed information about a specific liability

Authorizations
sessionidstringRequired
Path parameters
org_uidstringRequired
unique_idstringRequired
Responses
200Success
application/json

Detailed serializer for single liability retrieval.

unique_idstring · max: 100 · nullableOptional
namestringRead-onlyRequired
descriptionstringRead-onlyRequired
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 liability amount

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

Current outstanding balance

Pattern: ^-?\d{0,13}(?:\.\d{0,2})?$
remaining_balancestring · decimalRead-onlyRequiredPattern: ^-?\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

Date when liability was incurred

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_document_urlstring · uri · nullableRead-onlyRequired
is_overduebooleanRead-onlyRequired
days_until_dueinteger · nullableRead-onlyRequired
date_createdstring · date-time · nullableOptional
last_updatedstring · date-time · nullableOptional
get/api/v1.0/organisation/{org_uid}/liabilities/{unique_id}/
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-01-01",
  "due_date": "2026-01-01",
  "payment_date": "2026-01-01",
  "maturity_date": "2026-01-01",
  "status": "pending",
  "priority": "low",
  "creditor_name": "text",
  "creditor_contact": "text",
  "creditor_email": "name@gmail.com",
  "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-01-01T00:00:00.000Z",
  "last_updated": "2026-01-01T00:00:00.000Z"
}

Update liability

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

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

Authorizations
sessionidstringRequired
Path parameters
org_uidstringRequired
unique_idstringRequired
Body

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

Detailed serializer for single liability retrieval.

unique_idstring · max: 100 · nullableOptional
namestringRead-onlyRequired
descriptionstringRead-onlyRequired
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 liability amount

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

Current outstanding balance

Pattern: ^-?\d{0,13}(?:\.\d{0,2})?$
remaining_balancestring · decimalRead-onlyRequiredPattern: ^-?\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

Date when liability was incurred

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_document_urlstring · uri · nullableRead-onlyRequired
is_overduebooleanRead-onlyRequired
days_until_dueinteger · nullableRead-onlyRequired
date_createdstring · date-time · nullableOptional
last_updatedstring · date-time · nullableOptional
put/api/v1.0/organisation/{org_uid}/liabilities/{unique_id}/update/
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-01-01",
  "due_date": "2026-01-01",
  "payment_date": "2026-01-01",
  "maturity_date": "2026-01-01",
  "status": "pending",
  "priority": "low",
  "creditor_name": "text",
  "creditor_contact": "text",
  "creditor_email": "name@gmail.com",
  "creditor_phone": "text",
  "payment_terms": "text",
  "late_fee_rate": "text",
  "category": "text",
  "department": "text",
  "project_reference": "text",
  "supporting_document": "binary"
}
{
  "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-01-01",
  "due_date": "2026-01-01",
  "payment_date": "2026-01-01",
  "maturity_date": "2026-01-01",
  "status": "pending",
  "priority": "low",
  "creditor_name": "text",
  "creditor_contact": "text",
  "creditor_email": "name@gmail.com",
  "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-01-01T00:00:00.000Z",
  "last_updated": "2026-01-01T00:00:00.000Z"
}

Update liability

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

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

Authorizations
sessionidstringRequired
Path parameters
org_uidstringRequired
unique_idstringRequired
Body

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

Detailed serializer for single liability retrieval.

unique_idstring · max: 100 · nullableOptional
namestringRead-onlyRequired
descriptionstringRead-onlyRequired
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 liability amount

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

Current outstanding balance

Pattern: ^-?\d{0,13}(?:\.\d{0,2})?$
remaining_balancestring · decimalRead-onlyRequiredPattern: ^-?\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

Date when liability was incurred

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_document_urlstring · uri · nullableRead-onlyRequired
is_overduebooleanRead-onlyRequired
days_until_dueinteger · nullableRead-onlyRequired
date_createdstring · date-time · nullableOptional
last_updatedstring · date-time · nullableOptional
patch/api/v1.0/organisation/{org_uid}/liabilities/{unique_id}/update/
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-01-01",
  "due_date": "2026-01-01",
  "payment_date": "2026-01-01",
  "maturity_date": "2026-01-01",
  "status": "pending",
  "priority": "low",
  "creditor_name": "text",
  "creditor_contact": "text",
  "creditor_email": "name@gmail.com",
  "creditor_phone": "text",
  "payment_terms": "text",
  "late_fee_rate": "text",
  "category": "text",
  "department": "text",
  "project_reference": "text",
  "supporting_document": "binary"
}
{
  "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-01-01",
  "due_date": "2026-01-01",
  "payment_date": "2026-01-01",
  "maturity_date": "2026-01-01",
  "status": "pending",
  "priority": "low",
  "creditor_name": "text",
  "creditor_contact": "text",
  "creditor_email": "name@gmail.com",
  "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-01-01T00:00:00.000Z",
  "last_updated": "2026-01-01T00:00:00.000Z"
}

Perform action on liability

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

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

Authorizations
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

Detailed serializer for single liability retrieval.

unique_idstring · max: 100 · nullableOptional
namestringRead-onlyRequired
descriptionstringRead-onlyRequired
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 liability amount

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

Current outstanding balance

Pattern: ^-?\d{0,13}(?:\.\d{0,2})?$
remaining_balancestring · decimalRead-onlyRequiredPattern: ^-?\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

Date when liability was incurred

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_document_urlstring · uri · nullableRead-onlyRequired
is_overduebooleanRead-onlyRequired
days_until_dueinteger · nullableRead-onlyRequired
date_createdstring · date-time · nullableOptional
last_updatedstring · date-time · nullableOptional
get/api/v1.0/organisation/{org_uid}/liabilities/{unique_id}/action/
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-01-01",
  "due_date": "2026-01-01",
  "payment_date": "2026-01-01",
  "maturity_date": "2026-01-01",
  "status": "pending",
  "priority": "low",
  "creditor_name": "text",
  "creditor_contact": "text",
  "creditor_email": "name@gmail.com",
  "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-01-01T00:00:00.000Z",
  "last_updated": "2026-01-01T00:00:00.000Z"
}
Previous🏭 Assets
Next💰 Finance

Last updated