# Transfer Limits API

Date for which to retrieve transfer limits (ISO 8601 format)

## Response Codes

### `200 OK`

- **object**
  - **data** (array of objects, required): List of transfer limits
    - **data*** (object)
      - **company_id** (string, required): Company ID
      - **is_fbo** (boolean, required): Whether the company is a FBO; based on the company ID prefix
      - **date** (date, required): The date for the limit view (ISO format)
      - **program_limit_per_transaction** (object, required): Program transaction limits
        - **Directional Limits object**
          - **credit** (object)
            - **limit** (integer)
            - **amount_originated** (integer)
          - **debit** (object)
            - **limit** (integer)
            - **amount_originated** (integer)
      - **daily_limit** (object, required): Daily limits with progress
        - **Directional Limits object**
          - **credit** (object)
            - **limit** (integer)
            - **amount_originated** (integer)
          - **debit** (object)
            - **limit** (integer)
            - **amount_originated** (integer)
      - **monthly_limit** (object, required): Monthly limits with progress
        - **Directional Limits object**
          - **credit** (object)
            - **limit** (integer)
            - **amount_originated** (integer)
          - **debit** (object)
            - **limit** (integer)
            - **amount_originated** (integer)
  - **has_more** (boolean, required): Whether there are more transfer limits

### `400 Bad Request`

A parameter in the query given in the request does not match the valid queries for the endpoint.

### `401 Unauthorized`

- User has not been authenticated. Invalid or missing API key.
- API key is not active. The API key used is no longer active.
- Could not find API key. The API key provided is not associated with any user.
- Please provide API key in Authorization header. The Authorization header is not in the request.
- Please provide API key in the form Authorization: [api-key]. The Authorization header is not formatted properly.
- Insufficient privileges. Issuing API key required. Write access requires an Issuing API key. Reach out at [lithic.com/contact](/content/contact/index.html).
- Insufficient privileges to create virtual cards. Creating virtual cards requires an additional privilege.

### `422 Unprocessable Entity`

### `429 Too Many Requests`

Client has exceeded the number of allowed requests in a given time period.
- Rate limited, too many requests per second. User has exceeded their per second rate limit.
- Rate limited, reached daily limit. User has exceeded their daily rate limit.
- Rate limited, too many keys tried. One IP has queried too many different API keys.

## Example Request

```bash
curl --request GET \
     --url https://sandbox.lithic.com/v1/transfer_limits \
     --header 'accept: application/json'
```

## Example Response

```json
{
  "data": [
    {
      "company_id": "string",
      "is_fbo": true,
      "date": "2026-07-18",
      "program_limit_per_transaction": {
        "credit": {
          "limit": 0,
          "amount_originated": 0
        },
        "debit": {
          "limit": 0,
          "amount_originated": 0
        }
      },
      "daily_limit": {
        "credit": {
          "limit": 0,
          "amount_originated": 0
        },
        "debit": {
          "limit": 0,
          "amount_originated": 0
        }
      },
      "monthly_limit": {
        "credit": {
          "limit": 0,
          "amount_originated": 0
        },
        "debit": {
          "limit": 0,
          "amount_originated": 0
        }
      }
    }
  ],
  "has_more": true
}
```