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

# List funding sources for an account

> Endpoint for retrieving a list of funding sources belonging to the main Dwolla Connect Account.

# List funding sources for an account

Retrieve a list of funding sources that belong to a main Dwolla Account. By default, all funding sources are returned in the list and can be identified as active or removed via the `removed` attribute.

### Pagination

All listing endpoints support cursor-based pagination to traverse through an existing data set. With cursor-based pagination you must always start at the beginning of a list and query your way forward in the data set. Cursor-based endpoints accept the `limit` and `cursor` query string parameters.

A `limit` is set to control the number of objects that are returned in the response. By default, a `limit` is set to 25 objects that are returned and sorted by `created` timestamp. Limit can have a max value of 200 objects. The `cursor` is a pointer indicating the next item in the data set. The cursor to use for the next page of results is returned in the `_links` object where a URL is generated and returned for the `next` data set (referenced below). If you omit the `cursor` from your request, you will receive the first page of results.ß

It is recommended to use the `_links` object in the response which includes the following relational links for paging.

* `self` link indicates the URL of the resource itself.
* `next` includes the URL to list the next set of objects as defined by `limit` that is set. The absence of a `next` URL indicates that you have reached the end of the data set.
* `prev` includes the URL to list the previous set of objects as defined by `limit`. the absence of a `prev` URL indicates that you are at the beginning of the data set.

##### Example HTTP Request

> `GET https://api.dwolla.com/accounts/{id}/funding-sources?limit=10&cursor={encoded-cursor}`

## HTTP request

> `GET https://api.dwolla.com/accounts/{id}/funding-sources`

## Request parameters

| Parameter     | Required | Type    | Description                                                                                                                                                                                               |
| ------------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| id            | yes      | string  | Account's unique identifier.                                                                                                                                                                              |
| removed       | no       | boolean | Filter removed funding sources. Set to `false` to filter out removed funding sources from list (i.e. - `/accounts/{id}/funding-sources?removed=false`) or `true` to include only removed funding sources. |
| correlationId | no       | string  | A string value to filter on if a `correlationId` was specified on a funding source.                                                                                                                       |

## HTTP status and error codes

| HTTP Status | Message                                 |
| ----------- | --------------------------------------- |
| 403         | Not authorized to list funding sources. |
| 404         | Account not found.                      |

## Request and response

