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

# Get Customer Requests in a Period of Time

> This API allows you to fetch a complete list of customer linked to your app-id. You can filter the results based on multiple query params. This API is paginated. The default is 20 transactions per page.



## OpenAPI

````yaml /api/openapi/v2-reference.yaml get /v2/customers/all
openapi: 3.0.2
info:
  title: Multi-currency Payment APIs
  description: >-
    ## Introduction

    The Multi-currency Payment API Solution provides developers with a unified
    API schema to support multiple currencies efficiently. These APIs enable
    seamless transactions for both payin and payout operations, ensuring a
    robust, reliable, and scalable payment infrastructure for businesses dealing
    with various currencies.

    ### Key Features

    - **Single API Schema**: A single schema supports all currencies in your
    account, simplifying integration and management.

    - **Payin and Payout Process**:
      - **Step 1**: Call the **Get payin method list** to retrieve the list of supported methods.
      - **Step 2**: Call the **Get payin required fields** to get specific required fields for each method.
      - **Step 3**: Create the payment using the method and required fields from the previous step.
      - **Step 4**: On the sandbox environment, you can call the **Simulate payin** to simulate the payment.

    <div class="gst-note-red">
      Please note: GST should only be set to <code>true</code> for AU Merchants for <b>AUD</b> currency only. For all other currencies, set GST to <code>false</code>.
    </div>

    This documentation provides detailed guidance for integrating these
    capabilities into your application.
  version: 2.0.0
  termsOfService: https://helloclever.co/terms
  contact:
    email: support@helloclever.co
servers:
  - url: https://api.cleverhub.co/api
    description: Sandbox Environment
  - url: https://api-merchant.helloclever.co/api
    description: Production Environment
security:
  - app-id: []
    secret-key: []
paths:
  /v2/customers/all:
    get:
      tags:
        - Customer
      summary: Get Customer Requests in a Period of Time
      description: >-
        This API allows you to fetch a complete list of customer linked to your
        app-id. You can filter the results based on multiple query params. This
        API is paginated. The default is 20 transactions per page.
      parameters:
        - name: from_date
          in: query
          schema:
            type: string
          description: >-
            Start date to query payment requests from, format 'DD/MM/YY' or
            'YYYY-MM-DDThh:mm:ss'. This datetime would be in UTC timezone
          example: '2022-01-01T00:00:00'
        - name: to_date
          in: query
          schema:
            type: string
          description: >-
            End date to query payment requests, format 'DD/MM/YY' or
            'YYYY-MM-DDThh:mm:ss'. The datetime would be in UTC timezone
          example: '2022-01-01T00:00:00'
        - name: page
          in: query
          schema:
            type: string
          description: Page number to query. Currently we support 20 records per page
        - name: per_page
          in: query
          schema:
            type: string
          description: Default 20 records per page
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  per_page:
                    type: integer
                  page:
                    type: integer
                  total_page:
                    type: integer
                  records:
                    type: array
                    items:
                      type: object
                      required:
                        - uuid
                        - email
                        - first_name
                        - last_name
                        - dob
                        - gender
                        - phone
                        - street
                        - city
                        - postal_code
                        - state
                        - country
                        - identity
                      properties:
                        uuid:
                          type: string
                          description: Customer uuid
                        email:
                          type: string
                          description: Customer's email
                        first_name:
                          type: string
                          description: Customer's first name
                        last_name:
                          type: string
                          description: Customer's last name
                        middle_name:
                          type: string
                          description: Customer's middle name
                        dob:
                          type: string
                          description: Customer date of birth format 'yyyy-mm-dd'
                        phone:
                          type: string
                          description: Customer's phone
                          example: +61-412345678
                        gender:
                          type: string
                          example: male
                          description: Customer's Gender
                          enum:
                            - male
                            - female
                            - other
                        street:
                          type: string
                          description: The primary name of an address's street.
                        street2:
                          type: string
                          description: The secondary name of an address's street.
                        city:
                          type: string
                          description: Name of an address's city or town.
                        postal_code:
                          type: string
                          description: The address's postcode
                        state:
                          type: string
                          description: The address's state / province / county.
                        country:
                          type: string
                          description: ISO 3166-1 alpha-2 country code.
                        identity:
                          type: object
                          required:
                            - issue_country
                            - document_number
                            - issue_date
                            - expiry_date
                            - id_doc_type
                          properties:
                            issue_country:
                              type: string
                              description: ISO 3166-1 alpha-2 country code.
                            id_doc_type:
                              type: string
                              description: Type of identification document
                              enum:
                                - passport
                                - id_card
                                - driving_license
                            document_number:
                              type: string
                              description: number ID
                            issue_date:
                              type: string
                              description: Format 'yyyy-mm-dd'
                            expiry_date:
                              type: string
                              description: Format 'yyyy-mm-dd'
                example:
                  total: 100
                  page: 1
                  per_page: 20
                  records:
                    - uuid: VMMAOTFQ
                      email: string
                      first_name: string
                      last_name: string
                      middle_name: string
                      dob: '2024-04-16'
                      phone: +61-12345523
                      gender: male
                      street: string
                      street2: string
                      city: string
                      postal_code: string
                      state: string
                      country: US
                      identity:
                        issue_country: US
                        document_number: string
                        issue_date: '2024-04-16'
                        expiry_date: '2024-04-16'
                        id_doc_type: Passport
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
              example:
                errors:
                  code: REQUIRE_LOGIN
                  message: Not Authorised
components:
  securitySchemes:
    app-id:
      type: apiKey
      in: header
      name: app-id
      description: |
        A unique identifier assigned to each application.
    secret-key:
      type: apiKey
      in: header
      name: secret-key
      description: |
        A secure token associated with the `app-id`.

````

## Related topics

- [Get Payin Requests in a Period of Time](/api/payin/get-payin-requests-in-a-period-of-time.md)
- [Get Payout Requests in a Period of Time](/api/payout/get-payout-requests-in-a-period-of-time.md)
- [Get Contact Requests in a Period of Time](/api/contact/get-contact-requests-in-a-period-of-time.md)
