Institutional transaction view
See how an authorised institution can receive the transaction context, supporting evidence, readiness position, outstanding conditions and review history as structured data.
Transaction
TV-TXN-20260921-8A17367FUnited Kingdom → Tunisia · Transaction v2
Commercial source
Purchase Order v4
The commercial source supporting the transaction.
Recorded source · Draft
Prepared request
LC Request v11
Prepared for controlled initial review.
Review pack
Finance-Readiness Pack v6
The current evidence and readiness record.
Human outcome
Suitable for controlled Phase 2 discussion
Independent institutional assessment remains required.
What the institution receives
Parties, corridor, goods, value and anticipated trade dates.
The documents reviewed, their source, status and current or earlier versions.
The current logistics, Customs, rules and Compliance preparation—without implying that future execution has occurred.
Readiness signals, open actions, later-stage conditions and human review history.
TradeVow presents the transaction evidence, readiness position and recorded review history. It does not make the institution’s credit, underwriting, regulatory or execution decisions.
This demonstration does not record EBRD endorsement, formal bank submission, credit approval, LC issuance, Customs clearance, shipment or settlement.
Finance-readiness position
Complete for Phase 1
Complete for Phase 1
Complete for Phase 1
Complete for Phase 1
Complete for Phase 1
Complete for Phase 1 initial review
The six signals show why the transaction is ready for controlled initial review. They are not a credit score, underwriting result or bank approval.
Outstanding actions and later-stage requirements
Retain the official Customs release if and when it is issued
Owner: Factor Inc · Due 15 December 2026 · Recorded as an open action
Review history
Current review
REVIEW-20260925-36173CA5
Suitable for controlled Phase 2 discussion
Earlier review
REVIEW-20260923-ECE001E1
Additional information requested · Pack v3 · LC v6
Earlier review
REVIEW-20260923-82104941
Suitable for controlled Phase 2 discussion · Pack v4 · LC v10
Verified transaction snapshot
This verification reference confirms that every current output relates to the same reviewed transaction state. File and package checks remain available in the integrity record.
1ea854f0a2c308b959042f21df537f6e2abaf65b5a5f980dd6ce59458db754f9Technical integration
The sections below provide the secure endpoint examples, access requirements, request parameters and structured response for technical integration teams.
Secure API access
The example below shows how an authorised institution can retrieve the reviewed transaction through TradeVow Connect. Live access requires an approved sandbox API key and permission to this transaction.
curl --request GET \
+ --url 'https://connect.tradevow.com/api/v1/transactions/TV-TXN-20260921-8A17367F/institutional-review?case_snapshot_fingerprint=1ea854f0a2c308b959042f21df537f6e2abaf65b5a5f980dd6ce59458db754f9' \
+ --header 'X-TradeVow-API-Key: $TRADEVOW_API_KEY'transactions:read| Parameter | Where it is supplied | Required | What it does |
|---|---|---|---|
| transaction_id | Path | Yes | The TradeVow transaction reference to retrieve |
| case_snapshot_fingerprint | Query | No | Optional verification reference for the exact reviewed transaction state |
Example institutional response
This example shows the transaction information available to an authorised institution. Sensitive evidence files remain separately controlled.
{
"data": {
"type": "institutional_review",
"id": "TV-TXN-20260921-8A17367F",
"attributes": {
"transaction": {
"reference": "TV-TXN-20260921-8A17367F",
"version": 2,
"status": "trade_agreed",
"corridor": {
"origin_country": "GB",
"origin_name": "United Kingdom",
"destination_country": "TN",
"destination_name": "Tunisia",
"route": "Southampton to Tunis"
},
"goods_description": "Packaging machine; Spare parts kit",
"commercial_value": {
"amount": "40000.00",
"currency": "GBP"
},
"expected_completion_date": "2026-12-01"
},
"participants": [
{
"role": "applicant",
"name": "Factor Inc",
"country": "Tunisia",
"kyb_status": "phase_1_evidence_review_complete",
"classification": "current",
"limitation": "External registry, sanctions, PEP, adverse-media and bank checks are outside this synthetic demonstration."
},
{
"role": "beneficiary",
"name": "Seller Inc",
"country": "United Kingdom",
"kyb_status": "phase_1_evidence_review_complete",
"classification": "current",
"limitation": "External registry, sanctions, PEP, adverse-media and bank checks are outside this synthetic demonstration."
}
],
"commercial_source": {
"type": "purchase_order",
"reference": "TV-PO-YJTTZB6X",
"version": 4,
"underlying_status": "draft",
"transaction_use": "confirmed_for_sourcing",
"supplier_acceptance_asserted": false,
"classification": "current"
},
"evidence": {
"accepted_record_count": 9,
"status": "reviewed_for_phase_1",
"classification": "current",
"records": [
{
"reference": "EBRD-F-CONTRACT-001",
"version": 1,
"type": "sales_contract",
"status": "reviewed_and_accepted"
},
{
"reference": "EBRD-F-SPEC-001",
"version": 1,
"type": "quotation_and_specification",
"status": "reviewed_and_accepted"
},
{
"reference": "EBRD-F-PFI-001-v2",
"version": 2,
"type": "pro_forma_invoice",
"status": "reviewed_and_accepted"
},
{
"reference": "EBRD-G-LOG-001",
"version": 1,
"type": "planned_logistics_preparation",
"status": "reviewed_and_accepted"
},
{
"reference": "TV-PO-YJTTZB6X",
"version": 4,
"type": "purchase_order",
"status": "reviewed_and_accepted"
},
{
"reference": "TV-eBL-DPUCLYD5",
"version": 2,
"type": "electronic_bill_of_lading",
"status": "reviewed_and_accepted"
},
{
"reference": "TV-CUS-DEC-4GDC2559",
"version": 7,
"type": "customs_declaration_preparation",
"status": "reviewed_and_accepted"
},
{
"reference": "TV-RULES-20260925-8N0D54",
"version": 18,
"type": "provisional_rules_assessment",
"status": "reviewed_and_accepted"
},
{
"reference": "TV-COMP-20260925-ETIORI",
"version": 10,
"type": "provisional_compliance_assessment",
"status": "reviewed_and_accepted"
}
],
"retrieval": {
"access": "separate_authorisation_required",
"note": "This response exposes metadata and lineage only. Evidence bytes require the existing controlled access and audit decision."
}
},
"actions_and_conditions": {
"open_actions": [
{
"reference": "ACT-20260922-DB7D170D",
"title": "Retain official customs release after filing",
"status": "open",
"owner": "Factor Inc",
"due_at": "2026-12-15T00:00:00Z",
"classification": "open_action",
"readiness_effect": "disclosed_future_stage_condition"
}
],
"completed_remediation": [
{
"reference": "ACT-20260921-0F80BD8B",
"status": "resolved"
},
{
"reference": "ACT-20260921-119FC0F0",
"status": "resolved"
},
{
"reference": "ACT-20260923-A197267F",
"status": "resolved"
},
{
"reference": "ACT-20260924-32B367D0",
"status": "resolved"
},
{
"reference": "ACT-20260925-0E4148DB",
"status": "resolved"
}
],
"future_stage_conditions": [
{
"code": "bank_terms_confirmation",
"description": "All LC terms and presentation requirements await bank confirmation.",
"classification": "future_stage_condition"
},
{
"code": "post_review_execution",
"description": "Shipment, customs clearance, formal bank application, credit approval, LC issuance and settlement are future stages.",
"classification": "future_stage_condition"
}
]
},
"event_and_remediation_history": {
"classification": "retained_history",
"summary": "Earlier evidence gaps and attestation corrections remain retained as resolved actions; one future customs-release action remains open.",
"completed_count": 5,
"open_count": 1
},
"logistics": {
"status": "prepared_for_phase_1",
"planned_route": "Southampton to Tunis",
"planned_shipment_date": "2026-10-05",
"electronic_bill_of_lading": {
"reference": "TV-eBL-DPUCLYD5",
"version": 2,
"status": "reviewed_and_accepted"
},
"shipment_execution": "not_started",
"classification": "current"
},
"customs": {
"reference": "TV-CUS-DEC-4GDC2559",
"version": 7,
"status": "preparation_reviewed_for_phase_1",
"filing_or_clearance": "not_asserted",
"classification": "current"
},
"rules_and_compliance": {
"rules": {
"reference": "TV-RULES-20260925-8N0D54",
"version": 18,
"status": "provisional_assessment_reviewed"
},
"compliance": {
"reference": "TV-COMP-20260925-ETIORI",
"version": 10,
"status": "provisional_assessment_reviewed"
},
"decision_boundary": "Independent institutional and qualified compliance review remains required.",
"classification": "current"
},
"lc_request": {
"reference": "LC-REQ-20260922-0972A23E",
"version": 11,
"status": "prepared_for_controlled_initial_bank_review",
"requested_finance": {
"amount": "30000.00",
"currency": "GBP"
},
"expiry_date": "2026-12-20",
"expiry_place": "Tunis Trade Centre",
"issued_lc": false,
"classification": "current"
},
"finance_readiness": {
"overall_status": "complete_for_phase_1_initial_review",
"complete_signals": 6,
"total_signals": 6,
"signals": [
{
"code": "trust_evidence",
"status": "complete_for_phase_1",
"classification": "provisional_system_assessment"
},
{
"code": "rules_evidence",
"status": "complete_for_phase_1",
"classification": "provisional_system_assessment"
},
{
"code": "pre_shipment_events",
"status": "complete_for_phase_1",
"classification": "provisional_system_assessment"
},
{
"code": "commercial_evidence",
"status": "complete_for_phase_1",
"classification": "provisional_system_assessment"
},
{
"code": "risk_and_exceptions",
"status": "complete_for_phase_1",
"classification": "provisional_system_assessment"
},
{
"code": "finance_preparation",
"status": "complete_for_phase_1_initial_review",
"classification": "provisional_system_assessment"
}
],
"interpretation": "Readiness supports controlled initial review; it is not a credit or underwriting decision."
},
"finance_readiness_pack": {
"reference": "FRP-20260925-4B6DA6CA",
"version": 6,
"status": "prepared_for_controlled_initial_bank_review",
"classification": "current",
"package_url": "https://demo.tradevow.com/ebrd-phase1/"
},
"reviews": {
"current": {
"reference": "REVIEW-20260925-36173CA5",
"outcome": "Suitable for controlled Phase 2 discussion",
"classification": "current",
"decision_type": "human_review_outcome",
"pack_reference": "FRP-20260925-4B6DA6CA",
"pack_version": 6,
"lc_request_reference": "LC-REQ-20260922-0972A23E",
"lc_request_version": 11,
"purchase_order_reference": "TV-PO-YJTTZB6X",
"purchase_order_version": 4
},
"historical": [
{
"reference": "REVIEW-20260923-ECE001E1",
"outcome_at_review": "Additional information requested",
"status_at_review": "Awaiting requested information",
"pack_reference": "FRP-20260923-1A0B27D1",
"pack_version": 3,
"lc_request_version": 6,
"classification": "historical"
},
{
"reference": "REVIEW-20260923-82104941",
"outcome_at_review": "Suitable for controlled Phase 2 discussion",
"status_at_review": "Completed",
"pack_reference": "FRP-20260923-3463E6B4",
"pack_version": 4,
"lc_request_version": 10,
"classification": "historical"
}
]
},
"source_version_register": [
{
"record_type": "transaction",
"reference": "TV-TXN-20260921-8A17367F",
"version": 2
},
{
"record_type": "purchase_order",
"reference": "TV-PO-YJTTZB6X",
"version": 4
},
{
"record_type": "lc_request",
"reference": "LC-REQ-20260922-0972A23E",
"version": 11
},
{
"record_type": "finance_readiness_pack",
"reference": "FRP-20260925-4B6DA6CA",
"version": 6
},
{
"record_type": "customs_preparation",
"reference": "TV-CUS-DEC-4GDC2559",
"version": 7
},
{
"record_type": "rules_assessment",
"reference": "TV-RULES-20260925-8N0D54",
"version": 18
},
{
"record_type": "compliance_assessment",
"reference": "TV-COMP-20260925-ETIORI",
"version": 10
},
{
"record_type": "electronic_bill_of_lading",
"reference": "TV-eBL-DPUCLYD5",
"version": 2
}
],
"execution_boundaries": {
"formal_bank_application": "not_submitted",
"credit_decision": "not_recorded",
"lc_issuance": "not_issued",
"customs_filing_or_clearance": "not_asserted",
"shipment_delivery_or_title_transfer": "not_asserted",
"settlement_execution": "not_started",
"institution_decision": "The consuming institution retains all credit, underwriting, approval and execution decisions."
}
},
"relationships": {
"transaction": {
"links": {
"related": "/v1/transactions/TV-TXN-20260921-8A17367F"
}
},
"evidence_pack": {
"links": {
"related": "/v1/transactions/TV-TXN-20260921-8A17367F/evidence-pack"
}
},
"finance_readiness": {
"links": {
"related": "/v1/transactions/TV-TXN-20260921-8A17367F/finance-readiness"
}
}
},
"links": {
"self": "/v1/transactions/TV-TXN-20260921-8A17367F/institutional-review?case_snapshot_fingerprint=1ea854f0a2c308b959042f21df537f6e2abaf65b5a5f980dd6ce59458db754f9",
"demonstration": "https://demo.tradevow.com/ebrd-phase1/"
}
},
"meta": {
"api_version": "v1",
"snapshot": {
"generated_at": "2026-09-25T16:47:19.416Z",
"case_snapshot_fingerprint": "1ea854f0a2c308b959042f21df537f6e2abaf65b5a5f980dd6ce59458db754f9",
"algorithm": "SHA-256",
"meaning": "Identifies the version-locked transaction state shared by current outputs; it is not a file hash.",
"current_at_generation": true
},
"integrity": {
"package_content_fingerprint": "abea7304213279c8197b677e4df8035ad66ad523b6bf4a43224a5f6431eade17",
"package_manifest_sha256": "21c5f2b9bfe9efa80fe4be283ae0574027b42d47d35f3a5574a93521d134030c",
"presentation_pdf_sha256": "4ee83f15d66a66beebf788ebfdd0546c0476e018082b7d2fdbcbb23240e19ab3",
"downloadable_zip_sha256": "66ba9ac7c5313e1a448eff744eba43d2647f14399d2878408297d441d0198ba6",
"note": "File, package-content, manifest, ZIP and case-snapshot fingerprints have distinct scopes."
},
"data_classification": "Confidential — controlled synthetic demonstration",
"synthetic_demonstration": true,
"decision_boundary": "No EBRD endorsement, formal bank application, underwriting decision, credit approval, LC issuance, Customs clearance or settlement is asserted."
}
}Institutional integration
TradeVow Connect shows how the same transaction context, supporting evidence, readiness position and review history can be delivered securely to an authorised institution in structured form.
Commercial, identity, logistics, Customs, Compliance and finance information remain connected to the same transaction.
Approved organisations receive only the transaction information and evidence they are authorised to access.
The institution retains responsibility for its own verification, credit, underwriting, regulatory and execution decisions.
The next step is to validate the integration against the partner institution’s own review criteria and operating environment.
Controlled demonstration · No EBRD endorsement, bank approval, LC issuance, Customs clearance, shipment or settlement is asserted.