```bash theme={"dark"}
GET https://api.dwolla.com/accounts/ca32853c-48fa-40be-ae75-77b37504581b/funding-sources
Accept: application/vnd.dwolla.v1.hal+json
Authorization: Bearer connect.eyJraWQiOiJPNVVOUVR0VHdDSXBcL0lsYnNlWldtdUFVZHJaVjFuU3lIYlVubkpwYW54WT0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzZ2I3dTQyMjFkb2RwYWYwdGNyM3VrZm04MSIsInRva2VuX3VzZSI6ImFjY2VzcyIsInNjb3BlIjoiYnliLWFwaVwvZXh0ZXJuYWwtcGFydGllczpleGNoYW5nZXMuY3JlYXRlIGJ5Yi1hcGlcL2FjY291bnRzLnJlYWQgYnliLWFwaVwvZXhjaGFuZ2VzLmNyZWF0ZSBieWItYXBpXC9leHRlcm5hbC1wYXJ0aWVzLmNyZWF0ZSBieWItYXBpXC90cmFuc2ZlcnMuY3JlYXRlIGJ5Yi1hcGlcL2V4dGVybmFsLXBhcnRpZXM6ZXhjaGFuZ2VzLnJlYWQgYnliLWFwaVwvdHJlYXN1cnktYWNjb3VudHMucmVhZCBieWItYXBpXC90cmFuc2ZlcnMucmVhZCBieWItYXBpXC9leGNoYW5nZXMucmVhZCBieWItYXBpXC93ZWJob29rLXN1YnNjcmlwdGlvbnMuZGVsZXRlIGJ5Yi1hcGlcL3RyZWFzdXJ5LWFjY291bnRzLmNyZWF0ZSBieWItYXBpXC9leHRlcm5hbC1wYXJ0aWVzOmZ1bmRpbmctc291cmNlcy5yZWFkIGJ5Yi1hcGlcL3dlYmhvb2stc3Vic2NyaXB0aW9ucy5jcmVhdGUgYnliLWFwaVwvd2ViaG9va3MucmVhZCBieWItYXBpXC9leHRlcm5hbC1wYXJ0aWVzOnRyYW5zZmVycy5yZWFkIGJ5Yi1hcGlcL3dlYmhvb2stc3Vic2NyaXB0aW9ucy5yZWFkIGJ5Yi1hcGlcL2V4dGVybmFsLXBhcnRpZXMucmVhZCBieWItYXBpXC9mdW5kaW5nLXNvdXJjZXMuZGVsZXRlIGJ5Yi1hcGlcL3RyZWFzdXJ5LXBhcnRuZXJzLnJlYWQgYnliLWFwaVwvZnVuZGluZy1zb3VyY2VzLnJlYWQgYnliLWFwaVwvYXBwbGljYXRpb25zLnJlYWQgYnliLWFwaVwvZXh0ZXJuYWwtcGFydGllczpmdW5kaW5nLXNvdXJjZXMuY3JlYXRlIGJ5Yi1hcGlcL3dlYmhvb2stc3Vic2NyaXB0aW9ucy5wYXVzZSBieWItYXBpXC9mdW5kaW5nLXNvdXJjZXMuY3JlYXRlIGJ5Yi1hcGlcL3dlYmhvb2tzLnJldHJpZXMiLCJhdXRoX3RpbWUiOjE2OTQ4MDQ5NjAsImlzcyI6Imh0dHBzOlwvXC9jb2duaXRvLWlkcC51cy13ZXN0LTIuYW1hem9uYXdzLmNvbVwvdXMtd2VzdC0yX2xvT0NCOEZ2eCIsImV4cCI6MTY5NDgwODU2MCwiaWF0IjoxNjk0ODA0OTYwLCJ2ZXJzaW9uIjoyLCJqdGkiOiIzOGU0MWYwMS04YjM1LTRmOTAtODcxYy0wMTU3YzkyNzdhMjAiLCJjbGllbnRfaWQiOiIzZ2I3dTQyMjFkb2RwYWYwdGNyM3VrZm04MSJ9.tUcSnucNWvRK8g609EkO9OyD2VFqvYtJHNVz9-jeYfNf2uN_GFdogaf8HtDWXdX8QshDMZ46w3f4AQLuRdZ3a53b5JX3v9FKnDst-PtLZFV5tfIQlhY6gZyXJO_hLpgJJQ6a0m7ZBNJLS5toUp7qTdcgz_5wufB3pNz25jdV6667W1ZGVt5j6P_vMY1DYnTTZZ6KI3pAT9Mvbqp892pdcNbzZhfIvyl5gheiKnpxUdGK-mwBPpKolDWnFw4G7_gyJB4lVqPg9bXdDGwyFuvgZj2K1xQyEWHfXymveaQ6j1SPy7hLcpHwnyGzp5DXFtp7j8iOkFoqZVp9HzeDqGje2g

...
{
    "_links": {
        "self": {
            "href": "https://api.dwolla.com/accounts/3b0f270c-9cfd-4724-bae8-aa4b1659cbb4/funding-sources",
            "type": "application/vnd.dwolla.v1.hal+json",
            "resource-type": "funding-source"
        }
    },
    "_embedded": {
        "funding-sources": [
            {
                "_links": {
                    "self": {
                        "href": "https://api.dwolla.com/funding-sources/9062c625-2094-47ed-9d1f-f40315e4bea4",
                        "type": "application/vnd.dwolla.v1.hal+json",
                        "resource-type": "funding-source"
                    },
                    "treasury-account": {
                        "href": "https://api.dwolla.com/treasury-accounts/ea5f9468-4374-410f-b52e-5461d8cbca94",
                        "type": "application/vnd.dwolla.v1.hal+json",
                        "resource-type": "treasury-account"
                    },
                    "remove": {
                        "href": "https://api.dwolla.com/funding-sources/9062c625-2094-47ed-9d1f-f40315e4bea4",
                        "type": "application/vnd.dwolla.v1.hal+json",
                        "resource-type": "funding-source"
                    }
                },
                "id": "9062c625-2094-47ed-9d1f-f40315e4bea4",
                "bankAccountType": "checking",
                "name": "My Test Bank",
                "created": "2023-09-15T18:50:34.866Z",
                "removed": false
            },
            {
                "_links": {
                    "self": {
                        "href": "https://api.dwolla.com/funding-sources/2bb9b57a-cb45-4bd2-b8ff-e3a5644e0fb4",
                        "type": "application/vnd.dwolla.v1.hal+json",
                        "resource-type": "funding-source"
                    },
                    "treasury-account": {
                        "href": "https://api.dwolla.com/treasury-accounts/ea5f9468-4374-410f-b52e-5461d8cbca94",
                        "type": "application/vnd.dwolla.v1.hal+json",
                        "resource-type": "treasury-account"
                    }
                },
                "id": "2bb9b57a-cb45-4bd2-b8ff-e3a5644e0fb4",
                "bankAccountType": "checking",
                "name": "My Savings Account",
                "created": "2023-09-15T20:05:04.266Z",
                "removed": false
            }
        ]
    }
}

```

```ruby theme={"dark"}
# Using dwolla_v2 - https://github.com/Dwolla/dwolla-v2-ruby
account_url = 'https://api.dwolla.com/accounts/ca32853c-48fa-40be-ae75-77b37504581b'

funding_sources = app_token.get "#{account_url}/funding-sources"
funding_sources._embedded['funding-sources'][0].name # => "Jane Doe's Checking"
```

```php theme={"dark"}
<?php
// Using dwollaswagger - https://github.com/Dwolla/dwolla-swagger-php
$accountUrl = 'https://api.dwolla.com/accounts/ca32853c-48fa-40be-ae75-77b37504581b';

$fsApi = new DwollaSwagger\FundingsourcesApi($apiClient);

$fundingSources = $fsApi->getAccountFundingSources($accountUrl);
$fundingSources->_embedded->{'funding-sources'}[0]->name; # => "Jane Doe’s Checking"
?>
```

```python theme={"dark"}
# Using dwollav2 - https://github.com/Dwolla/dwolla-v2-python
account_url = 'https://api.dwolla.com/accounts/ca32853c-48fa-40be-ae75-77b37504581b'

funding_sources = app_token.get('%s/funding-sources' % account_url)
funding_sources.body['_embedded']['funding-sources'][0]['name'] # => 'Jane Doe’s Checking'
```

```javascript theme={"dark"}
// Using dwolla-v2 - https://github.com/Dwolla/dwolla-v2-node
var accountUrl =
  "https://api.dwolla.com/accounts/ca32853c-48fa-40be-ae75-77b37504581b";

dwolla
  .get(`${accountUrl}/funding-sources`)
  .then((res) => res.body._embedded["funding-sources"][0].name); // => 'ABC Bank Checking'
```
