Skip to main content

Evidence Requests

List what to ask the customer receivables team: open potential rows with a request, grouped by cost unit and framework number, as JSON or a CSV attachment.

GET /v1/money-found/evidence-requests turns the open potential rows that carry a request into a list to send to the customer's receivables team. The rows are grouped by cost unit and framework number, largest first. Each group has the customer, the contracts involved, the total, and one item per row to confirm with the ask in plain words, the amount and the period.

With format=csv the list is returned as an attachment named money-found-evidence-requests.csv, one line per row to confirm. Without it the response is JSON. Like the ledger, the call reads the lever ledger and answers 503 while the first build is still running.

GET/v1/money-found/evidence-requests

Query parameters

formatstringcsv returns the file; omit it for JSON.

Response fields (JSON)

currencystringLedger currency.
groups[].cost_unit / framework_number / customerstring | nullWhat the group is keyed on and the customer it concerns.
groups[].contractsstring[]Contracts in the group.
groups[].totalnumberSum of the items.
groups[].items[]arraylever_id, row_key, invoice_type, period, ask, amount and contract per row to confirm.

cURL: JSON

curl "https://api.talonic.com/v1/money-found/evidence-requests" \
  -H "Authorization: Bearer $TALONIC_API_KEY"

Response: One group

{
  "currency": "EUR",
  "groups": [
    {
      "cost_unit": "4711",
      "framework_number": "RV-2024-018",
      "customer": "Stadtwerke Beispiel",
      "contracts": ["RV-2024-018"],
      "total": 5320,
      "items": [
        { "lever_id": "recurring_charge_not_invoiced", "row_key": "r_81c2e0", "invoice_type": "RE", "period": "2025-Q3", "ask": "Confirm no invoice was issued for the Q3 2025 base charge.", "amount": 5320, "contract": "RV-2024-018" }
      ]
    }
  ]
}
Only rows in the potential tier that carry a request appear here. A potential row is exposure, not entitlement. This route returns the questions to ask and records no answers.

Frequently asked questions

Which rows are included?+
Open rows in the potential tier that carry a request. Owed rows need no confirmation, and rows without a request have nothing to ask. Rows a person resolved or dismissed are not open.
How is the CSV shaped?+
One line per row to confirm, returned as an attachment named money-found-evidence-requests.csv. It carries the same items as the JSON groups, so the two formats agree for the same ledger.
Why does the call return 503?+
The call reads the lever ledger. When no ledger is stored and the first build is still running, it answers 503. Retry in a few minutes.

Related

Money Found Overview
The Lever Ledger
Contract Price Re-reviews