🏦 Accounts

Chart of accounts and account management

List accounts

get

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

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

List all accounts (chart of accounts) for an organization

Authorizations

basicAuthcookieAuth

AuthorizationstringRequired

Path parameters

org_idstringRequired

Query parameters

account_categorystringOptional

Filter by account category

account_typestring · enumOptional

Filter by account type

Possible values:

is_activestringOptional

Filter by active status (true/false)

parent_accountstringOptional

Filter by parent account unique_id (use "null" for top-level accounts)

searchstringOptional

Search account_code or name

Responses

200Success

application/json

401

Unauthorized

403

Forbidden

get

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

HTTPcURLJavaScriptPython

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

[
  {
    "unique_id": "text",
    "name": "text",
    "account_code": "text",
    "full_account_code": "text",
    "account_type": "asset",
    "account_type_display": "text",
    "account_category": "current_assets",
    "account_category_display": "text",
    "current_balance": "text",
    "is_active": true,
    "has_sub_accounts": true,
    "date_created": "2026-02-04T19:40:46.115Z"
  }
]

Create account

post

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

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

Create a new account in the chart of accounts

Authorizations

basicAuthcookieAuth

AuthorizationstringRequired

Path parameters

org_idstringRequired

Body

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

Comprehensive serializer for Account model. Handles chart of accounts with multilingual support and hierarchy.

unique_idstring · max: 100 · nullableOptional

namestring · min: 1Required

descriptionstring · nullableOptional

account_codestring · min: 1 · max: 20Required

account_typestring · enumRequired

• asset - Asset
• liability - Liability
• equity - Equity
• income - Income
• expense - Expense

Possible values:

account_categorystring · enumRequired

• current_assets - Current Assets
• fixed_assets - Fixed Assets
• intangible_assets - Intangible Assets
• current_liabilities - Current Liabilities
• long_term_liabilities - Long-term Liabilities
• owner_equity - Owner Equity
• retained_earnings - Retained Earnings
• operating_income - Operating Income
• other_income - Other Income
• cost_of_goods_sold - Cost of Goods Sold
• operating_expenses - Operating Expenses
• administrative_expenses - Administrative Expenses
• financial_expenses - Financial Expenses
• other_expenses - Other Expenses

Possible values:

parent_account_idstring · min: 1 · nullableWrite-onlyOptional

is_activebooleanOptional

is_system_accountbooleanOptional

System accounts cannot be deleted

Responses

201Success

application/json

400

Bad Request

401

Unauthorized

403

Forbidden

post

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

HTTPcURLJavaScriptPython

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

{
  "unique_id": "text",
  "name": "text",
  "description": "text",
  "account_code": "text",
  "account_type": "asset",
  "account_category": "current_assets",
  "parent_account_id": "text",
  "is_active": true,
  "is_system_account": true
}

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

{
  "unique_id": "text",
  "name": "text",
  "description": "text",
  "account_code": "text",
  "account_type": "asset",
  "account_type_display": "text",
  "account_category": "current_assets",
  "account_category_display": "text",
  "parent_account": {
    "unique_id": "text",
    "account_code": "text",
    "name": "text",
    "account_type": "asset"
  },
  "full_account_code": "text",
  "account_path": "text",
  "current_balance": "text",
  "is_active": true,
  "is_system_account": true,
  "has_sub_accounts": true,
  "created_by": {
    "unique_id": "text",
    "full_name": "text"
  },
  "date_created": "2026-02-04T19:40:46.115Z",
  "last_updated": "2026-02-04T19:40:46.115Z",
  "sub_accounts_count": 1,
  "transaction_count": 1
}

Get account

get

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

/api/v1.0/organisation/{org_id}/accounts/{account_id}/

Retrieve a specific account by ID

Authorizations

basicAuthcookieAuth

AuthorizationstringRequired

Path parameters

account_idstringRequired

org_idstringRequired

Responses

200Success

application/json

401

Unauthorized

403

