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

# List All Charges

Retrieves all non-recurring Charges for a given Subscription or Invoice created through the Create Charge call.

## **HTTP Request**

`GET https://api.vindicia.com/charges`

## **Route (URL) Parameters**

None.

## Query Parameters

| Parameter | Default | Description | Required |
| - | - | - | - |
| limit | 20 | A limit on the number of objects to be returned, between 1 and 100. | No |
| starting\_after | none | A cursor for use in pagination. starting\_after is an object **id** that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj\_foo, your subsequent call can include starting\_after=obj\_foo in order to fetch the next page of the list. | No |
| ending\_before | none | A cursor for use in pagination. ending\_before is an object **id** that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj\_bar, your subsequent call can include ending\_before=obj\_bar in order to fetch the previous page of the list. | No |
| subscription | n/a | The Subscription **id** or **vid** to fetch charges for. |   |
| invoice | n/a | The Invoice **id** or **vid** to fetch charges for. |   |

## Accepts

None.

## Returns

JSON - A *list* array with a data property that contains an array of up to limit [Charges (Pending)](Charges), starting after the specified starting\_after Charge (or ending before the specified ending\_before Charge). Each entry in the array is a full Charge object. If no more Charges are available, the resulting array will be empty.

A *list* of [Charge](Charges) objects matching the query. Also:

* “total\_count”: Integer count of the number of Charges in the returned list.

* “url”: The query string provided in the request

* “next”: The route (partial URL) to the next Charge object (string to select the “next”); included **id** should match that of the last object returned here

* “previous”: The route (partial URL) to the previous Charge object (string to select the “previous”); included **id** should match that of the first object returned here

**Parent topic:**[Charges (Pending)](../topics/Charges)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.