nChain Identity
Back to All
  • nChain Identity user documentation
  • 📑INTRODUCTION
    • Introduction to nChain Identity
    • Why choose nChain Identity?
      • DiD differentiators
    • How does nChain Identity work?
      • Data flows
      • Use cases and applications
    • Standards and regulations
  • 📄nChain Identity Issuers
    • What is an issuer?
    • How to become an issuer?
    • Operating an issuer
    • What do issuers do?
    • Issuer API
      • Overview
      • Getting Started
      • Examples
        • Issue an email credential
        • Revoke a claimed email credential
      • API Documentation
        • Credential Offers
        • Agent
        • Claims
  • 📑NCHAIN IDENTITY VERIFIER
    • What is a Verifier?
    • Operating a verifier
    • How to become a verifier?
    • Verifier API
      • Overview
      • Getting Started
      • Examples
        • Verify an email credential
      • API Documentation
        • Verifiable Presentation
        • Verifying
        • Agent
        • SIOP
        • Templates
  • 📄NCHAIN IDENTITY WALLET
    • What is the wallet for?
    • How to receive a Verifiable Credential?
    • How to share a Verifiable Credential?
  • 📑Privacy and Security
    • Privacy and Security Measures: NChain Identity Services
    • Revocation and data deletion
  • 🗃️SELF-SOVEREIGN IDENTITY KNOWLEDGE
    • Self-Sovereign Identity
    • Actors
    • Decentralized vs Self-Sovereign Identity
    • Key Principles of Self-Sovereign Identity
    • Self-Sovereign Identity – Use Cases
    • Digital Trust
    • Some of the critical components of Self Sovereign Identity
      • Trust over IP
    • Some of the critical components of Decentralise ID
      • A Blockchain Tailored for Decentralized Identity
      • Decentralise Identifiers (DiD)
      • Verifiable Credentials
      • Verifiable Presentations
  • 📑GLOSSARY
    • Glossary
  • 📄FAQs / HELP
    • Help & FAQs
      • What is a digital identity?
      • What is nChain Identity, and how does it work?
      • How is blockchain used in nChain Identity?
      • Compatible Blockchains for nChain Identity.
      • How can my business sign up for nChain Identity?
      • How is nChain Identity different to other identity solutions in the market?
      • Can nChain Identity communicate with other identity solutions?
      • What is nChain Identity doing with my data, and does it act as a data processor or controller?
      • What measures does nChain Identity take to protect user data?
      • What support is available for nChain Identity?
      • Can nChain Identity be integrated into our existing systems?
      • How can I get started with nChain Identity?
      • What countries is nChain Identity available in?
Powered by GitBook
On this page
  1. NCHAIN IDENTITY VERIFIER
  2. Verifier API
  3. API Documentation

Verifying

OpenAPI documentation for the "Verifying" module

PreviousVerifiable PresentationNextAgent

Last updated 5 months ago

📑
  • POSTRetrieve info about definitionId to execute subsequent requests.
  • POSTRetrieve info about definitionId to execute subsequent requests.

Retrieve info about definitionId to execute subsequent requests.

post

Endpoint facilitates the retrieval of a correlationId, definitionId, authStatusURIand authRequestURI. The correlationId is a unique identifier for the request. The definitionId is a name that's passed in the request and represents name of credential (characterCredential). The authStatusURI is a URI that shows where auth-status endpoint is located. The authRequestURI contains info that is put in QR data and is used to scan with mobile wallet app.Claim-based access control: Verifier_Admin, Verifier_User

