---
title: "Get Provider KYC"
method: GET
path: "/v1/provider-kyc/{providerId}"
tags: ["Provider KYC"]
---

# Get Provider KYC

`GET /v1/provider-kyc/{providerId}`

Retrieves the KYC profile of an account from a specified provider.

## Path parameters

- `providerId` string, required — The ID of the provider as identified by Monime.

## Query parameters

- `accountId` string, required — The ID of the account in the provider's ecosystem'.

## Response `200`

OK

- object
  - `success` boolean — Represents the status of the query operation, confirming if it was successful. This field is always true
  - `messages` unknown[] — Contains a list of messages providing relevant information or feedback related to the query or operation
    - unknown
  - `result` ProviderKYC — A **Provider KYC** object represents the **know-your-customer (KYC) information** retrieved from a financial provider (e.g., Mobile Money operator, Bank). ---
    - `account` object — The information of the account in the provider's ecosystem.
      - `id` string — Unique identifier of the account in the provider's system.
      - `name` string — Display name associated with the account, if different from the holder's name.
      - `holderName` string — Full name of the account holder as registered with the provider.
      - `metadata` object, nullable — Additional metadata of the account.
    - `provider` object — The information of the financial provider hosting the account.
      - `id` string — The id of the provider as assigned by Monime.
      - `type` 'momo' | 'bank' | 'wallet' — The type of the provider.
      - `name` string — The name of the provider

---

[API](https://skmtc.dev/monime/apis/monime-api.md) · [All operations](https://skmtc.dev/monime/apis/monime-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/monime/monime-api/revisions/bd7f875ea428/schema)