VerificationResource Schema
Container: Resource.resourceAttributes Protocol Version: 2.0 Semantic Model: generalised Use Cases: Driving licence verification, identity verification (Aadhaar/PAN), bank account verification, skill certificate verification, education credential verification, health licence verification, address verification, employment history verification, criminal record check Tag: verification trust identity credentials people
Overview
The VerificationResource schema describes a verification service as a discoverable resource on the Beckn Verification Service Network. Each resource represents a distinct verification capability offered by a verification provider (Provider NP).
A resource answers the question: "What can this provider verify, and what do I need to provide?"
Attachment Points
This schema extends beckn:resourceAttributes on the core Resource object. No other containers are extended by this schema.
Design Rationale
- verificationType as CodedValue: Verification types are an extensible enumeration.
Using a code + name pattern allows networks to define their own verification types without schema changes.
- supportedDocumentTypes as array: A single verification service may accept multiple
document types as input (e.g., driving licence verification may accept both a licence number or a scanned document).
- requiredInputFields as self-describing contract: By listing input fields with their
types and validation patterns, the resource enables Requesting NPs to build dynamic forms without hardcoding field knowledge.
- authoritativeSource for transparency: Knowing which authoritative database backs a
verification service helps requesters assess trust and reliability.
Non-Goals
- Pricing and commercial terms (→
VerificationOffer) - Subject PII or verification results (→
VerificationContract/VerificationPerformance) - Provider authentication or API credentials
Upstream Candidates
verificationTypeCodedValue pattern — applicable to any trust/compliance networkInputFieldDescriptor/OutputFieldDescriptor— generic form-schema pattern useful
across domains requiring structured input/output contracts