Authorizations
Path parameters
definitionIdstringRequired
Responses
200Success
application/json
401
Invalid authentication credentials.
403
User does not have a required claim to perform this operation.
503
The agent service is unavailable
post
POST /private/webapp/definitions/{definitionId}/auth-requests HTTP/1.1
Host: ..
Authorization: Bearer JWT
Accept: */*
{
  "correlationId": "f9dbff8e-6dba-4955-bd7f-61c083db290d",
  "definitionId": "emailCredential",
  "authRequestURI": "openid-vc://?request_uri=https%3A%2F%2Fverifier-api-url%2Fprivate%2Fsiop%2Fdefinitions%2FcharacterCredential%2Fauth-requests%2Fc35f4780-8570-4346-9252-6941747107b5",
  "authStatusURI": "https://verifier-api-url/private/webapp/auth-status"
}

Retrieve info about definitionId to execute subsequent requests.

post

Returns the status of the auth request. The correlationId is a unique identifier for the request that was passed in the request. The definitionId is a name that's passed in the request and represents name of credential (characterCredential). The lastUpdated is the time the request was last updated and the status indicates if the request was verified and shared or not. status can be any of created, sent and verified. When it is verified, the payload contains details about the credential. The id_token is a JWT token that contains the nonce and state ids. The vp_token is a JWT token that contains the verifiableCredential JWT token. That token contains all the info about the credential being verified.Claim-based access control: Verifier_Admin, Verifier_User

Authorizations
Body
correlationIdstringRequired

A UUID value that is bound to the VP

Example: f9dbff8e-6dba-4955-bd7f-61c083db290d
definitionIdstringRequired

The definitionId defines the credential to ask for, eg: emailCredential. The value should start with lowercase and continue using camelCase pattern

Example: emailCredential
Responses
200Success
application/json
401
Invalid authentication credentials.
403
User does not have a required claim to perform this operation.
503
The agent service is unavailable
post
POST /private/webapp/auth-status HTTP/1.1
Host: ..
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 89

{
  "correlationId": "f9dbff8e-6dba-4955-bd7f-61c083db290d",
  "definitionId": "emailCredential"
}
{
  "correlationId": "f9dbff8e-6dba-4955-bd7f-61c083db290d",
  "definitionId": "emailCredential",
  "status": "verified",
  "lastUpdated": 1732184934133,
  "payload": {
    "access_token": "text",
    "token_type": "text",
    "expires_in": 1732184934200,
    "state": "f9dbff8e-6dba-4955-bd7f-61c083db290d",
    "vp_token": "eyJraWQiOiJkaWQ6YnN2OjdmZDllM2E1YjEzNGUyODFlZjU5Yjk5NDZlNTFlYmVjMjAwYmUwMzI0OTVjNmVhYTIwZDZkNjU1NDYxYTE5NjMjc3ViamVjdC1rZXkiLCJhbGciOiJFUzI1NksiLCJ0eXAiOiJKV1QifQ.eyJpYXQiOjE3MzIxODQ4MDMsImV4cCI6MTczMjE4NTUyMywidnAiOnsiaG9sZGVyIjoiZGlkOmJzdjo3ZmQ5ZTNhNWIxMzRlMjgxZWY1OWI5OTQ2ZTUxZWJlYzIwMGJlMDMyNDk1YzZlYWEyMGQ2ZDY1NTQ2MWExOTYzIiwiQGNvbnRleHQiOlsiaHR0cHM6Ly93d3cudzMub3JnLzIwMTgvY3JlZGVudGlhbHMvdjEiXSwidHlwZSI6WyJWZXJpZmlhYmxlUHJlc2VudGF0aW9uIl0sInZlcmlmaWFibGVDcmVkZW50aWFsIjpbImV5SmhiR2NpT2lKRlV6STFOa3NpTENKMGVYQWlPaUpLVjFRaWZRLmV5SmxlSEFpT2pFM05qTTJNekU0TXpNc0luWmpJanA3SWtCamIyNTBaWGgwSWpwYkltaDBkSEJ6T2k4dmQzZDNMbmN6TG05eVp5OHlNREU0TDJOeVpXUmxiblJwWVd4ekwzWXhJbDBzSW5SNWNHVWlPbHNpVm1WeWFXWnBZV0pzWlVOeVpXUmxiblJwWVd3aUxDSkZiV0ZwYkVOeVpXUmxiblJwWVd3aVhTd2lZM0psWkdWdWRHbGhiRk4xWW1wbFkzUWlPbnNpWlcxaGFXd2lPaUo2TG5CaGJtZHljMmxqUUc1amFHRnBiaTVqYjIwaUxDSjBlWEJsSWpvaVJXMWhhV3dnUTNKbFpHVnVkR2xoYkNJc0ltbGtJam9pWkdsa09tSnpkam8zWm1RNVpUTmhOV0l4TXpSbE1qZ3haV1kxT1dJNU9UUTJaVFV4WldKbFl6SXdNR0psTURNeU5EazFZelpsWVdFeU1HUTJaRFkxTlRRMk1XRXhPVFl6SW4wc0ltTnlaV1JsYm5ScFlXeFRkR0YwZFhNaU9uc2lhV1FpT2lJM05HVTFOVFEyT1dNellUUTRaamt6TnpNME9UTTJZbVJqT0dOaE5qbGpOMkk1WmpJNE5XRTFOV1kwTlROa1pqQXdabVJqTkdWbU9XSmlaV1EzTmpWbUlpd2lkSGx3WlNJNkltNURhR0ZwYmtsa1pXNTBhWFI1UTNKbFpHVnVkR2xoYkZKbGRtOWpZWFJwYjI1VGRHRjBkWE15TURJMEluMTlMQ0pBWTI5dWRHVjRkQ0k2V3lKb2RIUndjem92TDNkM2R5NTNNeTV2Y21jdk1qQXhPQzlqY21Wa1pXNTBhV0ZzY3k5Mk1TSmRMQ0owZVhCbElqcGJJbFpsY21sbWFXRmliR1ZEY21Wa1pXNTBhV0ZzSWl3aVJXMWhhV3hEY21Wa1pXNTBhV0ZzSWwwc0ltVjRjR2x5WVhScGIyNUVZWFJsSWpvaU1qQXlOUzB4TVMweU1GUXdPVG8wTXpvMU15NHpPRE5hSWl3aVkzSmxaR1Z1ZEdsaGJGTjFZbXBsWTNRaU9uc2laVzFoYVd3aU9pSjZMbkJoYm1keWMybGpRRzVqYUdGcGJpNWpiMjBpTENKMGVYQmxJam9pUlcxaGFXd2dRM0psWkdWdWRHbGhiQ0lzSW1sa0lqb2laR2xrT21KemRqbzNabVE1WlROaE5XSXhNelJsTWpneFpXWTFPV0k1T1RRMlpUVXhaV0psWXpJd01HSmxNRE15TkRrMVl6WmxZV0V5TUdRMlpEWTFOVFEyTVdFeE9UWXpJbjBzSW1sa0lqb2lkWEp1T25WMWFXUTZOek5oWTJObVlqa3RaV1poTVMwME1tTmhMV0kwTURVdFlUQm1ObU13WVRoaVpHUm1JaXdpWTNKbFpHVnVkR2xoYkZOMFlYUjFjeUk2ZXlKcFpDSTZJamMwWlRVMU5EWTVZek5oTkRobU9UTTNNelE1TXpaaVpHTTRZMkUyT1dNM1lqbG1NamcxWVRVMVpqUTFNMlJtTURCbVpHTTBaV1k1WW1KbFpEYzJOV1lpTENKMGVYQmxJam9pYmtOb1lXbHVTV1JsYm5ScGRIbERjbVZrWlc1MGFXRnNVbVYyYjJOaGRHbHZibE4wWVhSMWN6SXdNalFpZlN3aWFYTnpkV1Z5SWpwN0ltbGtJam9pWkdsa09tSnpkam8wT1RJME1UbG1OV1l5TnpReVl6bGpNV0ZtWkdFeU16QmtZV05tT1dJMU56QTFabUZqTWpNNE5ETmtOVFU0WlRRd1ltTTFZakZpWVdJM09HTmtZalJoSW4wc0ltbHpjM1ZoYm1ObFJHRjBaU0k2SWpJd01qUXRNVEV0TWpCVU1EazZORE02TlRNdU5EUTRXaUlzSW5OMVlpSTZJbVJwWkRwaWMzWTZOMlprT1dVellUVmlNVE0wWlRJNE1XVm1OVGxpT1RrME5tVTFNV1ZpWldNeU1EQmlaVEF6TWpRNU5XTTJaV0ZoTWpCa05tUTJOVFUwTmpGaE1UazJNeUlzSW1wMGFTSTZJblZ5YmpwMWRXbGtPamN6WVdOalptSTVMV1ZtWVRFdE5ESmpZUzFpTkRBMUxXRXdaalpqTUdFNFltUmtaaUlzSW01aVppSTZNVGN6TWpBNU5UZ3pNeXdpYVhOeklqb2laR2xrT21KemRqbzBPVEkwTVRsbU5XWXlOelF5WXpsak1XRm1aR0V5TXpCa1lXTm1PV0kxTnpBMVptRmpNak00TkROa05UVTRaVFF3WW1NMVlqRmlZV0kzT0dOa1lqUmhJbjAuTkVmNXRyRFNmb3g1V0tzSmE5TFZKbWJYWkZUeE5VYVRZaFBrUDRWLUZpQW1BN1I2NmpXTTBDeG1LZE9KUXRWczZRbFdNZmdiai1HNzdPaU4zZXpJWHciXX0sIkBjb250ZXh0IjpbImh0dHBzOi8vd3d3LnczLm9yZy8yMDE4L2NyZWRlbnRpYWxzL3YxIl0sInR5cGUiOlsiVmVyaWZpYWJsZVByZXNlbnRhdGlvbiJdLCJob2xkZXIiOiJkaWQ6YnN2OjdmZDllM2E1YjEzNGUyODFlZjU5Yjk5NDZlNTFlYmVjMjAwYmUwMzI0OTVjNmVhYTIwZDZkNjU1NDYxYTE5NjMiLCJ2ZXJpZmlhYmxlQ3JlZGVudGlhbCI6WyJleUpoYkdjaU9pSkZVekkxTmtzaUxDSjBlWEFpT2lKS1YxUWlmUS5leUpsZUhBaU9qRTNOak0yTXpFNE16TXNJblpqSWpwN0lrQmpiMjUwWlhoMElqcGJJbWgwZEhCek9pOHZkM2QzTG5jekxtOXlaeTh5TURFNEwyTnlaV1JsYm5ScFlXeHpMM1l4SWwwc0luUjVjR1VpT2xzaVZtVnlhV1pwWVdKc1pVTnlaV1JsYm5ScFlXd2lMQ0pGYldGcGJFTnlaV1JsYm5ScFlXd2lYU3dpWTNKbFpHVnVkR2xoYkZOMVltcGxZM1FpT25zaVpXMWhhV3dpT2lKNkxuQmhibWR5YzJsalFHNWphR0ZwYmk1amIyMGlMQ0owZVhCbElqb2lSVzFoYVd3Z1EzSmxaR1Z1ZEdsaGJDSXNJbWxrSWpvaVpHbGtPbUp6ZGpvM1ptUTVaVE5oTldJeE16UmxNamd4WldZMU9XSTVPVFEyWlRVeFpXSmxZekl3TUdKbE1ETXlORGsxWXpabFlXRXlNR1EyWkRZMU5UUTJNV0V4T1RZekluMHNJbU55WldSbGJuUnBZV3hUZEdGMGRYTWlPbnNpYVdRaU9pSTNOR1UxTlRRMk9XTXpZVFE0Wmprek56TTBPVE0yWW1Sak9HTmhOamxqTjJJNVpqSTROV0UxTldZME5UTmtaakF3Wm1Sak5HVm1PV0ppWldRM05qVm1JaXdpZEhsd1pTSTZJbTVEYUdGcGJrbGtaVzUwYVhSNVEzSmxaR1Z1ZEdsaGJGSmxkbTlqWVhScGIyNVRkR0YwZFhNeU1ESTBJbjE5TENKQVkyOXVkR1Y0ZENJNld5Sm9kSFJ3Y3pvdkwzZDNkeTUzTXk1dmNtY3ZNakF4T0M5amNtVmtaVzUwYVdGc2N5OTJNU0pkTENKMGVYQmxJanBiSWxabGNtbG1hV0ZpYkdWRGNtVmtaVzUwYVdGc0lpd2lSVzFoYVd4RGNtVmtaVzUwYVdGc0lsMHNJbVY0Y0dseVlYUnBiMjVFWVhSbElqb2lNakF5TlMweE1TMHlNRlF3T1RvME16bzFNeTR6T0ROYUlpd2lZM0psWkdWdWRHbGhiRk4xWW1wbFkzUWlPbnNpWlcxaGFXd2lPaUo2TG5CaGJtZHljMmxqUUc1amFHRnBiaTVqYjIwaUxDSjBlWEJsSWpvaVJXMWhhV3dnUTNKbFpHVnVkR2xoYkNJc0ltbGtJam9pWkdsa09tSnpkam8zWm1RNVpUTmhOV0l4TXpSbE1qZ3haV1kxT1dJNU9UUTJaVFV4WldKbFl6SXdNR0psTURNeU5EazFZelpsWVdFeU1HUTJaRFkxTlRRMk1XRXhPVFl6SW4wc0ltbGtJam9pZFhKdU9uVjFhV1E2TnpOaFkyTm1Zamt0WldaaE1TMDBNbU5oTFdJME1EVXRZVEJtTm1Nd1lUaGlaR1JtSWl3aVkzSmxaR1Z1ZEdsaGJGTjBZWFIxY3lJNmV5SnBaQ0k2SWpjMFpUVTFORFk1WXpOaE5EaG1PVE0zTXpRNU16WmlaR000WTJFMk9XTTNZamxtTWpnMVlUVTFaalExTTJSbU1EQm1aR00wWldZNVltSmxaRGMyTldZaUxDSjBlWEJsSWpvaWJrTm9ZV2x1U1dSbGJuUnBkSGxEY21Wa1pXNTBhV0ZzVW1WMmIyTmhkR2x2YmxOMFlYUjFjekl3TWpRaWZTd2lhWE56ZFdWeUlqcDdJbWxrSWpvaVpHbGtPbUp6ZGpvME9USTBNVGxtTldZeU56UXlZemxqTVdGbVpHRXlNekJrWVdObU9XSTFOekExWm1Gak1qTTRORE5rTlRVNFpUUXdZbU0xWWpGaVlXSTNPR05rWWpSaEluMHNJbWx6YzNWaGJtTmxSR0YwWlNJNklqSXdNalF0TVRFdE1qQlVNRGs2TkRNNk5UTXVORFE0V2lJc0luTjFZaUk2SW1ScFpEcGljM1k2TjJaa09XVXpZVFZpTVRNMFpUSTRNV1ZtTlRsaU9UazBObVUxTVdWaVpXTXlNREJpWlRBek1qUTVOV00yWldGaE1qQmtObVEyTlRVME5qRmhNVGsyTXlJc0ltcDBhU0k2SW5WeWJqcDFkV2xrT2pjellXTmpabUk1TFdWbVlURXROREpqWVMxaU5EQTFMV0V3Wmpaak1HRTRZbVJrWmlJc0ltNWlaaUk2TVRjek1qQTVOVGd6TXl3aWFYTnpJam9pWkdsa09tSnpkam8wT1RJME1UbG1OV1l5TnpReVl6bGpNV0ZtWkdFeU16QmtZV05tT1dJMU56QTFabUZqTWpNNE5ETmtOVFU0WlRRd1ltTTFZakZpWVdJM09HTmtZalJoSW4wLk5FZjV0ckRTZm94NVdLc0phOUxWSm1iWFpGVHhOVWFUWWhQa1A0Vi1GaUFtQTdSNjZqV00wQ3htS2RPSlF0VnM2UWxXTWZnYmotRzc3T2lOM2V6SVh3Il0sImF1ZCI6ImRpZDpic3Y6NmNlZjAwZTBlMjUzNDNkMGYzNjY1YTIyNGY0MDA2ODBhMjViNjViNjVkZGVmMzE2ZWViNDhmMjFiMWY5NzFjYyIsIm5iZiI6MTczMjE4NDgwMywiaXNzdWFuY2VEYXRlIjoiMjAyNC0xMS0yMVQxMDoyODo0My4xMzNaIiwiaXNzIjoiZGlkOmJzdjo3ZmQ5ZTNhNWIxMzRlMjgxZWY1OWI5OTQ2ZTUxZWJlYzIwMGJlMDMyNDk1YzZlYWEyMGQ2ZDY1NTQ2MWExOTYzIiwibm9uY2UiOiJkYmUzMjc3ZS1lNGJmLTQzZWEtYjhjYi04Zjc2YzI0OWU0YzIifQ.",
    "nonce": "dbe3277e-e4bf-43ea-b8cb-8f76c249e4c2",
    "presentation_submission": {
      "id": "JICH94Ufz-56AlljAiKN8",
      "definition_id": "emailCredential",
      "descriptor_map": [
        {
          "id": "c77537b3-4f81-4cda-af11-7f7118645c1f",
          "format": "jwt_vp",
          "path": "$",
          "path_nested": {
            "id": "c77537b3-4f81-4cda-af11-7f7118645c1f",
            "format": "jwt_vc",
            "path": "$.vp.verifiableCredential[0]"
          }
        }
      ]
    }
  },
  "verifiedData": {},
  "error": "text"
}