KapworkKapwork Partner API
Integrate

Common Queries

Query examples for typical use cases

Receivables

By Vendor

GET /v1/receivables?vendor_id=X

By Vendor and Debtor

GET /v1/receivables?vendor_id=X&debtor_id=Y

By Debtor

GET /v1/receivables?debtor_id=Y

All Receivables (No Time Filter)

GET /v1/receivables?verified_since=all

Since a Specific Date

GET /v1/receivables?verified_since=2026-01-01T00:00:00Z

Single Receivable

GET /v1/receivables/:id

By Status

Without a status filter, all statuses are returned. Use status to filter:

GET /v1/receivables?status=PENDING
GET /v1/receivables?status=APPROVED
GET /v1/receivables?status=PAID
GET /v1/receivables?status=SOLD
GET /v1/receivables?status=DISPUTED
GET /v1/receivables?status=ACKNOWLEDGED

Combined Filters

GET /v1/receivables?vendor_id=X&debtor_id=Y&status=APPROVED

With History

GET /v1/receivables?expand[]=history

With Metadata

GET /v1/receivables?expand[]=metadata

With Both

GET /v1/receivables?expand[]=history&expand[]=metadata

Vendors

All Vendors

GET /v1/vendors

Vendors for a Debtor

GET /v1/vendors?debtor_id=Y

Debtors

All Debtors

GET /v1/debtors

Debtors for a Vendor

GET /v1/debtors?vendor_id=X

Pagination

First Page

GET /v1/receivables?page=1&limit=100

Next Page

GET /v1/receivables?page=2&limit=100

The response includes has_more: true when additional pages exist.


Reference

QueryEndpoint
Receivables for vendor X with debtor YGET /v1/receivables?vendor_id=X&debtor_id=Y
All receivables for vendor XGET /v1/receivables?vendor_id=X
All receivables (no time filter)GET /v1/receivables?verified_since=all
Receivables updated in last 24hGET /v1/receivables
Single receivableGET /v1/receivables/:id
Debtors for vendor XGET /v1/debtors?vendor_id=X
Vendors for debtor YGET /v1/vendors?debtor_id=Y
Filter by statusGET /v1/receivables?status=APPROVED
Include history?expand[]=history
Include metadata?expand[]=metadata

Next

On this page