🧾 Invoices

Invoice creation, management, and tracking

List invoices

get

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

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

List all invoices for an organization

Authorizations

basicAuthcookieAuth

AuthorizationstringRequired

Path parameters

org_idstringRequired

Query parameters

client_idstringOptional

Filter by client unique_id

from_datestringOptional

Filter invoices from this invoice_date (YYYY-MM-DD)

overduestringOptional

Filter overdue invoices (true/false)

searchstringOptional

Search invoice_number or title

statusstring · enumOptional

Filter by invoice status

Possible values:

to_datestringOptional

Filter invoices up to this invoice_date (YYYY-MM-DD)

Responses

200Success

application/json

401

Unauthorized

403

Forbidden

get

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

HTTPcURLJavaScriptPython

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

[
  {
    "unique_id": "text",
    "title": "text",
    "invoice_number": "text",
    "status": "draft",
    "status_display": "text",
    "invoice_date": "2026-02-04",
    "due_date": "2026-02-04",
    "total_amount": "text",
    "paid_amount": "text",
    "remaining_amount": "text",
    "is_overdue": true,
    "currency": "text",
    "client": {
      "unique_id": "text",
      "name": "text",
      "entity_type": "individual"
    },
    "date_created": "2026-02-04T19:45:13.807Z"
  }
]

Create invoice

post

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

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

Create a new invoice

Authorizations

basicAuthcookieAuth

AuthorizationstringRequired

Path parameters

org_idstringRequired

Body

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

Comprehensive serializer for Invoice model.

unique_idstring · max: 100 · nullableOptional

titlestring · min: 1Required

descriptionstring · nullableOptional

invoice_numberstring · min: 1 · max: 100Required

statusstring · enumOptional

• draft - Draft
• sent - Sent
• viewed - Viewed by Client
• paid - Paid
• partially_paid - Partially Paid
• overdue - Overdue
• cancelled - Cancelled
• refunded - Refunded

Possible values:

invoice_datestring · date · nullableOptional

due_datestring · dateRequired

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

client_idstring · min: 1Write-onlyRequired

Client unique_id (required)

Responses

201Success

application/json

400

Bad Request

401

Unauthorized

403

Forbidden

post

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

HTTPcURLJavaScriptPython

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

{
  "unique_id": "text",
  "title": "text",
  "description": "text",
  "invoice_number": "text",
  "status": "draft",
  "invoice_date": "2026-02-04",
  "due_date": "2026-02-04",
  "paid_amount": "text",
  "client_id": "text",
  "items": [
    {
      "unique_id": "text",
      "product_id": "text",
      "service_id": "text",
      "quantity": "text",
      "unit_price": "text",
      "discount_percentage": "text",
      "vat_rate": "text",
      "currency": "text"
    }
  ]
}

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

{
  "unique_id": "text",
  "title": "text",
  "description": "text",
  "invoice_number": "text",
  "status": "draft",
  "status_display": "text",
  "invoice_date": "2026-02-04",
  "due_date": "2026-02-04",
  "subtotal": "text",
  "total_tax_amount": "text",
  "total_amount": "text",
  "paid_amount": "text",
  "remaining_amount": "text",
  "is_overdue": true,
  "currency": "text",
  "client": {
    "unique_id": "text",
    "name": "text",
    "entity_type": "individual"
  },
  "items": [
    {
      "unique_id": "text",
      "item_name": "text",
      "quantity": "text",
      "unit_price": "text",
      "discount_percentage": "text",
      "vat_rate": "text",
      "currency": "text",
      "line_subtotal": "text",
      "line_vat_amount": "text",
      "line_total": "text"
    }
  ],
  "created_by": {
    "unique_id": "text",
    "full_name": "text"
  },
  "date_created": "2026-02-04T19:45:13.807Z",
  "last_updated": "2026-02-04T19:45:13.807Z"
}

Retrieve invoice

get

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

/api/v1.0/organisation/{org_id}/invoices/{invoice_id}/

Retrieve a specific invoice with full details

Authorizations

basicAuthcookieAuth

AuthorizationstringRequired

Path parameters

invoice_idstringRequired

org_idstringRequired

Responses

200Success

application/json

401

Unauthorized

403

Forbidden

404

Not Found

get

/api/v1.0/organisation/{org_id}/invoices/{invoice_id}/

HTTPcURLJavaScriptPython

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

