GET///
Retrieve an array of existing fee policies.
This endpoint supports sorting and pagination.
URL query parameters
| Fields | Description |
|---|---|
| count integer Optional | Number of fee policy resources to retrieve. Allowable Values: 1–100 |
| start_index integer Optional | Sort order index of the first resource in the returned array. Allowable Values: 0 min |
| sort_by string Optional | Field on which to sort. Prefix the field name with a hyphen (-) to sort in descending order. Omit the hyphen to sort in ascending order.NOTE: You must sort using system field names such as lastModifiedTime, and not by the field names appearing in response bodies such as last_modified_time.Allowable Values: lastModifiedTime, -lastModifiedTime |
Response body
| Fields | Description |
|---|---|
| count integer Returned | Number of resources returned. Allowable Values: 1-10 |
| start_index integer Returned | Sort order index of the first resource in the returned array. Allowable Values: Any integer |
| end_index integer Returned | Sort order index of the last resource in the returned array. Allowable Values: Any integer |
| is_more boolean Returned | A value of true indicates that more unreturned resources exist.Allowable Values: true, false |
| data array of objects Returned | One or more fee policies. Allowable Values: One or more fee policy objects |
| data[].token string Conditionally returned | Unique identifier of the fee policy. Allowable Values: 36 char max |
| data[].name string Conditionally returned | Name of the fee policy. Allowable Values: 255 char max |
| data[].description string Conditionally returned | Description of the fee policy. Allowable Values: 255 char max |
| data[].account object Conditionally returned | Contains information on the fees in an account’s fee policy. Allowable Values: Existing account object |
| data[].account.late_payment object Conditionally returned | Contains information on the late payment fee. Allowable Values: Existing late_payment object |
| data[].account.returned_payment object Conditionally returned | Contains information on the returned payment fee. Allowable Values: Existing returned_payment object |
| data[].account.foreign_transaction_fee object Conditionally returned | Contains information on the foreign transaction fee. Allowable Values: Existing foreign_transaction_fee object |
| data[].account.monthly_fee object Conditionally returned | Contains information on the monthly periodic fees. Allowable Values: Existing periodic_fees object |
| data[].account.annual_fee object Conditionally returned | Contains information on the annual periodic fees. Allowable Values: Existing periodic_fees object |
| data[].created_time datetime Conditionally returned | Date and time when the fee policy was created on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| data[].updated_time datetime Conditionally returned | Date and time when the fee policy was last updated on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
Sample response body
JSON
{
"count": 2,
"start_index": 0,
"end_index": 2,
"is_more": true,
"data": [
{
"token": "my_fee_policy_token_1234",
"name": "Gold Fee Policy",
"description": "A gold fee policy",
"account": {
"late_payment": {
"default_method": "FLAT",
"default_value": 10
},
"returned_payment": {
"default_method": "FLAT",
"default_value": 10
},
"foreign_transaction_fee": {
"default_method": "PERCENTAGE",
"default_value": 12.5
}
},
"created_time": "2025-04-01T23:41:58.802Z",
"updated_time": "2025-04-05T16:04:48.643Z"
},
{
"token": "my_fee_policy_token_4321",
"name": "Silver Fee Policy",
"description": "A silver fee policy",
"account": {
"late_payment": {
"default_method": "FLAT",
"default_value": 10
},
"returned_payment": {
"default_method": "FLAT",
"default_value": 10
},
"foreign_transaction_fee": {
"default_method": "PERCENTAGE",
"default_value": 12.5
}
},
"created_time": "2025-04-01T23:41:58.802Z",
"updated_time": "2025-04-05T16:04:48.643Z"
}
]
}