TradeVowConnectRequest API access
Family E/v1/evidence

Evidence & document APIs

Register, verify and share evidence metadata, governed document references and transaction evidence packs.

Designed for: Document platforms, eBL providers, issuers, verifiers, execution partners and funders

MethodEndpoint
POST
/v1/evidence/upload-requests

Request a controlled upload when TradeVow-managed storage is permitted.

POST
/v1/evidence

Register evidence metadata, partner reference or verifiable credential.

GET
/v1/evidence/{evidence_id}

Read permitted metadata and retrieval controls.

POST
/v1/evidence/{evidence_id}/verifications

Append a verification outcome and method.

POST
/v1/transactions/{transaction_id}/evidence-links

Link evidence to a transaction requirement or subject.

GET
/v1/transactions/{transaction_id}/evidence-pack

Return a purpose-filtered transaction evidence pack.

Postman example

Register partner-hosted evidence

POST {{base_url}}/v1/evidence
X-TradeVow-API-Key: {{api_key}}
Content-Type: application/json
Idempotency-Key: {{$guid}}
X-Correlation-ID: {{$guid}}

Domain rules

  • Store metadata, hash and governed reference when document duplication is unnecessary.
  • Raw bytes require a fresh access decision and short-lived retrieval.
  • Verification records issuer, method, verifier and time.
  • Replacement evidence supersedes rather than deletes history.

Related events

evidence.submittedevidence.verifiedevidence.rejectedevidence.expiredevidence.superseded