---
title: "List Current Usages"
method: GET
path: "/disbursement_rules/current_usages"
tags: ["Disbursement Rules"]
---

# List Current Usages

`GET /disbursement_rules/current_usages`

Retrieve the current usage for disbursements.

## Query parameters

- `linked_to` string, required
- `after_cursor` string
- `before_cursor` string
- `limit` integer
- `updated_at.gte` string, date-time
- `updated_at.lte` string, date-time

## Headers

- `Finix-Version` string

## Response `200`

List of `Disbursement Rule` resources

- object
  - `page` Page — Details the page that's returned.
    - `limit` integer — The number of entries to return.
    - `next_cursor` string, nullable — The cursor to use for the next page of results.
  - `_embedded` object
    - `current_usages` CurrentUsage[]
      - `ach_velocity` object — An object that contains the current usage and limits for ACH disbursements.
        - `daily_velocity` Velocity — An object that contains the current usage and limits for disbursements.
          - `current_volume` integer — The current volume of disbursements.
          - `current_count` integer — The current count of disbursements.
          - `volume_limit` integer — The volume limit for disbursements.
          - `count_limit` integer — The count limit for disbursements.
          - `window_reset` string, date-time — The date and time when the usage window resets.
        - `monthly_velocity` Velocity — An object that contains the current usage and limits for disbursements.
          - `current_volume` integer — The current volume of disbursements.
          - `current_count` integer — The current count of disbursements.
          - `volume_limit` integer — The volume limit for disbursements.
          - `count_limit` integer — The count limit for disbursements.
          - `window_reset` string, date-time — The date and time when the usage window resets.
      - `card_velocity` object — An object that contains the current usage and limits for Card disbursements.
        - `daily_velocity` Velocity — An object that contains the current usage and limits for disbursements.
          - `current_volume` integer — The current volume of disbursements.
          - `current_count` integer — The current count of disbursements.
          - `volume_limit` integer — The volume limit for disbursements.
          - `count_limit` integer — The count limit for disbursements.
          - `window_reset` string, date-time — The date and time when the usage window resets.
        - `monthly_velocity` Velocity — An object that contains the current usage and limits for disbursements.
          - `current_volume` integer — The current volume of disbursements.
          - `current_count` integer — The current count of disbursements.
          - `volume_limit` integer — The volume limit for disbursements.
          - `count_limit` integer — The count limit for disbursements.
          - `window_reset` string, date-time — The date and time when the usage window resets.
      - `balance_adjustment_velocity` object — An object that contains the current usage and limits for balance adjustments.
        - `daily_velocity` Velocity — An object that contains the current usage and limits for disbursements.
          - `current_volume` integer — The current volume of disbursements.
          - `current_count` integer — The current count of disbursements.
          - `volume_limit` integer — The volume limit for disbursements.
          - `count_limit` integer — The count limit for disbursements.
          - `window_reset` string, date-time — The date and time when the usage window resets.
        - `monthly_velocity` Velocity — An object that contains the current usage and limits for disbursements.
          - `current_volume` integer — The current volume of disbursements.
          - `current_count` integer — The current count of disbursements.
          - `volume_limit` integer — The volume limit for disbursements.
          - `count_limit` integer — The count limit for disbursements.
          - `window_reset` string, date-time — The date and time when the usage window resets.
      - `currency` 'CAD' | 'USD' — ISO 4217 3-letter currency code.
      - `linked_to` string — The identifier for the `Application` or `Platform` resource associated with the `Disbursement Rule`.
      - `linked_type` 'APPLICATION' | 'PLATFORM' — The type of the resource that is specified in the `linked_to` field.
      - `type` 'TOTAL' — The `type` will always be `TOTAL`.
      - `_links` object
        - `self` Self — Link to the resource that was used in the request.
          - `href` string
  - `_links` object
    - `self` Self — Link to the resource that was used in the request.
      - `href` string
    - `next` Next — Link to the next page of entries.
      - `href` string

## Other responses

- `400` — Bad Request. The server cannot process the request due to malformed syntax or invalid data.
- `401` — Unauthorized. Authentication is required and has failed or has not been provided.
- `403` — Forbidden. The client is authenticated but does not have permission to access the resource.
- `406` — Not Acceptable. The server could not accept the submitted request. Confirm how the request was formatted and submitted.
- `422` — Unprocessable Entity. One or more query parameters were syntactically valid but could not be processed.

---

[API](https://skmtc.net/finix/apis/finix-api-reference.md) · [All operations](https://skmtc.net/finix/apis/finix-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/finix/finix-api-reference/versions/5426f6f99c52/schema)