---
title: "Get Connect KYC status"
method: GET
path: "/api/connect/accounts/{subMerchantId}/kyc/status"
tags: ["Connect"]
---

# Get Connect KYC status

`GET /api/connect/accounts/{subMerchantId}/kyc/status`

Returns the current KYC status and a unified nextUrl/nextSteps contract for what to do next. This endpoint is the single source of truth for KYC progression.

## Path parameters

- `subMerchantId` string, required

## Query parameters

- `kycEndorsement` 'sepa' | 'spei' | 'cards'
- `redirectUri` string

## Response `200`

Get Connect KYC status successful

- ConnectKycStatusDto
  - `subMerchantId` string, required — Sub-merchant user id
  - `kycReady` boolean, required — True when KYC is approved and the custodial wallet is provisioned
  - `verificationType` 'KYC' | 'KYB', required — Verification type — KYC for individuals, KYB for businesses
  - `nextUrl` string, nullable, required — URL to redirect the sub-merchant to for the next KYC action. Null when no action is required.
  - `nextSteps` string[], required — Ordered list of next steps the marketplace must follow
  - `pendingRequirements` string[], required — List of KYC requirements still pending
  - `fallbackKycLink` string, nullable, required — Fallback KYC hosted link (independent of terms-of-service acceptance state)
  - `walletId` string, nullable, required — Managed wallet external id (null until KYC is approved and wallet is provisioned)

## Other responses

- `400` — Sub-merchant KYC provider not yet linked
- `401` — Unauthorized - Invalid API key
- `404` — Sub-merchant not found or does not belong to this marketplace

---

[API](https://skmtc.net/inflowpay/apis/inflow-api.md) · [All operations](https://skmtc.net/inflowpay/apis/inflow-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/inflowpay/inflow-api/versions/3012dd3dd14a/schema)