Retrieve Financial Account Limits

Reserved for future use.

Retrieve the daily, weekly, and monthly transaction limits for a Financial Account. The response also includes the actual transaction amounts used for each limit, based on the timestamp used in the request. Limits are returned for each supported currency for the Financial Account.

By default, the response includes the transaction limits in effect at the current time. Use the ts query parameter to return the transaction limits in effect on a specific date and time instead.

Endpoint

GET /v1/financial-accounts/{financialAccountId}/limits

Authorization Header

Authorization: Bearer <access_token>

Path Parameters

financialAccountId REQUIRED

string (UUID)

ID of the Financial Account.

Query Parameters

string (date-time), required format: ISO 8601 (example: 2018-11-13T20:20:39+00:00)

Timestamp used to retrieve the transaction limits. If not specified, the timestamp for the current date and time is used.

Request Body

None

Returns

Returns the Financial Account Limits object. This object contains the Financial Account’s daily, weekly, and monthly transaction limits by currency, as well as the actual transaction amount used for each limit.

SAMPLE RESPONSE

				
					{
  "financialAccountId": "93900da4-b882-4299-95e5-8e11a95b1a6e",
  "periods": [
    {
      "type": "daily",
      "from": "2022-06-22T00:00:00+00:00",
      "to": "2022-06-23T00:00:00+00:00",
      "amount": {
        "USD": {
          "limit": "10000.00",
          "used": "150.00"
        },
        "CAD": {
          "limit": "15000.00",
          "used": "350.00"
        }
      }
    },
    {
      "type": "weekly",
      "from": "2022-06-19",
      "to": "2022-06-25",
      "amount": {
        "USD": {
          "limit": "50000.00",
          "used": "2150.00"
        },
        "CAD": {
          "limit": "65000.00",
          "used": "550.00"
        }
      }
    },
    {
      "type": "monthly",
      "from": "2022-06-01T00:00:00+00:00",
      "to": "2022-07-01T00:00:00+00:00",
      "amount": {
        "USD": {
          "limit": "200000.00",
          "used": "20150.00"
        },
        "CAD": {
          "limit": "265000.00",
          "used": "17550.00"
        }
      }
    }
  ]
}