Financial — TokenID

Get financial summary

GET /api/v1/financial/summary

Returns the aggregated financial opportunity breakdown for your account.

Response

{
  "recoverable_confirmed_usd": 142.50,
  "recoverable_review_usd": 38.20,
  "prevented_usd": 210.00,
  "preventable_modeled_usd": 95.40,
  "unexplained_critical_usd": 18.75,
  "unexplained_review_usd": 9.30,
  "total_financial_opportunity_usd": 514.15
}

Fields

Field	Description
`recoverable_confirmed_usd`	Billing errors confirmed by reconciliation — billable back to the provider
`recoverable_review_usd`	Potential errors flagged for human review
`prevented_usd`	Spend blocked by enforcement rules before reaching the provider
`preventable_modeled_usd`	Modeled savings if enforcement rules were applied to historical spend
`unexplained_critical_usd`	Critical anomalies with no matching provider explanation
`unexplained_review_usd`	Lower-confidence unexplained spend
`total_financial_opportunity_usd`	Sum of all above

Review queue

GET /api/v1/financial/review-queue

Returns violations queued for human review, ordered by dollar impact.

Resolve a dispute

PATCH /api/v1/financial/disputes/{dispute_id}

Mark a dispute as resolved.

{
  "resolution": "confirmed",
  "notes": "Provider confirmed billing error, credit issued."
}

Export disputes

GET /api/v1/financial/disputes/export

Returns a CSV of all disputes. Use ?status=open to filter.