> ## 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.

# Get investor holdings

> Folio-level holdings (units, NAV, market value) as reported by the registrars (CAMS and KFintech) in their daily mailback reports, found by the investor's PAN. Refreshed once a day, so each position carries the balance date it is as of; empty until a report covering the investor has been processed. Only single-holder investors are populated. To look up someone who is not an investor here, use POST /api/holdings/v1/lookup.



## OpenAPI

````yaml /openapi.yaml get /api/investors/v1/:id/holdings
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:
  - bearerAuth: []
paths:
  /api/investors/v1/:id/holdings:
    get:
      tags:
        - investors
      summary: Get investor holdings
      description: >-
        Folio-level holdings (units, NAV, market value) as reported by the
        registrars (CAMS and KFintech) in their daily mailback reports, found by
        the investor's PAN. Refreshed once a day, so each position carries the
        balance date it is as of; empty until a report covering the investor has
        been processed. Only single-holder investors are populated. To look up
        someone who is not an investor here, use POST /api/holdings/v1/lookup.
      parameters:
        - description: ''
          in: path
          name: id
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  holdings:
                    type: array
                  investor_id:
                    description: Present on the per-investor endpoint only.
                    type: string
                  pan:
                    description: Masked PAN. Present on the PAN lookup only.
                    type: string
                  summary:
                    type: object
                required:
                  - holdings
                  - summary
                type: object
          description: Holdings
components:
  securitySchemes:
    bearerAuth:
      bearerFormat: Opaque bearer token from POST /api/auth/v1/token
      scheme: bearer
      type: http

````

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