> ## Documentation Index
> Fetch the complete documentation index at: https://docs.privue.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# DigiLocker account details

> Read the DigiLocker account holder and every document issued into their account.

Each document's `id` is its file id, which `/digilocker/v1/files.1` reads the file of. A PAN that is not linked to the account is not listed; `/digilocker/v1/pull-document.1` pulls it.



## OpenAPI

````yaml /suite/api-reference/openapi.json post /digilocker/v1/details.1
openapi: 3.1.0
info:
  title: Privue API Suite
  version: 1.0.0
  description: >-
    Business, tax, registry, employment and identity verification against
    official Indian sources, a person's own documents read through DigiLocker
    with their consent, and an EPF member's passbook read with the OTP they
    receive.


    **Authentication.** Every request takes your API key as a bearer token:
    `Authorization: Bearer <your-key>`.


    **One envelope.** Every check returns the reasons behind a refusal and the
    record the source held, and an empty `reasons` means the check passed.
    Branch on `reasons` rather than on the status code, because a call the
    source answered returns `200` whatever it concluded.


    **DigiLocker and EPFO passbook.** A DigiLocker endpoint returns `details`
    alone: what it read, as the source holds it. So do submitting an EPFO
    passbook OTP and reading the passbook; sending the OTP answers like a check.


    **Versioning.** Each endpoint is versioned on its own, directly in its path.
    A new version of one endpoint never moves another, so no release requires
    migrating every integration at once.
servers:
  - url: https://api.privue.ai
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Checks
    description: One check on one subject, answered in the envelope every check shares.
  - name: DigiLocker
    description: >-
      A person's own documents, read through the consent they give at
      DigiLocker.
  - name: EPFO passbook
    description: >-
      A member's EPF passbook, read with the OTP sent to the mobile number on
      their account.
  - name: Orchestrated flows
    description: Every check on one business, asked and answered together in a single call.
  - name: Usage
    description: What you have called, and when.
paths:
  /digilocker/v1/details.1:
    post:
      tags:
        - DigiLocker
      summary: DigiLocker account details
      description: >-
        Read the DigiLocker account holder and every document issued into their
        account.


        Each document's `id` is its file id, which `/digilocker/v1/files.1`
        reads the file of. A PAN that is not linked to the account is not
        listed; `/digilocker/v1/pull-document.1` pulls it.
      operationId: digilocker.details.1
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConsentRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DigilockerDetailsResponse'
              examples:
                details:
                  summary: An account holder with two issued documents
                  value:
                    details:
                      user_details:
                        digilocker_id: f3102754-3555-5c30-a95c-0000b31680f0
                        name: ASHA RAO
                        dob: 12/03/1990
                        gender: F
                        eaadhaar: 'Y'
                        mobile: '9876543210'
                      files:
                        - name: Aadhaar Card
                          type: file
                          size: ''
                          date: 04/10/2026
                          parent: ''
                          mime:
                            - application/pdf
                            - application/xml
                          doc_type: ADHAR
                          description: Aadhaar Card
                          issuer_id: in.gov.uidai
                          issuer: Unique Identification Authority of India
                          id: in.gov.uidai-ADHAR-XXXXXXXX1234
                        - name: Driving License
                          type: file
                          size: ''
                          date: 04/10/2026
                          parent: ''
                          mime:
                            - application/pdf
                            - application/xml
                          doc_type: DRVLC
                          description: Driving License
                          issuer_id: in.gov.transport
                          issuer: Ministry of Road Transport and Highways
                          id: in.gov.transport-DRVLC-TN8920000007545
        '401':
          description: The API key is missing, malformed or not valid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuiteError'
        '403':
          description: The key is valid but is not entitled to this feature.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuiteError'
        '404':
          description: >-
            No consent link you created in the last 30 days carries this
            `request_id`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuiteError'
        '422':
          description: >-
            The request failed validation, or the source would not accept the
            details in it.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuiteError'
        '429':
          description: >-
            The key is not cleared for this feature, or is sending too many
            requests. Nothing was called.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuiteError'
        '503':
          description: >-
            The source could not be reached, or authentication is temporarily
            unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuiteError'
        default:
          description: The request failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuiteError'
components:
  schemas:
    ConsentRequest:
      properties:
        request_id:
          type: string
          minLength: 1
          title: Request Id
          description: The `request_id` the consent link was created with
          examples:
            - 652523835a9f9000112b1ee6
      additionalProperties: false
      type: object
      required:
        - request_id
      title: ConsentRequest
      description: The consent to read through.
    DigilockerDetailsResponse:
      properties:
        details:
          $ref: '#/components/schemas/DigilockerDetails'
          description: The account holder and their issued documents
      type: object
      required:
        - details
      title: DigilockerDetailsResponse
      description: >-
        The DigiLocker account holder, and every document issued into their
        account.
    SuiteError:
      properties:
        code:
          type: integer
          title: Code
          description: HTTP status code of the response
        timestamp:
          type: integer
          title: Timestamp
          description: Unix millisecond timestamp of when the response was produced
        message:
          type: string
          title: Message
          description: What went wrong, in one sentence
      type: object
      required:
        - code
        - timestamp
        - message
      title: SuiteError
      description: Why a request failed.
    DigilockerDetails:
      properties:
        user_details:
          anyOf:
            - $ref: '#/components/schemas/DigilockerUser'
            - type: 'null'
        files:
          anyOf:
            - items:
                $ref: '#/components/schemas/IssuedFile'
              type: array
            - type: 'null'
          title: Files
      type: object
      title: DigilockerDetails
      description: >-
        The DigiLocker account holder, and every document issued into their
        account.
    DigilockerUser:
      properties:
        digilocker_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Digilocker Id
        name:
          anyOf:
            - type: string
            - type: 'null'
          title: Name
        dob:
          anyOf:
            - type: string
            - type: 'null'
          title: Dob
          description: Date of birth, as DD/MM/YYYY
        gender:
          anyOf:
            - type: string
            - type: 'null'
          title: Gender
        eaadhaar:
          anyOf:
            - type: string
            - type: 'null'
          title: Eaadhaar
          description: '"Y" when the account holds an e-Aadhaar, and "N" otherwise'
        mobile:
          anyOf:
            - type: string
            - type: 'null'
          title: Mobile
          description: The mobile number, or "UNAVAILABLE"
      type: object
      title: DigilockerUser
      description: The DigiLocker account holder.
    IssuedFile:
      properties:
        name:
          anyOf:
            - type: string
            - type: 'null'
          title: Name
        type:
          anyOf:
            - type: string
            - type: 'null'
          title: Type
        size:
          anyOf:
            - type: string
            - type: 'null'
          title: Size
        date:
          anyOf:
            - type: string
            - type: 'null'
          title: Date
          description: When the file was read, as DD/MM/YYYY
        parent:
          anyOf:
            - type: string
            - type: 'null'
          title: Parent
        mime:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Mime
          description: The formats the document is available in
        doc_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Doc Type
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
        issuer_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Issuer Id
        issuer:
          anyOf:
            - type: string
            - type: 'null'
          title: Issuer
        id:
          anyOf:
            - type: string
            - type: 'null'
          title: Id
          description: >-
            The document's file id: its issuer, its type and its number, which
            `/digilocker/v1/files.1` reads
      type: object
      title: IssuedFile
      description: One document issued into the person's DigiLocker account.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Your API key, sent as `Authorization: Bearer <your-key>`.'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.