> ## 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 payment schedules > Retrieve an array of payment schedules on a specific credit account. GET/credit/accounts/\{account\_token}/paymentschedules Retrieve an array of payment schedules on a specific credit account. This endpoint supports [sorting and pagination](https://www.marqeta.com/docs/core-api/sorting-and-pagination.md). ## URL path parameters | Fields | Description | | - | - | | account\_token string Required | Unique identifier of the credit account for which you want to retrieve payment schedules. Send a `GET` request to `/credit/accounts` to retrieve existing credit account tokens. **Allowable Values:** Existing account token | ## URL query parameters | Fields | Description | | - | - | | statuses array of strings Optional | Status of the payment schedules to retrieve. **Allowable Values:** `ACTIVE`, `COMPLETED`, `TERMINATED` | | frequency array of strings Optional | Frequency of the payment schedules to retrieve. **Allowable Values:** `ONCE`, `MONTHLY` | | count integer Optional | Number of payment schedule resources to retrieve. **Allowable Values:** 1 min | | 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 | List of payment schedules. **Allowable Values:** Valid array of one or more payment schedule objects | | data\[].**token** string Returned | Unique identifier of the payment schedule. **Allowable Values:** 36 char max | | data\[].**payment\_source\_token** string Returned | Unique identifier of a payment source. **Allowable Values:** Existing payment source token | | data\[].**account\_token** string Returned | Unique identifier of the credit account on which the payment schedule is made. **Allowable Values:** Existing account token | | data\[].**amount\_category** string Returned | A category used to determine the actual payment amount. **Allowable Values:** `FIXED`, `MINIMUM_PAYMENT`, `REMAINING_STATEMENT_BALANCE`, `CURRENT_BALANCE` | | data\[].**status** string Returned | Status of the payment schedule. **Allowable Values:** `ACTIVE`, `COMPLETED`, `TERMINATED` | | data\[].**amount** decimal Conditionally returned | Amount of the payment. Returned if the `amount_category` is `FIXED`. **Allowable Values:** Format: 0.00 | | data\[].**frequency** string Returned | Defines how often to make a scheduled payment. **Allowable Values:** `ONCE`, `MONTHLY` | | data\[].**payment\_day** string Conditionally returned | Day on which monthly payments are made. Returned if the `frequency` is `MONTHLY`. **Allowable Values:** `PAYMENT_DUE_DAY` | | data\[].**next\_payment\_impact\_date** date Conditionally returned | Date to make a one-time payment. Returned if `frequency` is `ONCE`. **Allowable Values:** Format: yyyy-MM-dd | | data\[].**currency\_code** string Returned | Valid three-digit [ISO 4217 currency code](https://www.iso.org/iso-4217-currency-codes.html). **Allowable Values:** `USD` | | data\[].**description** string Conditionally returned | Description of the payment schedule. **Allowable Values:** 255 char max | | data\[].**created\_time** datetime Conditionally returned | Date and time when the payment schedule 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 payment schedule was last updated on Marqeta's credit platform, in UTC. **Allowable Values:** Format: yyyy-MM-ddThh:mm:ssZ | ## Sample response body ```json JSON expandable lines wrap theme={null} { "count": 2, "start_index": 0, "end_index": 1, "is_more": false, "data": [ { "token": "mytoken", "payment_source_token": "source1", "account_token": "account1", "amount_category": "REMAINING_STATEMENT_BALANCE", "status": "ACTIVE", "amount": null, "frequency": "MONTHLY", "payment_day": "PAYMENT_DUE_DAY", "next_payment_impact_date": "2023-08-31", "currency_code": "USD", "description": "Sample payoff", "created_time": "2023-08-22T22:17:11.407Z", "updated_time": "2023-08-22T22:17:11.407Z" }, { "token": "mytoken1", "payment_source_token": "source1", "account_token": "account1", "amount_category": "FIXED", "status": "COMPLETED", "amount": 100, "frequency": "ONCE", "payment_day": "PAYMENT_DUE_DAY", "next_payment_impact_date": "2023-08-10", "currency_code": "USD", "description": "Sample payment", "created_time": "2023-07-22T22:13:31.426Z", "updated_time": "2023-07-22T22:13:31.426Z" } ] } ``` ## Related topics - [Payment Schedules Overview](https://www.marqeta.com/docs/core-api/credit-account-payment-schedules.md) - [Retrieve payment schedule transitions](https://www.marqeta.com/docs/core-api/credit-account-payment-schedules/schedule-transitions/retrieve-transitions.md) - [Retrieve payment schedule](https://www.marqeta.com/docs/core-api/credit-account-payment-schedules/retrieve-payment-schedule.md) - [Create payment schedule](https://www.marqeta.com/docs/core-api/credit-account-payment-schedules/create-payment-schedule.md) - [Retrieve payment schedule transition](https://www.marqeta.com/docs/core-api/credit-account-payment-schedules/schedule-transitions/retrieve-payment-schedule-transition.md)