TradeVowConnectRequest API access
Family B/v1/verifications

KYB & trust APIs

Submit provider checks, evidence and recommendations while preserving TradeVow’s separate policy and manual-review decision.

Designed for: Company registries, KYB providers, screening services, banks and trusted credential issuers

MethodEndpoint
POST
/v1/organizations/{organization_id}/verifications

Submit provider checks, outcome, reason codes and validity.

GET
/v1/organizations/{organization_id}/verifications

List permitted current and historical verification records.

GET
/v1/verifications/{verification_id}

Return a check-level verification projection.

POST
/v1/verifications/{verification_id}/checks

Append a source-specific verification check.

POST
/v1/verifications/{verification_id}/evidence

Link evidence metadata to a verification.

POST
/v1/verifications/{verification_id}/decisions

Record an authorised policy or manual-review decision.

Postman example

Submit a KYB verification

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

Domain rules

  • Provider outcome and TradeVow decision are separate fields.
  • Every check carries source, observed time and evidence references.
  • Inconclusive or conflicting checks route to manual review.
  • Expiry and refresh requirements remain explicit.

Related events

organization.kyb.status_changedverification.check_completedverification.referredverification.expiring