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

# Sync UCC status from NSE

> Reconciles every investor's stored status against NSE's Client Master report: an investor NSE actually has on file but that we still show as PENDING/PROCESSING/REJECTED is corrected to REGISTERED. A Client Master record NSE has for a client_code that doesn't match any investor in this tenant is skipped, not an error. Does not touch FATCA — the report has no distinct FATCA status field.



## OpenAPI

````yaml /openapi.yaml post /api/investors/v1/sync
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/sync:
    post:
      tags:
        - investors
      summary: Sync UCC status from NSE
      description: >-
        Reconciles every investor's stored status against NSE's Client Master
        report: an investor NSE actually has on file but that we still show as
        PENDING/PROCESSING/REJECTED is corrected to REGISTERED. A Client Master
        record NSE has for a client_code that doesn't match any investor in this
        tenant is skipped, not an error. Does not touch FATCA — the report has
        no distinct FATCA status field.
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  bank_account_details:
                    type: array
                  bank_accounts_checked:
                    description: >-
                      Stored bank accounts matched to an NSE Client Master bank
                      slot (by account number + IFSC).
                    type: integer
                  bank_accounts_reconciled:
                    description: >-
                      Bank accounts whose stored status was corrected to NSE's
                      own per-account status (e.g. still PENDING in NSE's back
                      office).
                    type: integer
                  checked:
                    description: Investors looked up against NSE's Client Master report.
                    type: integer
                  details:
                    type: array
                  not_found_at_nse:
                    description: >-
                      Checked investors NSE has no Client Master record for yet
                      — left untouched.
                    type: integer
                  reconciled:
                    description: Investors whose stored status was corrected to match NSE.
                    type: integer
                  skipped_at_nse:
                    description: >-
                      Client Master rows NSE returned for a client_code that
                      doesn't match any investor in this tenant — ignored, not
                      an error.
                    type: integer
                type: object
          description: Sync result
components:
  securitySchemes:
    bearerAuth:
      bearerFormat: Opaque bearer token from POST /api/auth/v1/token
      scheme: bearer
      type: http

````