---
title: "Get Sumsub status by network"
method: POST
path: "/v1/sumsub-status-by-network"
tags: ["External Wallet Access KYC"]
---

# Get Sumsub status by network

`POST /v1/sumsub-status-by-network`

Returns the latest Sumsub webhook-derived KYC state for the given tokenId and network; poll it after starting Sumsub on an external network to display review progress without creating a new access token. data is an empty object when UR has not yet received a Sumsub webhook for that tokenId and network.

## Headers

- `X-Api-Signature` string, required
- `X-Api-Deadline` string, required
- `X-Api-PublicKey` string, required

## Request body

- KycByNetworkRequest
  - `tokenId` string, required — URID NFT token id.
  - `network` string, required — Network or chain identifier, for example 5000 or 11155111.

## Response `200`

Business result envelope. code 0 means success; business rejections return HTTP 200 with a non-zero code.

- KycSumsubStatusByNetworkResponse
  - `code` integer — Business result code. 0 means success; business rejections return HTTP 200 with a non-zero code.
  - `message` string — Human-readable diagnostic for non-zero codes.
  - `data` object — Latest Sumsub webhook-derived state. An empty object when UR has not yet received a Sumsub webhook for that tokenId and network.
    - `type` string — Sumsub webhook type, for example applicantWorkflowCompleted.
    - `reviewStatus` string — Review status, for example init, pending, completed.
    - `reviewAnswer` string — Review answer: GREEN for success, RED for failure.
    - `reviewRejectType` string — Rejection type, for example FINAL or RETRY.
    - `levelName` string — Sumsub level name.
    - `rejectLabels` string[] — Rejection labels when applicable.
    - `applicantId` string — Sumsub applicant id.
    - `applicantType` string — Applicant type, for example individual.
    - `createdAtMs` integer — Event time in milliseconds.

---

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