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

# List and search customers

> Returns a paginated list of customers sorted by creation date. Supports fuzzy search across customer names, business names, and email addresses, plus exact filtering by email and verification status. Default limit is 25 customers per page, maximum 200.



## OpenAPI

````yaml get /customers
openapi: 3.1.0
info:
  title: Dwolla API
  description: Dwolla API Documentation
  contact:
    name: Dwolla Developer Relations Team
    url: https://developers.dwolla.com
    email: api@dwolla.com
  version: '2.0'
  termsOfService: https://www.dwolla.com/legal/tos/
  license:
    name: MIT
    url: https://github.com/Dwolla/dwolla-openapi/blob/master/LICENSE
servers:
  - url: https://api.dwolla.com
    description: Production server
  - url: https://api-sandbox.dwolla.com
    description: Sandbox server
security:
  - clientCredentials: []
tags:
  - name: tokens
    description: Operations related to Application Access Tokens
  - name: root
    description: Root API operations
  - name: accounts
    description: Operations related to Accounts
  - name: customers
    description: Operations related to Customers
  - name: kba
    description: Operations related to Knowledge-Based Authentication
  - name: beneficial owners
    description: Operations related to Beneficial Owners
  - name: documents
    description: Operations related to Documents
  - name: exchanges
    description: Operations related to Exchanges
  - name: exchange sessions
    description: Operations related to Exchange Sessions
  - name: funding sources
    description: Operations related to Funding Sources
  - name: transfers
    description: Operations related to Transfers
  - name: labels
    description: Operations related to Labels
  - name: mass payments
    description: Operations related to Mass Payments
  - name: events
    description: Operations related to Events
  - name: webhook subscriptions
    description: Operations related to Webhook Subscriptions
  - name: webhooks
    description: Operations related to Webhooks
  - name: client tokens
    description: Operations related to Client Tokens
  - name: sandbox simulations
    description: Sandbox-only operations for simulating processing of bank transfers
paths:
  /customers:
    get:
      tags:
        - customers
      summary: List and search customers
      description: >-
        Returns a paginated list of customers sorted by creation date. Supports
        fuzzy search across customer names, business names, and email addresses,
        plus exact filtering by email and verification status. Default limit is
        25 customers per page, maximum 200.
      operationId: listAndSearchCustomers
      parameters:
        - name: limit
          in: query
          description: How many results to return
          required: false
          schema:
            type: integer
        - name: offset
          in: query
          description: How many results to skip
          required: false
          schema:
            type: integer
        - name: search
          in: query
          description: Searches on certain fields
          required: false
          schema:
            type: string
        - name: status
          in: query
          description: Filter by customer status
          required: false
          schema:
            type: string
        - $ref: '#/components/parameters/Accept'
      responses:
        '200':
          description: successful operation
          headers: {}
          content:
            application/vnd.dwolla.v1.hal+json:
              schema:
                $ref: '#/components/schemas/Customers'
        '403':
          description: Forbidden
          headers: {}
          content:
            application/vnd.dwolla.v1.hal+json:
              schema:
                $ref: '#/components/schemas/ForbiddenError'
