AccountVerificationResponse

  • accountName
    Type: string | null
    required

    Account holder name as returned by the registry

  • accountNumber
    Type: string | null
    required
  • address
    Type: object | null
    required

    Customer address (when returned by registry, mostly NG)

    • lga
      Type: string

      Local government area (Nigeria)

    • state
      Type: string
    • street
      Type: string
    • town
      Type: string
  • bankCode
    Type: string | null
    required
  • bankName
    Type: string | null
    required
  • country
    Type: string
    required
  • error
    Type: object | null
    required

    Populated only when status is failed or error

    • code
      Type: string
      required
    • message
      Type: string
      required
  • id
    Type: stringFormat: uuid
    required

    Unique verification ID

  • identifier
    Type: string
    required

    The account number that was verified

  • origin
    Type: stringenum
    required

    Where this verification was initiated. api = Lira API key (machine-to-machine). dashboard = logged-in dashboard user.

    values
    • api
    • dashboard
  • status
    Type: stringenum
    required
    values
    • pending
    • success
    • failed
    • error
    • inconclusive
  • verificationType
    enum
    const:  
    ACCOUNT_NUMBER
    required
    values
    • ACCOUNT_NUMBER
  • verified
    Type: boolean | null
    required
  • verifiedAt
    Type: string | nullFormat: date-time
    required

    the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

  • identity
    Type: object
    • idType
      Type: stringenum
      required

      Identity document type returned by the registry

      values
      • NIN
      • TIN
    • idValue
      Type: string
      required

      Identity document value