Organisation Management

Organisation and member management endpoints

List user organisations

get

Retrieve list of organisations where the user is a member or owner

Authorizations

basicAuth

AuthorizationstringRequired

Responses

200Success

application/json

get

/api/v1.0/organisations/

HTTPcURLJavaScriptPython

GET /api/v1.0/organisations/ HTTP/1.1
Host: skhokho.ai
Authorization: Basic username:password
Accept: */*

200Success

[
  {
    "unique_id": "text",
    "name": "text",
    "language": "en",
    "language_display": "text",
    "business_description": "text",
    "business_category": "agriculture",
    "business_category_display": "text",
    "other_category": "text",
    "how_did_you_hear_about_us": "google",
    "business_website": "https://example.com",
    "vat_number": "text",
    "logo_url": "text",
    "setup_done": true,
    "address": {
      "address_line_1": "text",
      "city": "text",
      "province_state": "text",
      "postal_code": "text",
      "country_name": "text"
    },
    "banking_information": {
      "bank_name": "text",
      "account_number": "text",
      "branch_code": "text",
      "account_type": "checking",
      "routing_number": "text",
      "swift_code": "text",
      "date_created": "2025-12-11T14:07:50.783Z",
      "last_updated": "2025-12-11T14:07:50.783Z",
      "account_type_display": "text"
    },
    "owner": "text",
    "member_count": "text",
    "default_currency": "text",
    "default_vat_rate": "text",
    "financial_year_end": "01-31",
    "financial_year_end_display": "text",
    "accounting_method": "cash",
    "accounting_method_display": "text",
    "reporting_currency": "USD",
    "reporting_currency_display": "text",
    "enable_multi_currency": true,
    "auto_close_financial_year": true,
    "retain_transaction_history": true,
    "financial_year_lock_date": "2025-12-11",
    "current_financial_year_label": "text",
    "contact_agent_active": true,
    "finance_agent_active": true,
    "business_agent_active": true,
    "asset_agent_active": true,
    "client_agent_active": true,
    "docs_agent_active": true,
    "notes_agent_active": true,
    "project_agent_active": true,
    "user_manager_agent_active": true,
    "stripe_customer_id": "text",
    "monthly_ai_credits_allocated": "text",
    "monthly_ai_credits_used": "text",
    "monthly_ai_credits_remaining": "text",
    "last_monthly_reset_date": "2025-12-11",
    "current_billing_cycle_start": "2025-12-11",
    "current_billing_cycle_end": "2025-12-11",
    "purchased_seats": 1,
    "date_created": "2025-12-11T14:07:50.783Z",
    "last_updated": "2025-12-11T14:07:50.783Z"
  }
]

Get organisation details

get

Get basic information about an organisation

Authorizations

basicAuth

AuthorizationstringRequired

Path parameters

unique_idstringRequired

Responses

200Success

application/json

401Error

application/json

404Error

application/json

get

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

HTTPcURLJavaScriptPython

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

{
  "unique_id": "text",
  "name": "text",
  "language": "en",
  "language_display": "text",
  "business_description": "text",
  "business_category": "agriculture",
  "business_category_display": "text",
  "business_website": "https://example.com",
  "logo_url": "text",
  "owner": "text",
  "member_count": "text",
  "date_created": "2025-12-11T14:07:50.783Z",
  "last_updated": "2025-12-11T14:07:50.783Z"
}

Update organisation details

put

Update organisation settings (owner only)

Authorizations

basicAuth

AuthorizationstringRequired

Path parameters

unique_idstringRequired

Responses

200Success

application/json

400Error

application/json

401Error

application/json

403Error

application/json

put

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

HTTPcURLJavaScriptPython

PUT /api/v1.0/organisation/{unique_id}/update/ HTTP/1.1
Host: skhokho.ai
Authorization: Basic username:password
Accept: */*

