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

# List your customers

> Newest first. Pass nextCursor as cursor for the next page. Items have no documents: get a customer for its document links.



## OpenAPI

````yaml /api-reference/openapi.json get /api/v3/partners/{shortName}/customers
openapi: 3.0.0
info:
  title: Ndovu Partner API
  description: API for partners distributing Ndovu investment products to their customers.
  version: '3'
  contact: {}
servers:
  - url: https://be-dev-1.dev.ndovu.co
    description: Development
security: []
tags: []
paths:
  /api/v3/partners/{shortName}/customers:
    get:
      tags:
        - partners
      summary: List your customers
      description: >-
        Newest first. Pass nextCursor as cursor for the next page. Items have no
        documents: get a customer for its document links.
      operationId: PartnerCustomersController_listCustomers_v3
      parameters:
        - name: shortName
          required: true
          in: path
          description: Your partner short name
          schema:
            type: string
        - name: kycStatus
          required: false
          in: query
          description: Only customers with this KYC status
          schema:
            type: string
            enum:
              - PENDING
              - REJECTED
              - COMPLETED
              - SUBMITTED
              - IN_EDIT
              - NEEDS_RESUBMISSION
        - name: createdFrom
          required: false
          in: query
          description: Only customers onboarded on or after this date (YYYY-MM-DD)
          schema:
            pattern: /^\d{4}-\d{2}-\d{2}$/
            example: '2026-10-01'
            type: string
        - name: createdTo
          required: false
          in: query
          description: Only customers onboarded on or before this date (YYYY-MM-DD)
          schema:
            pattern: /^\d{4}-\d{2}-\d{2}$/
            example: '2026-10-31'
            type: string
        - name: cursor
          required: false
          in: query
          description: >-
            The previous page's nextCursor: the externalUserId of its last
            customer
          schema:
            maxLength: 255
            example: cust_8842
            type: string
        - name: limit
          required: false
          in: query
          schema:
            minimum: 1
            maximum: 50
            default: 20
            type: number
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PartnerCustomerPageDto'
      security:
        - bearer: []
components:
  schemas:
    PartnerCustomerPageDto:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/PartnerCustomerSummaryDto'
        nextCursor:
          type: string
          nullable: true
          example: cust_8842
          description: >-
            The last customer's externalUserId: pass as cursor for the next
            page; null on the last page
      required:
        - data
    PartnerCustomerSummaryDto:
      type: object
      properties:
        externalUserId:
          type: string
          example: cust_8842
        investorId:
          type: string
          example: 3f9c2a1e-7b4d-4c8e-9a61-2d5f0b8e4c17
          description: >-
            Ndovu's investor identifier. Returned for reference; never accepted
            as input.
        kycStatus:
          type: string
          example: COMPLETED
        country:
          type: string
          example: KE
        currency:
          type: string
          example: KES
        firstName:
          type: string
          nullable: true
          example: Jane
          description: null when your identityPolicy is REFERENCED
        lastName:
          type: string
          nullable: true
          example: Wanjiku
          description: null when your identityPolicy is REFERENCED
        email:
          type: string
          nullable: true
          example: jane.wanjiku@example.com
          description: null when your identityPolicy is REFERENCED
        phoneNumber:
          type: string
          nullable: true
          example: '+254712345678'
          description: null when your identityPolicy is REFERENCED
        kyc:
          description: Fields not yet sent are null
          allOf:
            - $ref: '#/components/schemas/PartnerCustomerKycDto'
        createdAt:
          format: date-time
          type: string
          example: '2026-10-22T09:14:03.511Z'
        updatedAt:
          format: date-time
          type: string
          example: '2026-10-22T09:14:03.511Z'
      required:
        - externalUserId
        - investorId
        - kycStatus
        - country
        - currency
        - firstName
        - lastName
        - email
        - phoneNumber
        - kyc
        - createdAt
        - updatedAt
    PartnerCustomerKycDto:
      type: object
      properties:
        identificationType:
          enum:
            - NATIONAL_ID
            - PASSPORT
            - ALIEN_ID
            - ELECTRONIC_ID_CARD
            - ID_BOOK
            - RESIDENT_ID
            - SEAMAN_ID
            - SOCIAL_ID
            - KE_ARMY_ID
            - DRIVING_LICENSE
            - TRAVEL_DOCS
            - VOTING_CARD
          type: string
        identificationNumber:
          type: string
          example: '29384756'
        identificationCountry:
          type: string
          description: ISO 3166-1 alpha-2 code of the country that issued the ID
          example: KE
        residencyCountry:
          type: string
          description: ISO 3166-1 alpha-2 code of the country the customer lives in
          example: KE
        dateOfBirth:
          type: string
          example: '1991-04-02'
        gender:
          enum:
            - MALE
            - FEMALE
            - NON_BINARY
          type: string
        taxPayerNumber:
          type: string
          example: A012345678Z
          description: Tax identification number. For Kenyan customers, the KRA PIN.
        residentialAddress:
          type: string
          example: Riverside Drive, Westlands
        city:
          type: string
          example: Nairobi
        postalCode:
          type: string
          example: '00100'
        postalAddress:
          type: string
          example: P.O. Box 12345
        sourceOfFunds:
          enum:
            - SALARY_OR_BUSINESS_PROFIT
            - BANK_CREDIT
            - PERSONAL_SAVINGS
            - PROPERTY_SALES
            - INHERITANCE
            - SHARE_SALES_OR_DIVIDEND
          type: string
        employmentStatus:
          enum:
            - Full Time
            - Part Time
            - Contractor
            - Not employed
          type: string
        nextOfKinNames:
          type: string
          example: John Wanjiku
        nextOfKinContact:
          type: string
          example: '+254722000000'
        nextOfKinEmail:
          type: string
          format: email
          example: john.wanjiku@example.com
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.