Forbidden

404

Not Found

get

/api/v1.0/organisation/{org_id}/accounts/{account_id}/

HTTPcURLJavaScriptPython

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

{
  "unique_id": "text",
  "name": "text",
  "description": "text",
  "account_code": "text",
  "account_type": "asset",
  "account_type_display": "text",
  "account_category": "current_assets",
  "account_category_display": "text",
  "parent_account": {
    "unique_id": "text",
    "account_code": "text",
    "name": "text",
    "account_type": "asset"
  },
  "full_account_code": "text",
  "account_path": "text",
  "current_balance": "text",
  "is_active": true,
  "is_system_account": true,
  "has_sub_accounts": true,
  "created_by": {
    "unique_id": "text",
    "full_name": "text"
  },
  "date_created": "2026-02-04T19:40:46.115Z",
  "last_updated": "2026-02-04T19:40:46.115Z",
  "sub_accounts_count": 1,
  "transaction_count": 1
}

Update account

put

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

/api/v1.0/organisation/{org_id}/accounts/{account_id}/update/

Update an existing account

Authorizations

basicAuthcookieAuth

AuthorizationstringRequired

Path parameters

account_idstringRequired

org_idstringRequired

Body

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

Comprehensive serializer for Account model. Handles chart of accounts with multilingual support and hierarchy.

unique_idstring · max: 100 · nullableOptional

namestring · min: 1Required

descriptionstring · nullableOptional

account_codestring · min: 1 · max: 20Required

account_typestring · enumRequired

• asset - Asset
• liability - Liability
• equity - Equity
• income - Income
• expense - Expense

Possible values:

account_categorystring · enumRequired

• current_assets - Current Assets
• fixed_assets - Fixed Assets
• intangible_assets - Intangible Assets
• current_liabilities - Current Liabilities
• long_term_liabilities - Long-term Liabilities
• owner_equity - Owner Equity
• retained_earnings - Retained Earnings
• operating_income - Operating Income
• other_income - Other Income
• cost_of_goods_sold - Cost of Goods Sold
• operating_expenses - Operating Expenses
• administrative_expenses - Administrative Expenses
• financial_expenses - Financial Expenses
• other_expenses - Other Expenses

Possible values:

parent_account_idstring · min: 1 · nullableWrite-onlyOptional

is_activebooleanOptional

is_system_accountbooleanOptional

System accounts cannot be deleted

Responses

200Success

application/json

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

put

/api/v1.0/organisation/{org_id}/accounts/{account_id}/update/

HTTPcURLJavaScriptPython

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

{
  "unique_id": "text",
  "name": "text",
  "description": "text",
  "account_code": "text",
  "account_type": "asset",
  "account_category": "current_assets",
  "parent_account_id": "text",
  "is_active": true,
  "is_system_account": true
}

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

{
  "unique_id": "text",
  "name": "text",
  "description": "text",
  "account_code": "text",
  "account_type": "asset",
  "account_type_display": "text",
  "account_category": "current_assets",
  "account_category_display": "text",
  "parent_account": {
    "unique_id": "text",
    "account_code": "text",
    "name": "text",
    "account_type": "asset"
  },
  "full_account_code": "text",
  "account_path": "text",
  "current_balance": "text",
  "is_active": true,
  "is_system_account": true,
  "has_sub_accounts": true,
  "created_by": {
    "unique_id": "text",
    "full_name": "text"
  },
  "date_created": "2026-02-04T19:40:46.115Z",
  "last_updated": "2026-02-04T19:40:46.115Z",
  "sub_accounts_count": 1,
  "transaction_count": 1
}

Update account

patch

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

/api/v1.0/organisation/{org_id}/accounts/{account_id}/update/

Update an existing account

Authorizations

basicAuthcookieAuth

AuthorizationstringRequired

Path parameters

account_idstringRequired

org_idstringRequired

Body

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

Comprehensive serializer for Account model. Handles chart of accounts with multilingual support and hierarchy.

