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

# List fees

> Use this endpoint to list existing fees.

GET/fees

Use this endpoint to list existing fees.

This endpoint supports [field filtering](https://www.marqeta.com/docs/core-api/field-filtering.md) and [pagination](https://www.marqeta.com/docs/core-api/sorting-and-pagination.md).

## URL query parameters

| Fields | Description |
| - | - |
| count integer  Optional | Number of resources to retrieve. **Allowable Values:**  1-10 **Default value:** 5 |
| start\_index integer  Optional | Sort order index of the first resource in the returned array. **Allowable Values:**  Any integer **Default value:** 0 |
| fields string  Optional | Comma-delimited list of fields to return (`field_1,field_2`, and so on). Leave blank to return all fields. **Allowable Values:**  Comma-delimited list of fields, or blank |
| sort\_by string  Optional | Field on which to sort. Use any field in the resource model, or one of the system fields `lastModifiedTime` or `createdTime`. Prefix the field name with a hyphen (`-`) to sort in descending order. Omit the hyphen to sort in ascending order. **Allowable Values:**  `createdTime`, `lastModifiedTime`, or any field in the resource model **Default value:** `-createdTime` |

## Response body

| Fields | Description |
| - | - |
| count integer  Conditionally returned | Number of resources to retrieve. This field is returned if there are resources in your returned array. **Allowable Values:**  1-10 |
| data array of objects  Conditionally returned | An array of fee objects. Objects are returned as appropriate to your query. **Allowable Values:**  Valid array of one or more fee objects |
| data\[].**active** boolean  Returned | Specifies whether the fee is active. **Allowable Values:**  `true`, `false` **Default value:** `true` |
| data\[].**amount** decimal  Returned | Amount of the fee. **Allowable Values:**  decimal **Format:** 0.00 |
| data\[].**category** string  Conditionally returned | Specifies if the fee is a standalone fee or a real-time fee. **Allowable Values:**  `REALTIME`, `STANDALONE` |
| data\[].**created\_time** datetime  Returned | Date and time when the `fees` object was created, in UTC. **Allowable Values:**  datetime **Format:** yyyy-MM-ddThh:mm:ssZ |
| data\[].**currency\_code** string  Returned | Three-digit ISO 4217 currency code. **Allowable Values:**  Valid three-digit [ISO 4217 currency code](https://www.iso.org/iso-4217-currency-codes.html) |
| data\[].**fee\_attributes** object  Conditionally returned | Describes the attributes of a fee. **Allowable Values:**  `reason`, `region`, `status`, `transaction_type` |
| data\[].fee\_attributes.**reason** string  Conditionally returned | Describes the reason for the fee. **Allowable Values:**  255 char max |
| data\[].fee\_attributes.**region** string  Conditionally returned | Describes the region in which the fee is assessed. **Allowable Values:**  255 char max |
| data\[].fee\_attributes.**status** string  Conditionally returned | Describes the status of the fee. **Allowable Values:**  255 char max |
| data\[].fee\_attributes.**transaction\_type** string  Conditionally returned | Specifies the transaction type in which the fee was assessed. **Allowable Values:**  - `authorization`  - `authorization.atm.withdrawal`  - `balanceinquiry`  - `fee.charge`  - `pindebit.atm.withdrawal`  - `pindebit.authorization`  - `pindebit.balanceinquiry` |
| data\[].**last\_modified\_time** datetime  Returned | Date and time when the `fees` object was last modified, in UTC. **Allowable Values:**  datetime **Format:** yyyy-MM-ddThh:mm:ssZ |
| data\[].**name** string  Returned | Name of the fee. **Allowable Values:**  50 char max |
| data\[].**tags** string  Conditionally returned | Descriptive metadata about the fee. **Allowable Values:**  255 char max |
| data\[].**memo** string  Conditionally returned | Additional text describing the fee. **Allowable Values:**  1–255 chars |
| data\[].**token** string  Returned | Unique identifier of the `fees` object. **Allowable Values:**  36 char max |
| data\[].**type** string  Conditionally returned | Specifies if the fee is a flat fee or a percentage of the transaction amount. **Allowable Values:**  `FLAT`, `PERCENTAGE` |
| end\_index integer  Conditionally returned | Sort order index of the last resource in the returned array. This field is returned if there are resources in your returned array. **Allowable Values:**  Any integer |
| is\_more boolean  Conditionally returned | A value of `true` indicates that more unreturned resources exist. A value of `false` indicates that no more unreturned resources exist. This field is returned if there are resources in your returned array. **Allowable Values:**  `true`, `false` |
| start\_index integer  Conditionally returned | Sort order index of the first resource in the returned array. This field is returned if there are resources in your returned array. **Allowable Values:**  Any integer |

## Sample response body

```json JSON lines wrap theme={null}
{
  "count": 1,
  "start_index": 0,
  "end_index": 1,
  "is_more": false,
  "data[]": {
    "token": "my_fee_02",
    "active": true,
    "name": "My Fee 02",
    "amount": 3,
    "tags": "My Tags",
    "created_time": "2024-05-11T18:03:39Z",
    "last_modified_time": "2024-05-11T18:03:39Z",
    "currency_code": "USD"
  }
}
```


## Related topics

- [List fee policies](https://www.marqeta.com/docs/core-api/credit-policies/fee-policies/list-fee.md)
- [Fees Overview](https://www.marqeta.com/docs/core-api/fees.md)
- [Fee Policies Overview](https://www.marqeta.com/docs/core-api/credit-policies/fee-policies.md)
- [Policies Overview](https://www.marqeta.com/docs/core-api/credit-policies.md)
- [Credit Programs in the Marqeta Dashboard](https://www.marqeta.com/docs/developer-guides/credit-programs-dashboard.md)