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

# Get Number of Authorised Payments for Date Range

> Use this API to retrieve the count of authorised payments within a specific date range. This API helps merchants understand the volume of authorised payments before processing bulk capture operations.




## OpenAPI

````yaml /openapi/payments/flowwise.yaml post /payment/preauth/count/start/{start_date_time}/end/{end_date_time}
openapi: 3.0.3
info:
  title: Flowwise Native API
  version: 1.0.0
  description: >
    Manage orders, payments, refunds, and customers using the Flowwise Native
    API.

    [Source](https://cashfree.atlassian.net/wiki/spaces/ORC/pages/1084032020/API+Documentation)
servers:
  - url: https://sandbox.flowwise.com/router
    description: Sandbox
  - url: https://app.flowwise.com/router
    description: Production
security:
  - ApiKeyAuth: []
    ApiSecret: []
paths:
  /payment/preauth/count/start/{start_date_time}/end/{end_date_time}:
    post:
      summary: Get Number of Authorised Payments for Date Range
      description: >
        Use this API to retrieve the count of authorised payments within a
        specific date range. This API helps merchants understand the volume of
        authorised payments before processing bulk capture operations.
      parameters:
        - name: start_date_time
          in: path
          required: true
          description: Start date and time for the query range.
          schema:
            type: string
            example: '2024-12-01T00:00:00Z'
        - name: end_date_time
          in: path
          required: true
          description: End date and time for the query range.
          schema:
            type: string
            example: '2024-12-01T23:59:59Z'
      responses:
        '200':
          description: Success response for authorized payments count retrieval.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BulkCaptureResponse'
              example:
                total_payment_to_be_captured: 147
                start_date_time: '2024-12-01T00:00:00Z'
                end_date_time: '2024-12-01T23:59:59Z'
        '400':
          description: Bad Request - Invalid date range
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                message: Invalid date range or start date is after end date
                code: invalid_date_range
                type: validation_error
        '401':
          description: Unauthorized - Invalid or missing authentication credentials
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                message: Invalid API credentials provided
                code: unauthorized
                type: authentication_error
        '500':
          description: Internal Server Error - Count retrieval failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                message: Count retrieval failed due to server error
                code: count_failed
                type: server_error
      security:
        - ApiKeyAuth: []
          ApiSecret: []
components:
  schemas:
    BulkCaptureResponse:
      type: object
      properties:
        total_payment_to_be_captured:
          type: integer
          description: Total number of payments that will be captured.
          example: 147
        start_date_time:
          type: string
          description: Start date and time for the bulk capture operation.
          example: '2024-12-01T00:00:00Z'
        end_date_time:
          type: string
          description: End date and time for the bulk capture operation.
          example: '2024-12-01T23:59:59Z'
    ErrorResponse:
      type: object
      description: Error response structure returned when an API request fails.
      properties:
        message:
          type: string
          description: Human-readable error message describing what went wrong.
        code:
          type: string
          description: Machine-readable error code for programmatic handling.
        type:
          type: string
          description: Category or type of error that occurred.
      required:
        - message
        - code
        - type
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-client-id
      description: >-
        Client app ID. You can find your app ID in the [Merchant
        Dashboard](https://merchant.cashfree.com/auth/login/pg/developers/api-keys?env=prod).
    ApiSecret:
      type: apiKey
      in: header
      name: x-client-secret
      description: >-
        Client secret key. You can find your secret key in the [Merchant
        Dashboard](https://merchant.cashfree.com/auth/login/pg/developers/api-keys?env=prod).

````