---
title: "Import KYC token"
method: POST
path: "/v2/users/{userId}/kyc/import-token"
tags: ["Kyc"]
---

# Import KYC token

`POST /v2/users/{userId}/kyc/import-token`

## Request

- Base URL: `https://production.hifibridge.com`
- URL: `https://production.hifibridge.com/v2/users/{userId}/kyc/import-token`
- Auth: HTTP bearer

Import a KYC token from a supported provider to transfer a user's existing KYC verification into HIFI.

This endpoint allows clients to onboard users who have already completed KYC with a supported provider (e.g. Sumsub) by importing their verification token directly, avoiding duplicate data collection.

## Path parameters

- `userId` string, required

## Request body

- ImportKycToken
  - `tokenProvider` 'SUMSUB', required: The KYC token provider
  - `token` string, required: The KYC token from the provider

## Response `200`

Success

- union
  - UsdRailKycSubmissionObject
    - `USD` object, required
      - `status` 'INACTIVE' | 'CREATED' | 'PENDING' | 'INCOMPLETE' | 'RFI_PENDING' | 'ACTIVE' | 'REJECTED' | 'CONTACT_SUPPORT', required: Kyc Status - `INACTIVE`: No KYC submission has been made. - `CREATED`: KYC application has been submitted. - `PENDING`: Review in progress. - `RFI_PENDING`: An RFI (Request for Information) email has been sent and is pending user response. - `INCOMPLETE`: RFI or resubmission required. - `ACTIVE`: User approved and onboarded. - `REJECTED`: KYC application rejected. - `CONTACT_SUPPORT`: Unexpected issue encountered during KYC review.
      - `message` string, required
  - AfricaGeneralRailKycSubmissionObject
    - `AFRICA_GENERAL` object, required
      - `status` 'INACTIVE' | 'CREATED' | 'PENDING' | 'INCOMPLETE' | 'RFI_PENDING' | 'ACTIVE' | 'REJECTED' | 'CONTACT_SUPPORT', required: Kyc Status - `INACTIVE`: No KYC submission has been made. - `CREATED`: KYC application has been submitted. - `PENDING`: Review in progress. - `RFI_PENDING`: An RFI (Request for Information) email has been sent and is pending user response. - `INCOMPLETE`: RFI or resubmission required. - `ACTIVE`: User approved and onboarded. - `REJECTED`: KYC application rejected. - `CONTACT_SUPPORT`: Unexpected issue encountered during KYC review.
      - `warnings` KycWarningObject[], required
        - `field` string[]: The KYC field paths this warning applies to. Empty when the warning is not tied to a specific field.
        - `action` 'UPDATE' | 'RESUBMIT' | 'MANUAL_REVIEW' | 'UNDER_REVIEW' | 'CONTACT_SUPPORT'
        - `message` string
      - `message` string, required
      - `onRamp` object, required
        - `kes` object
          - `momo` KycRailStatusObject
            - `status` string
            - `warnings` KycWarningObject[]
              - …
            - `message` string
        - `ghs` object
          - `momo` KycRailStatusObject
            - `status` string
            - `warnings` KycWarningObject[]
              - …
            - `message` string
        - `tzs` object
          - `bank` KycRailStatusObject
            - `status` string
            - `warnings` KycWarningObject[]
              - …
            - `message` string
        - `ugx` object
          - `bank` KycRailStatusObject
            - `status` string
            - `warnings` KycWarningObject[]
              - …
            - `message` string
        - `bwp` object
          - `bank` KycRailStatusObject
            - `status` string
            - `warnings` KycWarningObject[]
              - …
            - `message` string
        - `xaf` object
          - `bank` KycRailStatusObject
            - `status` string
            - `warnings` KycWarningObject[]
              - …
            - `message` string
          - `momo` KycRailStatusObject
            - `status` string
            - `warnings` KycWarningObject[]
              - …
            - `message` string
        - `mwk` object
          - `bank` KycRailStatusObject
            - `status` string
            - `warnings` KycWarningObject[]
              - …
            - `message` string
          - `momo` KycRailStatusObject
            - `status` string
            - `warnings` KycWarningObject[]
              - …
            - `message` string
        - `rwf` object
          - `bank` KycRailStatusObject
            - `status` string
            - `warnings` KycWarningObject[]
              - …
            - `message` string
        - `zmw` object
          - `bank` KycRailStatusObject
            - `status` string
            - `warnings` KycWarningObject[]
              - …
            - `message` string
          - `momo` KycRailStatusObject
            - `status` string
            - `warnings` KycWarningObject[]
              - …
            - `message` string
        - `xof` object
          - `momo` KycRailStatusObject
            - `status` string
            - `warnings` KycWarningObject[]
              - …
            - `message` string
      - `offRamp` object, required
        - `kes` object
          - `bank` KycRailStatusObject
            - `status` string
            - `warnings` KycWarningObject[]
              - …
            - `message` string
          - `momo` KycRailStatusObject
            - `status` string
            - `warnings` KycWarningObject[]
              - …
            - `message` string
        - `zar` object
          - `bank` KycRailStatusObject
            - `status` string
            - `warnings` KycWarningObject[]
              - …
            - `message` string
        - `ghs` object
          - `momo` KycRailStatusObject
            - `status` string
            - `warnings` KycWarningObject[]
              - …
            - `message` string
        - `tzs` object
          - `momo` KycRailStatusObject
            - `status` string
            - `warnings` KycWarningObject[]
              - …
            - `message` string
        - `ugx` object
          - `momo` KycRailStatusObject
            - `status` string
            - `warnings` KycWarningObject[]
              - …
            - `message` string
        - `bwp` object
          - `momo` KycRailStatusObject
            - `status` string
            - `warnings` KycWarningObject[]
              - …
            - `message` string
        - `xaf` object
          - `momo` KycRailStatusObject
            - `status` string
            - `warnings` KycWarningObject[]
              - …
            - `message` string
        - `mwk` object
          - `momo` KycRailStatusObject
            - `status` string
            - `warnings` KycWarningObject[]
              - …
            - `message` string
        - `rwf` object
          - `momo` KycRailStatusObject
            - `status` string
            - `warnings` KycWarningObject[]
              - …
            - `message` string
        - `zmw` object
          - `momo` KycRailStatusObject
            - `status` string
            - `warnings` KycWarningObject[]
              - …
            - `message` string
        - `xof` object
          - `momo` KycRailStatusObject
            - `status` string
            - `warnings` KycWarningObject[]
              - …
            - `message` string
  - AfricaNigeriaRailKycSubmissionObject
    - `AFRICA_NIGERIA` object, required
      - `status` 'INACTIVE' | 'CREATED' | 'PENDING' | 'INCOMPLETE' | 'RFI_PENDING' | 'ACTIVE' | 'REJECTED' | 'CONTACT_SUPPORT', required: Kyc Status - `INACTIVE`: No KYC submission has been made. - `CREATED`: KYC application has been submitted. - `PENDING`: Review in progress. - `RFI_PENDING`: An RFI (Request for Information) email has been sent and is pending user response. - `INCOMPLETE`: RFI or resubmission required. - `ACTIVE`: User approved and onboarded. - `REJECTED`: KYC application rejected. - `CONTACT_SUPPORT`: Unexpected issue encountered during KYC review.
      - `warnings` KycWarningObject[], required
        - `field` string[]: The KYC field paths this warning applies to. Empty when the warning is not tied to a specific field.
        - `action` 'UPDATE' | 'RESUBMIT' | 'MANUAL_REVIEW' | 'UNDER_REVIEW' | 'CONTACT_SUPPORT'
        - `message` string
      - `message` string, required
      - `onRamp` object, required
        - `ngn` object
          - `bank` KycRailStatusObject
            - `status` string
            - `warnings` KycWarningObject[]
              - …
            - `message` string
      - `offRamp` object, required
        - `ngn` object
          - `bank` KycRailStatusObject
            - `status` string
            - `warnings` KycWarningObject[]
              - …
            - `message` string
  - GlobalNetworkRailKycSubmissionObject
    - `GLOBAL_NETWORK` object, required
      - `status` 'INACTIVE' | 'CREATED' | 'PENDING' | 'INCOMPLETE' | 'RFI_PENDING' | 'ACTIVE' | 'REJECTED' | 'CONTACT_SUPPORT', required: Kyc Status - `INACTIVE`: No KYC submission has been made. - `CREATED`: KYC application has been submitted. - `PENDING`: Review in progress. - `RFI_PENDING`: An RFI (Request for Information) email has been sent and is pending user response. - `INCOMPLETE`: RFI or resubmission required. - `ACTIVE`: User approved and onboarded. - `REJECTED`: KYC application rejected. - `CONTACT_SUPPORT`: Unexpected issue encountered during KYC review.
      - `warnings` KycWarningObject[], required
        - `field` string[]: The KYC field paths this warning applies to. Empty when the warning is not tied to a specific field.
        - `action` 'UPDATE' | 'RESUBMIT' | 'MANUAL_REVIEW' | 'UNDER_REVIEW' | 'CONTACT_SUPPORT'
        - `message` string
      - `message` string, required
      - `onRamp` object, required
      - `offRamp` object, required
        - `brl` object
          - `pix` KycRailStatusObject
            - `status` string
            - `warnings` KycWarningObject[]
              - …
            - `message` string
        - `hkd` object
          - `wire` KycRailStatusObject
            - `status` string
            - `warnings` KycWarningObject[]
              - …
            - `message` string
        - `mxn` object
          - `spei` KycRailStatusObject
            - `status` string
            - `warnings` KycWarningObject[]
              - …
            - `message` string
        - `ngn` object
          - `bank` KycRailStatusObject
            - `status` string
            - `warnings` KycWarningObject[]
              - …
            - `message` string

## Other responses

- `401`: Unauthorized
- `404`: Resource not found
- `500`: Internal Server Error

## Changes

- **2026-11-03** `319fa6bd5bc6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hifi/apis/hifi-api/changes/v2/users/:userId/kyc/import-token/post.md)

---

[API](https://skmtc.dev/hifi/apis/hifi-api.md) - [All operations](https://skmtc.dev/hifi/apis/hifi-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hifi/apis/hifi-api/revisions/319fa6bd5bc6?raw)