{
  "unique_id": "text",
  "title": "text",
  "description": "text",
  "invoice_number": "text",
  "status": "draft",
  "status_display": "text",
  "invoice_date": "2026-02-04",
  "due_date": "2026-02-04",
  "subtotal": "text",
  "total_tax_amount": "text",
  "total_amount": "text",
  "paid_amount": "text",
  "remaining_amount": "text",
  "is_overdue": true,
  "currency": "text",
  "client": {
    "unique_id": "text",
    "name": "text",
    "entity_type": "individual"
  },
  "items": [
    {
      "unique_id": "text",
      "item_name": "text",
      "quantity": "text",
      "unit_price": "text",
      "discount_percentage": "text",
      "vat_rate": "text",
      "currency": "text",
      "line_subtotal": "text",
      "line_vat_amount": "text",
      "line_total": "text"
    }
  ],
  "created_by": {
    "unique_id": "text",
    "full_name": "text"
  },
  "date_created": "2026-02-04T19:45:13.807Z",
  "last_updated": "2026-02-04T19:45:13.807Z"
}

Update invoice

put

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

/api/v1.0/organisation/{org_id}/invoices/{invoice_id}/update/

Update an existing invoice

Authorizations

basicAuthcookieAuth

AuthorizationstringRequired

Path parameters

invoice_idstringRequired

org_idstringRequired

Body

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

Comprehensive serializer for Invoice model.

unique_idstring · max: 100 · nullableOptional

titlestring · min: 1Required

descriptionstring · nullableOptional

invoice_numberstring · min: 1 · max: 100Required

statusstring · enumOptional

• draft - Draft
• sent - Sent
• viewed - Viewed by Client
• paid - Paid
• partially_paid - Partially Paid
• overdue - Overdue
• cancelled - Cancelled
• refunded - Refunded

Possible values:

invoice_datestring · date · nullableOptional

due_datestring · dateRequired

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

client_idstring · min: 1Write-onlyRequired

Client unique_id (required)

Responses

200Success

application/json

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

put

/api/v1.0/organisation/{org_id}/invoices/{invoice_id}/update/

HTTPcURLJavaScriptPython

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

{
  "unique_id": "text",
  "title": "text",
  "description": "text",
  "invoice_number": "text",
  "status": "draft",
  "invoice_date": "2026-02-04",
  "due_date": "2026-02-04",
  "paid_amount": "text",
  "client_id": "text",
  "items": [
    {
      "unique_id": "text",
      "product_id": "text",
      "service_id": "text",
      "quantity": "text",
      "unit_price": "text",
      "discount_percentage": "text",
      "vat_rate": "text",
      "currency": "text"
    }
  ]
}

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

{
  "unique_id": "text",
  "title": "text",
  "description": "text",
  "invoice_number": "text",
  "status": "draft",
  "status_display": "text",
  "invoice_date": "2026-02-04",
  "due_date": "2026-02-04",
  "subtotal": "text",
  "total_tax_amount": "text",
  "total_amount": "text",
  "paid_amount": "text",
  "remaining_amount": "text",
  "is_overdue": true,
  "currency": "text",
  "client": {
    "unique_id": "text",
    "name": "text",
    "entity_type": "individual"
  },
  "items": [
    {
      "unique_id": "text",
      "item_name": "text",
      "quantity": "text",
      "unit_price": "text",
      "discount_percentage": "text",
      "vat_rate": "text",
      "currency": "text",
      "line_subtotal": "text",
      "line_vat_amount": "text",
      "line_total": "text"
    }
  ],
  "created_by": {
    "unique_id": "text",
    "full_name": "text"
  },
  "date_created": "2026-02-04T19:45:13.807Z",
  "last_updated": "2026-02-04T19:45:13.807Z"
}

Update invoice

patch

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

/api/v1.0/organisation/{org_id}/invoices/{invoice_id}/update/

Update an existing invoice

Authorizations

basicAuthcookieAuth

AuthorizationstringRequired

Path parameters

invoice_idstringRequired

org_idstringRequired

Body

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

Comprehensive serializer for Invoice model.

unique_idstring · max: 100 · nullableOptional

titlestring · min: 1Optional

descriptionstring · nullableOptional

invoice_numberstring · min: 1 · max: 100Optional

statusstring · enumOptional