{
  "unique_id": "text",
  "name": "text",
  "language": "en",
  "language_display": "text",
  "business_description": "text",
  "business_category": "agriculture",
  "business_category_display": "text",
  "other_category": "text",
  "how_did_you_hear_about_us": "google",
  "business_website": "https://example.com",
  "vat_number": "text",
  "logo_url": "text",
  "setup_done": true,
  "address": {
    "address_line_1": "text",
    "city": "text",
    "province_state": "text",
    "postal_code": "text",
    "country_name": "text"
  },
  "banking_information": {
    "bank_name": "text",
    "account_number": "text",
    "branch_code": "text",
    "account_type": "checking",
    "routing_number": "text",
    "swift_code": "text",
    "date_created": "2025-12-11T14:07:50.783Z",
    "last_updated": "2025-12-11T14:07:50.783Z",
    "account_type_display": "text"
  },
  "owner": "text",
  "member_count": "text",
  "default_currency": "text",
  "default_vat_rate": "text",
  "financial_year_end": "01-31",
  "financial_year_end_display": "text",
  "accounting_method": "cash",
  "accounting_method_display": "text",
  "reporting_currency": "USD",
  "reporting_currency_display": "text",
  "enable_multi_currency": true,
  "auto_close_financial_year": true,
  "retain_transaction_history": true,
  "financial_year_lock_date": "2025-12-11",
  "current_financial_year_label": "text",
  "contact_agent_active": true,
  "finance_agent_active": true,
  "business_agent_active": true,
  "asset_agent_active": true,
  "client_agent_active": true,
  "docs_agent_active": true,
  "notes_agent_active": true,
  "project_agent_active": true,
  "user_manager_agent_active": true,
  "stripe_customer_id": "text",
  "monthly_ai_credits_allocated": "text",
  "monthly_ai_credits_used": "text",
  "monthly_ai_credits_remaining": "text",
  "last_monthly_reset_date": "2025-12-11",
  "current_billing_cycle_start": "2025-12-11",
  "current_billing_cycle_end": "2025-12-11",
  "purchased_seats": 1,
  "date_created": "2025-12-11T14:07:50.783Z",
  "last_updated": "2025-12-11T14:07:50.783Z"
}

Update organisation details

patch

Update organisation settings (owner only)

Authorizations

basicAuth

AuthorizationstringRequired

Path parameters

unique_idstringRequired

Responses

200Success

application/json

400Error

application/json

401Error

application/json

403Error

application/json

patch

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

HTTPcURLJavaScriptPython