components:
  parameters:
    Accept:
      name: Accept
      in: header
      required: true
      description: >-
        The media type of the response. Must be
        application/vnd.dwolla.v1.hal+json
      schema:
        type: string
        enum:
          - application/vnd.dwolla.v1.hal+json
        default: application/vnd.dwolla.v1.hal+json
  schemas:
    Customers:
      title: Customers
      type: object
      properties:
        _links:
          additionalProperties:
            $ref: '#/components/schemas/HalLink'
        _embedded:
          type: object
          properties:
            customers:
              type: array
              items:
                oneOf:
                  - $ref: '#/components/schemas/UnverifiedCustomer'
                  - $ref: '#/components/schemas/ReceiveOnlyCustomer'
                  - $ref: '#/components/schemas/VerifiedPersonalCustomer'
                  - $ref: '#/components/schemas/VerifiedSolePropCustomer'
                  - $ref: '#/components/schemas/VerifiedBusinessCustomer'
        total:
          type: integer
          example: 2
    ForbiddenError:
      title: ForbiddenError
      description: Error response schema for 403 Forbidden
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: string
          example: Forbidden
        message:
          type: string
          example: The supplied credentials are not authorized for this resource.
    HalLink:
      title: HalLink
      type: object
      properties:
        href:
          type: string
          example: https://api.dwolla.com
        type:
          type: string
          example: application/vnd.dwolla.v1.hal+json
        resource-type:
          type: string
          example: resource-type
    UnverifiedCustomer:
      title: UnverifiedCustomer
      description: Unverified customer - basic customer type with no KYC verification
      allOf:
        - $ref: '#/components/schemas/BaseCustomer'
        - type: object
          required:
            - type
            - status
          properties:
            type:
              type: string
              enum:
                - unverified
              example: unverified
            status:
              type: string
              enum:
                - unverified
                - suspended
                - deactivated
              example: unverified
            businessName:
              type: string
              example: Jane Corp llc
    ReceiveOnlyCustomer:
      title: ReceiveOnlyCustomer
      description: Receive-only user - can only receive funds, not send
      allOf:
        - $ref: '#/components/schemas/BaseCustomer'
        - type: object
          required:
            - type
            - status
          properties:
            type:
              type: string
              enum:
                - receive-only
              example: receive-only
            status:
              type: string
              enum:
                - unverified
                - suspended
                - deactivated
              example: unverified
            businessName:
              type: string
              example: Jane Corp llc
    VerifiedPersonalCustomer:
      title: VerifiedPersonalCustomer
      description: >-
        Verified personal customer - fully KYC verified individual with send and
        receive capabilities
      allOf:
        - $ref: '#/components/schemas/BaseCustomer'
        - type: object
          required:
            - type
            - status
            - address1
            - city
            - state
            - postalCode
          properties:
            type:
              type: string
              enum:
                - personal
              example: personal
            status:
              type: string
              enum:
                - verified
                - suspended
                - deactivated
                - document
                - retry
                - kba
              example: verified
            address1:
              type: string
              example: 123 Main Street
            address2:
              type: string
              example: Ste 123
            city:
              type: string
              example: Des Moines
            state:
              type: string
              example: IA
            postalCode:
              type: string
              example: '50309'
    VerifiedSolePropCustomer:
      title: VerifiedSolePropCustomer
      description: >-
        Verified sole proprietorship customer - distinguished from
        VerifiedBusinessCustomer by businessType=soleProprietorship
      allOf:
        - $ref: '#/components/schemas/BaseCustomer'
        - type: object
          required:
            - type
            - status
            - address1
            - city
            - state
            - postalCode
            - businessName
            - businessType
            - businessClassification
          properties:
            type:
              type: string
              enum:
                - business
              example: business
            status:
              type: string
              enum:
                - verified
                - suspended
                - deactivated
                - document
                - retry
              example: verified
            address1:
              type: string
              example: 123 Main Street
            address2:
              type: string
              example: Ste 123
            city:
              type: string
              example: Des Moines
            state:
              type: string
              example: IA
            postalCode:
              type: string
              example: '50309'
            businessName:
              type: string
              example: Jane Corp
            businessType:
              type: string
              enum:
                - soleProprietorship
              example: soleProprietorship
            businessClassification:
              type: string
              example: 9ed3f670-7d6f-11e3-b1ce-5404a6144203
    VerifiedBusinessCustomer:
      title: VerifiedBusinessCustomer
      description: >-
        Verified business customer (LLC, Corporation, Partnership) -
        distinguished from VerifiedSolePropCustomer by presence of a controller
        object
      allOf:
        - $ref: '#/components/schemas/BaseCustomer'
        - type: object
          required:
            - type
            - status
            - address1
            - city
            - state
            - postalCode
            - businessName
            - businessType
            - businessClassification
            - controller
          properties:
            type:
              type: string
              enum:
                - business
              example: business
            status:
              type: string
              enum:
                - verified
                - suspended
                - deactivated
                - document
                - retry
              example: verified
            address1:
              type: string
              example: 123 Main Street
            address2:
              type: string
              example: Ste 123
            city:
              type: string
              example: Des Moines
            state:
              type: string
              example: IA
            postalCode:
              type: string
              example: '50309'
            phone:
              type: string
              example: '555555555'
            website:
              type: string
              example: https://www.dwolla.com
            businessName:
              type: string
              example: Jane Corp
            doingBusinessAs:
              type: string
              example: Jane's Coffee and Sweets
            businessType:
              type: string
              enum:
                - llc
                - corporation
                - partnership
              example: llc
            businessClassification:
              type: string
              example: 9ed3f670-7d6f-11e3-b1ce-5404a6144203
            controller:
              type: object
              required:
                - firstName
                - lastName
                - title
                - address
              properties:
                firstName:
                  type: string
                  example: John
                lastName:
                  type: string
                  example: Controller
                title:
                  type: string
                  example: CEO
                address:
                  type: object
                  properties:
                    address1:
                      type: string
                      example: 462 Main Street
                    address2:
                      type: string
                      example: Suite 123
                    address3:
                      type: string
                      example: Unit 123
                    city:
                      type: string
                      example: Des Moines
                    postalCode:
                      type: string
                      example: '50309'
                    country:
                      type: string
                      example: USA
                    stateProvinceRegion:
                      type: string
                      example: IA
    BaseCustomer:
      title: BaseCustomer
      description: Base schema containing common fields for all customer types
      type: object
      required:
        - _links
        - id
        - firstName
        - lastName
        - email
        - created
      properties:
        _links:
          additionalProperties:
            $ref: '#/components/schemas/HalLink'
        id:
          type: string
          example: c41125c5-99c4-4303-a9f6-d066d28a61e3
        firstName:
          type: string
          example: Jane
        lastName:
          type: string
          example: Doe
        email:
          type: string
          example: janedoe@mail.com
        correlationId:
          type: string
          example: CID-abe2bb3d-d2ff-433b-95a3-0debd960ed25
        created:
          type: string
          format: date-time
          example: '2022-10-07T16:46:13.023Z'
  securitySchemes:
    clientCredentials:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: /token
          x-speakeasy-token-endpoint-authentication: client_secret_basic
          scopes: {}

````