---
title: "List negative balance limits"
method: GET
path: "/negative_balance_limits"
tags: ["Negative Balance Limit"]
---

# List negative balance limits

`GET /negative_balance_limits`

## Request

- Base URL: `https://api.gocardless.com`
- URL: `https://api.gocardless.com/negative_balance_limits`
- Auth: HTTP bearer

Returns a [cursor-paginated](https://docs.gocardless.com/docs/api-reference/data-conventions#cursor-pagination) list of negative balance limits.

<p class="restricted-notice"><strong>Restricted</strong>: This endpoint is restricted to GoCardless Embed customers. Please [contact us](https://forms.gocardless.com/l/305971/2023-01-25/535t8n){:target="_blank"} if you are interested in using this product.</p>

## Query parameters

- `before` string, nullable
- `after` string, nullable
- `limit` union
  - integer
  - string
- `currency` 'AUD' | 'CAD' | 'DKK' | 'EUR' | 'GBP' | 'NZD' | 'SEK' | 'USD': [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) currency code. Currently "AUD", "CAD", "DKK", "EUR", "GBP", "NZD", "SEK" and "USD" are supported.
- `creditor` string: Unique identifier, beginning with "CR".

## Headers

- `GoCardless-Version` string, required

## Response `200`

Successful response

- NegativeBalanceLimitMultiResourceResponse
  - `negative_balance_limits` NegativeBalanceLimit[]
    - `id` string, required: Unique identifier, beginning with "NBL".
    - `created_at` string, date-time, required: Fixed [timestamp](https://docs.gocardless.com/docs/api-reference/data-conventions#dates-and-times), recording when this limit was created.
    - `balance_limit` integer, required: The limit amount in pence (e.g. 10000 for a -100 GBP limit).
    - `currency` 'AUD' | 'CAD' | 'DKK' | 'EUR' | 'GBP' | 'NZD' | 'SEK' | 'USD', required: [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) currency code. Currently "AUD", "CAD", "DKK", "EUR", "GBP", "NZD", "SEK" and "USD" are supported.
    - `links` NegativeBalanceLimitLinks, required
      - `creator_user` string: ID of the creator_user who created this limit
      - `creditor` string: ID of [creditor](https://docs.gocardless.com/docs/api-reference/creditor) which this limit relates to
  - `meta` NegativeBalanceLimitPaginationMeta: Cursor pagination information
    - `limit` integer, required
    - `cursors` object, required
      - `before` string, nullable, required: Cursor pointing to the end of the desired set.
      - `after` string, nullable, required: Cursor pointing to the start of the desired set.

## Other responses

- `400`: Bad Request
- `401`: Unauthorised
- `404`: Not found
- `422`: Validation Error
- `500`: Internal Error

---

[API](https://skmtc.dev/gocardless/apis/gocardless-api.md) - [All operations](https://skmtc.dev/gocardless/apis/gocardless-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gocardless/apis/gocardless-api/revisions/4dd3dae45364?raw)