Self Report

Self-reported invoice and cashflow data endpoints

Submit self-reported cashflows

post

Submit cashflow items for the authenticated organization. Each entry in items takes one of three shapes, selected by its type field:

• transaction — an individual transaction with a precise datetime and a required externalId for deduplication.

• aggregate — a daily total for a date (zero allowed for no-activity days).

• collateral — a cumulative collateral snapshot for a date.

Items flow through the standard capture → normalize pipeline. Transactions and aggregates become ledger entries; collateral snapshots are stored in the dedicated collateral_snapshots table.

Authorizations

ApiKeyAuth

x-api-keystringRequired

API key in the format: cc_xxx_yyy (for customer API routes)

Body

application/json

Responses

202

Default Response

application/json

messagestringRequired

captureIdstring · uuidRequired

jobIdstringRequired

itemCountintegerRequired

400

Default Response

application/json

401

Default Response

application/json

404

Default Response

application/json

post/v3/self-report/cashflows

HTTPcURLJavaScriptPython

POST /v3/self-report/cashflows HTTP/1.1
Host: api.creditcoop.xyz
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 160

{
  "items": [
    {
      "type": "transaction",
      "amount": 1,
      "currency": "text",
      "datetime": "2026-07-12T07:45:29.721Z",
      "direction": "inflow",
      "externalId": "text",
      "category": "text"
    }
  ]
}

{
  "message": "text",
  "captureId": "123e4567-e89b-12d3-a456-426614174000",
  "jobId": "text",
  "itemCount": 1
}