---
title: "Get Onboarding Status"
method: GET
path: "/gcc/v2/partner/merchant/onboard/{onboardingId}/status"
tags: ["Merchant Onboarding"]
---

# Get Onboarding Status

`GET /gcc/v2/partner/merchant/onboard/{onboardingId}/status`

Retrieves the current onboarding status and all submitted information for a merchant.
Always call this endpoint server-to-server after the merchant completes the
iFrame verification flow to confirm final status.

## Path parameters

- `onboardingId` string, required

## Response `200`

Onboarding status retrieved successfully.

- CommonSuccessResponse
  - `gid` string — PayGlocal global transaction ID.
  - `timestamp` string — Response timestamp (DD/MM/YYYY HH:MM:SS).
  - `reasonCode` string — Empty string on success.
  - `data` object
    - `merchantInfo` MerchantInfo
      - `onboardingId` string — PayGlocal-generated onboarding ID.
      - `partnerOnboardingId` string — Partner's external onboarding ID.
      - `onboardingStatus` 'INITIATED' | 'IN_PROGRESS' | 'PENDING_VERIFICATION' | 'PENDING_REVIEW' | 'APPROVED' | 'REJECTED' | 'RFI' — Current onboarding lifecycle status.
      - `businessDetails` object
        - `entityType` string
        - `gstNumber` string
        - `natureOfBusiness` string
        - `registeredName` string
        - `tradeName` string
        - `iec` string
        - `businessMonthlySize` string
        - `websiteUrl` string
        - `purposeCode` string
        - `businessRegisteredAddress` Address
          - `streetAddress1` string — Primary street line.
          - `streetAddress2` string — Secondary street line (suite, floor, etc.).
          - `zipcode` string — PIN code.
          - `stateCode` string — Two-letter state code (e.g., MH, KA, DL).
          - `city` string — City name.
          - `state` string — Full state name.
        - `businessOperatingAddress` Address
          - `streetAddress1` string — Primary street line.
          - `streetAddress2` string — Secondary street line (suite, floor, etc.).
          - `zipcode` string — PIN code.
          - `stateCode` string — Two-letter state code (e.g., MH, KA, DL).
          - `city` string — City name.
          - `state` string — Full state name.
      - `directorDetails` object[]
        - `designation` string
        - `name` string
        - `pan` string
      - `beneficialOwnerDetails` object[]
        - `designation` string
        - `name` string
        - `pan` string
        - `percentageOwnership` number
      - `authorisedSignatoryDetails` object
        - `authSignatoryName` string
        - `authSignatoryPan` string
        - `contact` object
          - `phone` string
          - `email` string
      - `settlementDetails` object
        - `bankAccountNumber` string
        - `bankIfscCode` string
        - `accountHolderName` string
        - `accountType` 'CURRENT' | 'SAVINGS'
    - `merchantOnboardingCheckListStatus` ChecklistStatus
      - `businessDetails` 'COMPLETE' | 'INCOMPLETE' | 'NOT_APPLICABLE' — Per-step completion state for an onboarding checklist field.
      - `beneficialOwners` 'COMPLETE' | 'INCOMPLETE' | 'NOT_APPLICABLE' — Per-step completion state for an onboarding checklist field.
      - `bankDetails` 'COMPLETE' | 'INCOMPLETE' | 'NOT_APPLICABLE' — Per-step completion state for an onboarding checklist field.
      - `authorisedSignatory` 'COMPLETE' | 'INCOMPLETE' | 'NOT_APPLICABLE' — Per-step completion state for an onboarding checklist field.
      - `vkyc` 'COMPLETE' | 'INCOMPLETE' | 'NOT_APPLICABLE' — Per-step completion state for an onboarding checklist field.
      - `digiLocker` 'COMPLETE' | 'INCOMPLETE' | 'NOT_APPLICABLE' — Per-step completion state for an onboarding checklist field.
      - `tncAcknowledged` 'COMPLETE' | 'INCOMPLETE' | 'NOT_APPLICABLE' — Per-step completion state for an onboarding checklist field.
      - `documents` 'COMPLETE' | 'INCOMPLETE' | 'NOT_APPLICABLE' — Per-step completion state for an onboarding checklist field.
      - `products` 'COMPLETE' | 'INCOMPLETE' | 'NOT_APPLICABLE' — Per-step completion state for an onboarding checklist field.
      - `documentsToBeUploaded` string[]

## Other responses

- `401` — Authentication failed — invalid API key or digest.
- `403` — The onboardingId does not belong to the authenticated partner.
- `404` — The specified onboardingId does not exist.

---

[API](https://skmtc.net/payglocal/apis/payglocal-api.md) · [All operations](https://skmtc.net/payglocal/apis/payglocal-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/payglocal/payglocal-api/revisions/498446abc56d/schema)