> ## Documentation Index
> Fetch the complete documentation index at: https://docs.monime.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get KYC Verification



## OpenAPI

````yaml get /kyc-verifications/{providerCode}
openapi: 3.0.3
info:
  title: Monime API
  description: Monime REST API. Please visit https://docs.momime.io/api for more details.
  termsOfService: https://monime.io/legal/terms-of-service
  contact:
    name: Monime Developers
    url: https://github.com/monimesl
    email: dev@monime.io
  version: '2024-08-01'
servers:
  - url: https://api.monime.io/
security:
  - bearerAuth: []
paths:
  /kyc-verifications/{providerCode}:
    get:
      tags:
        - KYCVerification
      summary: Get KYC Verification
      operationId: GetKYCVerification
      parameters:
        - name: accountId
          in: query
          description: The ID of the account in the provider to be verified.
          required: true
          schema:
            type: string
            description: The ID of the account in the provider to be verified.
        - name: accountType
          in: query
          description: >-
            The type of the account to be verified. Some providers like
            m17(Orange Money SL) can issue the same account ID(MSISDN) to
            different account types.
          schema:
            enum:
              - merchant
            type: string
            description: >-
              The type of the account to be verified. Some providers like
              m17(Orange Money SL) can issue the same account ID(MSISDN) to
              different account types.
        - name: providerCode
          in: path
          description: The code for the provider as identified by Monime.
          required: true
          schema:
            type: string
            description: The code for the provider as identified by Monime.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: >-
                      Represents the status of the query operation, confirming
                      if it was successful. This field is always true
                  messages:
                    type: array
                    items: {}
                    description: >-
                      Contains a list of messages providing relevant information
                      or feedback related to the query or operation
                  result:
                    $ref: '#/components/schemas/KYCVerification'
components:
  schemas:
    KYCVerification:
      type: object
      properties:
        provider:
          type: object
          properties:
            code:
              type: string
              description: The code of the provider as assigned by Monime.
              example: m17
            type:
              enum:
                - momo
                - bank
                - wallet
              type: string
              description: The type of the provider.
            name:
              type: string
              description: The name of the provider
              example: Orange Money
          description: The provider info of the verification object.
        accountId:
          type: string
          description: >-
            The ID of the financial account in the provider's ecosystem
            associated with this verification.
        accountHolderProfile:
          type: object
          properties:
            firstName:
              type: string
              description: >-
                The first name of the account holder in the provider's
                ecosystem.
              nullable: true
            lastName:
              type: string
              description: The last name of the account holder in the provider's ecosystem.
              nullable: true
          description: The  profile of the account holder in the provider's ecosystem.
        metadata:
          maxProperties: 100
          type: object
          description: The metadata of the KYC verification.
          nullable: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: auth-scheme
      description: >-
        Bearer HTTP authentication specified with the header Authorization:
        Bearer <access_token>

````