unique_idstring · max: 100 · nullableOptional

namestring · min: 1Optional

descriptionstring · nullableOptional

account_codestring · min: 1 · max: 20Optional

account_typestring · enumOptional

• asset - Asset
• liability - Liability
• equity - Equity
• income - Income
• expense - Expense

Possible values:

account_categorystring · enumOptional

• current_assets - Current Assets
• fixed_assets - Fixed Assets
• intangible_assets - Intangible Assets
• current_liabilities - Current Liabilities
• long_term_liabilities - Long-term Liabilities
• owner_equity - Owner Equity
• retained_earnings - Retained Earnings
• operating_income - Operating Income
• other_income - Other Income
• cost_of_goods_sold - Cost of Goods Sold
• operating_expenses - Operating Expenses
• administrative_expenses - Administrative Expenses
• financial_expenses - Financial Expenses
• other_expenses - Other Expenses

Possible values:

parent_account_idstring · min: 1 · nullableWrite-onlyOptional

is_activebooleanOptional

is_system_accountbooleanOptional

System accounts cannot be deleted

Responses

200Success

application/json

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

patch

/api/v1.0/organisation/{org_id}/accounts/{account_id}/update/

HTTPcURLJavaScriptPython

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

{
  "unique_id": "text",
  "name": "text",
  "description": "text",
  "account_code": "text",
  "account_type": "asset",
  "account_category": "current_assets",
  "parent_account_id": "text",
  "is_active": true,
  "is_system_account": true
}

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

{
  "unique_id": "text",
  "name": "text",
  "description": "text",
  "account_code": "text",
  "account_type": "asset",
  "account_type_display": "text",
  "account_category": "current_assets",
  "account_category_display": "text",
  "parent_account": {
    "unique_id": "text",
    "account_code": "text",
    "name": "text",
    "account_type": "asset"
  },
  "full_account_code": "text",
  "account_path": "text",
  "current_balance": "text",
  "is_active": true,
  "is_system_account": true,
  "has_sub_accounts": true,
  "created_by": {
    "unique_id": "text",
    "full_name": "text"
  },
  "date_created": "2026-02-04T19:40:46.115Z",
  "last_updated": "2026-02-04T19:40:46.115Z",
  "sub_accounts_count": 1,
  "transaction_count": 1
}

Perform account action

get

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

/api/v1.0/organisation/{org_id}/accounts/{account_id}/action/

Perform an action on an account using query parameter.

**Available Actions:**
- `activate` - Activate a deactivated account
- `deactivate` - Deactivate an account (soft delete, use instead of deleting accounts with transactions)

**Examples:**
- `/accounts/{id}/action?action=activate`
- `/accounts/{id}/action?action=deactivate`

Authorizations

basicAuthcookieAuth

AuthorizationstringRequired

Path parameters

account_idstringRequired

org_idstringRequired

Responses

200Success

application/json

400

Bad Request - Invalid action or system account cannot be deactivated

401

Unauthorized

403

Forbidden

404

Not Found

get

/api/v1.0/organisation/{org_id}/accounts/{account_id}/action/

HTTPcURLJavaScriptPython

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

{
  "unique_id": "text",
  "name": "text",
  "description": "text",
  "account_code": "text",
  "account_type": "asset",
  "account_type_display": "text",
  "account_category": "current_assets",
  "account_category_display": "text",
  "parent_account": {
    "unique_id": "text",
    "account_code": "text",
    "name": "text",
    "account_type": "asset"
  },
  "full_account_code": "text",
  "account_path": "text",
  "current_balance": "text",
  "is_active": true,
  "is_system_account": true,
  "has_sub_accounts": true,
  "created_by": {
    "unique_id": "text",
    "full_name": "text"
  },
  "date_created": "2026-02-04T19:40:46.115Z",
  "last_updated": "2026-02-04T19:40:46.115Z",
  "sub_accounts_count": 1,
  "transaction_count": 1
}