PATCH /api/v1.0/organisation/{unique_id}/update/ HTTP/1.1
Host: skhokho.ai
Authorization: Basic username:password
Accept: */*

{
  "unique_id": "text",
  "name": "text",
  "language": "en",
  "language_display": "text",
  "business_description": "text",
  "business_category": "agriculture",
  "business_category_display": "text",
  "other_category": "text",
  "how_did_you_hear_about_us": "google",
  "business_website": "https://example.com",
  "vat_number": "text",
  "logo_url": "text",
  "setup_done": true,
  "address": {
    "address_line_1": "text",
    "city": "text",
    "province_state": "text",
    "postal_code": "text",
    "country_name": "text"
  },
  "banking_information": {
    "bank_name": "text",
    "account_number": "text",
    "branch_code": "text",
    "account_type": "checking",
    "routing_number": "text",
    "swift_code": "text",
    "date_created": "2025-12-11T14:07:50.783Z",
    "last_updated": "2025-12-11T14:07:50.783Z",
    "account_type_display": "text"
  },
  "owner": "text",
  "member_count": "text",
  "default_currency": "text",
  "default_vat_rate": "text",
  "financial_year_end": "01-31",
  "financial_year_end_display": "text",
  "accounting_method": "cash",
  "accounting_method_display": "text",
  "reporting_currency": "USD",
  "reporting_currency_display": "text",
  "enable_multi_currency": true,
  "auto_close_financial_year": true,
  "retain_transaction_history": true,
  "financial_year_lock_date": "2025-12-11",
  "current_financial_year_label": "text",
  "contact_agent_active": true,
  "finance_agent_active": true,
  "business_agent_active": true,
  "asset_agent_active": true,
  "client_agent_active": true,
  "docs_agent_active": true,
  "notes_agent_active": true,
  "project_agent_active": true,
  "user_manager_agent_active": true,
  "stripe_customer_id": "text",
  "monthly_ai_credits_allocated": "text",
  "monthly_ai_credits_used": "text",
  "monthly_ai_credits_remaining": "text",
  "last_monthly_reset_date": "2025-12-11",
  "current_billing_cycle_start": "2025-12-11",
  "current_billing_cycle_end": "2025-12-11",
  "purchased_seats": 1,
  "date_created": "2025-12-11T14:07:50.783Z",
  "last_updated": "2025-12-11T14:07:50.783Z"
}

List organisation members

get

Get all members of an organisation

Authorizations

basicAuth

AuthorizationstringRequired

Path parameters

unique_idstringRequired

Responses

200Success

application/json

get

/api/v1.0/organisation/{unique_id}/people/

HTTPcURLJavaScriptPython

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

200Success

[
  {
    "unique_id": "text",
    "user": {
      "first_name": "text",
      "last_name": "text",
      "email": "[email protected]"
    },
    "current_language": "en",
    "language_display": "text",
    "profile_picture_url": "text",
    "job_title": "text",
    "is_owner": true,
    "user_type": "user",
    "user_type_display": "text",
    "organisation_details": "text",
    "address": {
      "address_line_1": "text",
      "city": "text",
      "province_state": "text",
      "postal_code": "text",
      "country_name": "text"
    },
    "banking_information": {
      "bank_name": "text",
      "account_number": "text",
      "branch_code": "text",
      "account_type": "checking",
      "routing_number": "text",
      "swift_code": "text",
      "date_created": "2025-12-11T14:07:50.783Z",
      "last_updated": "2025-12-11T14:07:50.783Z",
      "account_type_display": "text"
    },
    "employee_information": {
      "id_number": "text",
      "employee_number": "text",
      "tax_number": "text",
      "phone_number": "text",
      "birthday": "2025-12-11",
      "linkedin_url": "https://example.com",
      "emergency_contact": "text",
      "emergency_phone": "text",
      "medical_aid_number": "text",
      "medical_aid_provider": "text",
      "medical_aid_plan": "text",
      "medical_conditions": "text",
      "allergies": "text",
      "medications": "text",
      "start_date": "2025-12-11",
      "end_date": "2025-12-11",
      "is_active_employee": true,
      "date_created": "2025-12-11T14:07:50.783Z",
      "last_updated": "2025-12-11T14:07:50.783Z"
    },
    "last_login": "2025-12-11T14:07:50.783Z",
    "date_created": "2025-12-11T14:07:50.783Z",
    "last_updated": "2025-12-11T14:07:50.783Z"
  }
]

Get person details

get

Get detailed information about a specific person in an organisation

Authorizations

basicAuth

AuthorizationstringRequired

Path parameters

unique_idstringRequired

user_unique_idstringRequired

Responses

200Success

application/json

get

/api/v1.0/organisation/{unique_id}/person/{user_unique_id}/

HTTPcURLJavaScriptPython

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

200Success

{
  "unique_id": "text",
  "user": {
    "first_name": "text",
    "last_name": "text",
    "email": "[email protected]"
  },
  "current_language": "en",
  "language_display": "text",
  "profile_picture_url": "text",
  "job_title": "text",
  "is_owner": true,
  "user_type": "user",
  "user_type_display": "text",
  "organisation_details": "text",
  "address": {
    "address_line_1": "text",
    "city": "text",
    "province_state": "text",
    "postal_code": "text",
    "country_name": "text"
  },
  "banking_information": {
    "bank_name": "text",
    "account_number": "text",
    "branch_code": "text",
    "account_type": "checking",
    "routing_number": "text",
    "swift_code": "text",
    "date_created": "2025-12-11T14:07:50.783Z",
    "last_updated": "2025-12-11T14:07:50.783Z",
    "account_type_display": "text"
  },
  "employee_information": {
    "id_number": "text",
    "employee_number": "text",
    "tax_number": "text",
    "phone_number": "text",
    "birthday": "2025-12-11",
    "linkedin_url": "https://example.com",
    "emergency_contact": "text",
    "emergency_phone": "text",
    "medical_aid_number": "text",
    "medical_aid_provider": "text",
    "medical_aid_plan": "text",
    "medical_conditions": "text",
    "allergies": "text",
    "medications": "text",
    "start_date": "2025-12-11",
    "end_date": "2025-12-11",
    "is_active_employee": true,
    "date_created": "2025-12-11T14:07:50.783Z",
    "last_updated": "2025-12-11T14:07:50.783Z"
  },
  "last_login": "2025-12-11T14:07:50.783Z",
  "date_created": "2025-12-11T14:07:50.783Z",
  "last_updated": "2025-12-11T14:07:50.783Z"
}