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

# Unmask one PII field

> Reveals a single PII field in plaintext. Requires the pii:read scope and an `actor` identifying who the request is on behalf of. Every call is written to the PII access log.



## OpenAPI

````yaml /openapi.yaml post /api/investors/v1/:id/unmask
openapi: 3.0.3
info:
  title: MF Atlas API
  version: 1.0.0
servers:
  - description: Sandbox
    url: https://api-sandbox.mf-atlas.space
  - description: Production
    url: https://api.mf-atlas.space
security: []
paths:
  /api/investors/v1/:id/unmask:
    post:
      tags:
        - investors
      summary: Unmask one PII field
      description: >-
        Reveals a single PII field in plaintext. Requires the pii:read scope and
        an `actor` identifying who the request is on behalf of. Every call is
        written to the PII access log.
      parameters:
        - description: ''
          in: path
          name: id
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              properties:
                actor:
                  description: >-
                    Required. Identifier of the person or system on whose behalf
                    this unmask is requested — e.g. the downstream end-user id,
                    since the API caller may be an intermediary auth system.
                  type: string
                field:
                  description: >-
                    Dotted path of the single field to reveal: pan |
                    contact.email | contact.mobile | joint_holders.<n>.pan |
                    joint_holders.<n>.email | joint_holders.<n>.mobile |
                    guardian.pan | nominees.<n>.pan |
                    bank_accounts.<account_id>.account_no.
                  type: string
                reason:
                  description: >-
                    Optional free-text justification, stored on the audit
                    record.
                  type: string
              type: object
        description: Field + actor
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  field:
                    type: string
                  value:
                    type: string
                type: object
          description: Plaintext value

````