• draft - Draft
• sent - Sent
• viewed - Viewed by Client
• paid - Paid
• partially_paid - Partially Paid
• overdue - Overdue
• cancelled - Cancelled
• refunded - Refunded

Possible values:

invoice_datestring · date · nullableOptional

due_datestring · dateOptional

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

client_idstring · min: 1Write-onlyOptional

Client unique_id (required)

Responses

200Success

application/json

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

patch

/api/v1.0/organisation/{org_id}/invoices/{invoice_id}/update/

HTTPcURLJavaScriptPython

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

{
  "unique_id": "text",
  "title": "text",
  "description": "text",
  "invoice_number": "text",
  "status": "draft",
  "invoice_date": "2026-02-04",
  "due_date": "2026-02-04",
  "paid_amount": "text",
  "client_id": "text",
  "items": [
    {
      "unique_id": "text",
      "product_id": "text",
      "service_id": "text",
      "quantity": "text",
      "unit_price": "text",
      "discount_percentage": "text",
      "vat_rate": "text",
      "currency": "text"
    }
  ]
}

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

{
  "unique_id": "text",
  "title": "text",
  "description": "text",
  "invoice_number": "text",
  "status": "draft",
  "status_display": "text",
  "invoice_date": "2026-02-04",
  "due_date": "2026-02-04",
  "subtotal": "text",
  "total_tax_amount": "text",
  "total_amount": "text",
  "paid_amount": "text",
  "remaining_amount": "text",
  "is_overdue": true,
  "currency": "text",
  "client": {
    "unique_id": "text",
    "name": "text",
    "entity_type": "individual"
  },
  "items": [
    {
      "unique_id": "text",
      "item_name": "text",
      "quantity": "text",
      "unit_price": "text",
      "discount_percentage": "text",
      "vat_rate": "text",
      "currency": "text",
      "line_subtotal": "text",
      "line_vat_amount": "text",
      "line_total": "text"
    }
  ],
  "created_by": {
    "unique_id": "text",
    "full_name": "text"
  },
  "date_created": "2026-02-04T19:45:13.807Z",
  "last_updated": "2026-02-04T19:45:13.807Z"
}

Perform invoice action

get

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

/api/v1.0/organisation/{org_id}/invoices/{invoice_id}/action/

Perform an action on an invoice using query parameter.

**Available Actions:**
- `send` - Mark a draft invoice as sent to the client
- `mark_as_paid` - Mark an invoice as fully paid
- `cancel` - Cancel an invoice
- `duplicate` - Create a duplicate of the invoice
- `record_payment` - Record a payment received for the invoice (requires `amount` parameter)

**Examples:**
- `/invoices/{id}/action?action=send`
- `/invoices/{id}/action?action=mark_as_paid`
- `/invoices/{id}/action?action=cancel`
- `/invoices/{id}/action?action=duplicate`
- `/invoices/{id}/action?action=record_payment&amount=1000.00`

Authorizations

basicAuthcookieAuth

AuthorizationstringRequired

Path parameters

invoice_idstringRequired

org_idstringRequired

Query parameters

actionstring · enumRequired

The action to perform on the invoice

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

400

Bad Request - Invalid action or missing required parameters

401

Unauthorized

403

Forbidden

404

Not Found

get

/api/v1.0/organisation/{org_id}/invoices/{invoice_id}/action/

HTTPcURLJavaScriptPython

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

{
  "unique_id": "text",
  "title": "text",
  "description": "text",
  "invoice_number": "text",
  "status": "draft",
  "status_display": "text",
  "invoice_date": "2026-02-04",
  "due_date": "2026-02-04",
  "subtotal": "text",
  "total_tax_amount": "text",
  "total_amount": "text",
  "paid_amount": "text",
  "remaining_amount": "text",
  "is_overdue": true,
  "currency": "text",
  "client": {
    "unique_id": "text",
    "name": "text",
    "entity_type": "individual"
  },
  "items": [
    {
      "unique_id": "text",
      "item_name": "text",
      "quantity": "text",
      "unit_price": "text",
      "discount_percentage": "text",
      "vat_rate": "text",
      "currency": "text",
      "line_subtotal": "text",
      "line_vat_amount": "text",
      "line_total": "text"
    }
  ],
  "created_by": {
    "unique_id": "text",
    "full_name": "text"
  },
  "date_created": "2026-02-04T19:45:13.807Z",
  "last_updated": "2026-02-04T19:45:13.807Z"
}