TradeVowConnectRequest API access
Family H/v1/finance

Finance-readiness APIs

Expose permissioned readiness signals and funder submissions built from verified transaction execution rather than a disconnected application journey.

Designed for: Banks, alternative funders, credit insurers, guarantee providers and transaction originators

MethodEndpoint
POST
/v1/transactions/{transaction_id}/finance-assessments

Request or trigger a readiness assessment.

GET
/v1/transactions/{transaction_id}/finance-readiness

Read the granted signal-level readiness projection.

GET
/v1/transactions/{transaction_id}/finance-readiness-pack

Retrieve a purpose-filtered pack of signals, requirements and evidence.

POST
/v1/funding-applications

Submit a transaction-linked funding application to an authorised adapter/funder.

POST
/v1/funding-applications/{application_id}/offers

Publish a funding offer and conditions.

POST
/v1/funding-applications/{application_id}/decisions

Publish an approve, decline, refer or withdrawn decision.

Postman example

Retrieve finance readiness

GET {{base_url}}/v1/transactions/{{transaction_id}}/finance-readiness
X-TradeVow-API-Key: {{api_key}}
Content-Type: application/json
Idempotency-Key: {{$guid}}
X-Correlation-ID: {{$guid}}

Domain rules

  • Readiness exposes signal state, evidence, reasons and assessment time—not only a score.
  • Funder access requires an active finance-assessment grant.
  • Material changes recalculate affected signals and preserve the causal event.
  • A funder decision is distinct from TradeVow readiness.

Related events

finance.readiness_changedfunding.application_submittedfunding.evidence_requestedfunding.offer_receivedfunding.decision_recorded