> ## Documentation Index
> Fetch the complete documentation index at: https://developer.sandbox.co.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Entity Details

> Get Entity Details API returns the entity details used to access EntityLocker documents

<Card title="Run in Postman" icon="https://mintcdn.com/sandboxfinancialtechnologiesprivatelimited/gviqebbpT5NUt_6i/static/svg/Postman.svg?fit=max&auto=format&n=gviqebbpT5NUt_6i&q=85&s=da47f2b7e10d87befec951aed9468de3" horizontal arrow="true" href="https://www.postman.com/in-co-sandbox/sandbox-api/request/3kww0ke/get-entity-details" width="2030" height="2031" data-path="static/svg/Postman.svg" />


## OpenAPI

````yaml api-reference/kyc/openapi.json GET /kyc/entitylocker/sessions/{session_id}/entity
openapi: 3.1.0
info:
  title: in-co-sandbox-kyc
  description: ''
  version: 1.0.0
servers:
  - url: https://test-api.sandbox.co.in
    description: test
  - url: https://api.sandbox.co.in
    description: prod
security: []
tags:
  - name: kyc
  - name: digilocker-sdk
  - name: digilocker
  - name: aadhaar
  - name: bank
  - name: pan
  - name: mca
  - name: entitylocker
  - name: entitylocker-sdk
paths:
  /kyc/entitylocker/sessions/{session_id}/entity:
    get:
      tags:
        - kyc
        - entitylocker
      summary: Get Entity Details
      operationId: getEntityDetails
      parameters:
        - name: session_id
          in: path
          description: >-
            Session identifier generated during EntityLocker [Initiate Session
            API](https://developer.sandbox.co.in/api-reference/kyc/entitylocker/endpoints/initiate_session)
            .
          required: true
          example: c4124d99-4854-446f-9b04-b8f8c12785d0
          schema:
            type: string
        - name: Authorization
          in: header
          description: >-
            JWT access token. For token-generation steps, refer to the
            [Quickstart
            Guide](https://developer.sandbox.co.in/guides/get-started/quickstart).
          required: true
          example: '{{access_token}}'
          schema:
            type: string
        - name: x-api-key
          in: header
          description: API key used to identify and authenticate the client.
          required: true
          example: '{{api_key}}'
          schema:
            type: string
        - name: x-api-version
          in: header
          description: Specifies the API version for the request.
          required: false
          example: 1.0.0
          schema:
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                    description: HTTP status code.
                  timestamp:
                    type: integer
                    description: >-
                      Unix timestamp (in milliseconds) indicating when the
                      server generated the response.
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                        format: uuid
                        description: >-
                          A unique identifier for the entity. This ID is used to
                          distinguish individual entities within the system and
                          follows a UUID format.
                      '@entity':
                        type: string
                      date_of_incorporation:
                        type: string
                        pattern: ^\d{2}\/\d{2}\/\d{4}$
                        description: >-
                          The date when the entity was officially incorporated.
                          This field is provided in DD/MM/YYYY format, e.g.,
                          01/01/2023.
                      email:
                        type: string
                        format: email
                        description: >-
                          The primary email address associated with the entity.
                          This email is used for official communications and
                          must follow a valid email format.
                      mobile:
                        type: string
                        description: >-
                          The primary mobile phone number for the entity. This
                          number is used for direct contact and verification
                          purposes.
                      name:
                        type: string
                        description: >-
                          The official registered name of the entity. This field
                          represents the legal name of the company or
                          organization.
                      verified_by:
                        type: string
                        enum:
                          - pan
                          - ud
                          - cin
                        description: >-
                          The method or document used to verify the entity's
                          identity. Valid values are 'pan' for Permanent Account
                          Number, 'ud' for Udyam Registration, or 'cin' for
                          Corporate Identification Number.
                    required:
                      - id
                      - '@entity'
                      - date_of_incorporation
                      - email
                      - mobile
                      - name
                      - verified_by
                    description: >-
                      Response payload containing the requested data or error
                      details.
                  transaction_id:
                    type: string
                    format: uuid
                    description: Unique identifier for tracking the request across systems.
                required:
                  - code
                  - timestamp
                  - data
                  - transaction_id
              examples:
                200 - Entity Details fetched:
                  summary: 200 - Entity Details fetched
                  value:
                    code: 200
                    timestamp: 1765888767565
                    data:
                      id: 4e8455e8-27db-50a0-99e9-0b0211a4811d
                      '@entity': in.co.sandbox.kyc.entitylocker.entity
                      date_of_incorporation: 16/01/2023
                      email: help@sandbox.co.in
                      mobile: '9099983246'
                      name: SANDBOX FINANCIAL TECHNOLOGIES PRIVATE LIMITED
                      verified_by: cin
                    transaction_id: c4124d99-4854-446f-9b04-b8f8c12785d0
          headers: {}
      deprecated: false
      security: []

````