---
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`

## Request

- Base URL: `https://api.onboard.payglocal.in`
- URL: `https://api.onboard.payglocal.in/gcc/v2/partner/merchant/onboard/{onboardingId}/status`
- Auth: API key in header `x-gl-auth` and API key in header `x-gl-digest`
- TypeScript: <https://skmtc.dev/payglocal/apis/payglocal-api/docs/gcc/v2/partner/merchant/onboard/:onboardingId/status/get.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/payglocal/apis/payglocal-api.md) - [All operations](https://skmtc.dev/payglocal/apis/payglocal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/payglocal/apis/payglocal-api/revisions/498446abc56d?raw)