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

# Get a customer

> A customer's current status. Use it if you missed a webhook. It is read live, so it reflects any decision made since.

A customer's current status, read live. Use it if you missed a
[webhook](https://docs.paj.cash/concepts/kyc.md#when-things-change-later) or want to check before showing
someone a screen. Another business's customer reads as `404`.


## OpenAPI

````yaml GET /pub/v2/customers/{customerId}
openapi: 3.0.0
info:
  title: Paj Public API
  description: >-
    Programmatic access to Paj's on/off ramp. Register a Nigerian bank account,
    get

    the on-chain address that pays it, create offramp orders for a specific
    amount,

    and read the live conversion rates.


    Every request must carry an `x-api-key` header. Keys are scoped to a
    business,

    and the rates you receive already have that business's fee applied.
  version: 2.0.0
  contact: {}
servers:
  - url: https://api.paj.cash
    description: Production
security: []
tags: []
paths:
  /pub/v2/customers/{customerId}:
    get:
      tags:
        - Pub V2
      summary: Get a customer
      description: >-
        A customer's current status. Use it if you missed a webhook. It is read
        live, so it reflects any decision made since.
      operationId: PubV2Controller_getKycCustomer
      parameters:
        - name: customerId
          required: true
          in: path
          schema:
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KycCustomerResDto'
        '401':
          description: Missing or invalid API key (x-api-key header)
        '404':
          description: No customer with that id is yours
      security:
        - x-api-key: []
components:
  schemas:
    KycCustomerResDto:
      type: object
      properties:
        customerId:
          type: string
          example: cus_8f2a6c1d9e4b7f03a5c8d2e6b1f4a790
        externalUserId:
          type: string
          example: acme-user-123
        status:
          type: string
          enum:
            - OTP_SENT
            - VERIFIED
            - IN_REVIEW
            - DECLINED
          description: Read live, so it reflects any decision made since.
          example: VERIFIED
        tier:
          type: number
          example: 1
        declineCode:
          type: string
          enum:
            - ID_NOT_VERIFIED
            - ATTEMPTS_EXCEEDED
            - ALREADY_LINKED
      required:
        - customerId
        - externalUserId
        - status
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key

````

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