> ## 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 external party

> Endpoint for listing funding sources for external parties.

# List funding-sources for an External Party

Retrieve a list of funding sources that belong to an External Party. 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/external-parties/{id}/funding-sources?limit=10&cursor={encoded-cursor}`

## HTTP request

`GET https://api.dwolla.com/external-parties/{id}/funding-sources`

## Request parameters

| Parameter     | Required | Type    | Description                                                                                                                                                                                                       |
| ------------- | -------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| id            | yes      | string  | External Party resource unique identifier.                                                                                                                                                                        |
| removed       | no       | boolean | Filter removed funding sources. Set to `false` to filter out removed funding sources from list (i.e. - `/external-parties/{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 | Code     | Message                               | Description                                                  |
| ----------- | -------- | ------------------------------------- | ------------------------------------------------------------ |
| 200         | Ok       | Success                               | The Dwolla API accepted the request and returned a response. |
| 404         | NotFound | The requested resource was not found. | External Party not found. Check external party Id.           |

### Request and response

```bash theme={"dark"}
GET https://api.dwolla.com/external-parties/ce708eda-8d4d-4adf-8943-3232346e153e/funding-sources
Authorization: Bearer connect.eyJraWQiOiJPNVVOUVR0VHdDSXBcL0lsYnNlWldtdUFVZHJaVjFuU3lIYlVubkpwYW54WT0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzZ2I3dTQyMjFkb2RwYWYwdGNyM3VrZm04MSIsInRva2VuX3VzZSI6ImFjY2VzcyIsInNjb3BlIjoiYnliLWFwaVwvZXh0ZXJuYWwtcGFydGllczpleGNoYW5nZXMuY3JlYXRlIGJ5Yi1hcGlcL2FjY291bnRzLnJlYWQgYnliLWFwaVwvZXhjaGFuZ2VzLmNyZWF0ZSBieWItYXBpXC9leHRlcm5hbC1wYXJ0aWVzLmNyZWF0ZSBieWItYXBpXC90cmFuc2ZlcnMuY3JlYXRlIGJ5Yi1hcGlcL2V4dGVybmFsLXBhcnRpZXM6ZXhjaGFuZ2VzLnJlYWQgYnliLWFwaVwvdHJlYXN1cnktYWNjb3VudHMucmVhZCBieWItYXBpXC90cmFuc2ZlcnMucmVhZCBieWItYXBpXC9leGNoYW5nZXMucmVhZCBieWItYXBpXC93ZWJob29rLXN1YnNjcmlwdGlvbnMuZGVsZXRlIGJ5Yi1hcGlcL3RyZWFzdXJ5LWFjY291bnRzLmNyZWF0ZSBieWItYXBpXC9leHRlcm5hbC1wYXJ0aWVzOmZ1bmRpbmctc291cmNlcy5yZWFkIGJ5Yi1hcGlcL3dlYmhvb2stc3Vic2NyaXB0aW9ucy5jcmVhdGUgYnliLWFwaVwvd2ViaG9va3MucmVhZCBieWItYXBpXC9leHRlcm5hbC1wYXJ0aWVzOnRyYW5zZmVycy5yZWFkIGJ5Yi1hcGlcL3dlYmhvb2stc3Vic2NyaXB0aW9ucy5yZWFkIGJ5Yi1hcGlcL2V4dGVybmFsLXBhcnRpZXMucmVhZCBieWItYXBpXC9mdW5kaW5nLXNvdXJjZXMuZGVsZXRlIGJ5Yi1hcGlcL3RyZWFzdXJ5LXBhcnRuZXJzLnJlYWQgYnliLWFwaVwvZnVuZGluZy1zb3VyY2VzLnJlYWQgYnliLWFwaVwvYXBwbGljYXRpb25zLnJlYWQgYnliLWFwaVwvZXh0ZXJuYWwtcGFydGllczpmdW5kaW5nLXNvdXJjZXMuY3JlYXRlIGJ5Yi1hcGlcL3dlYmhvb2stc3Vic2NyaXB0aW9ucy5wYXVzZSBieWItYXBpXC9mdW5kaW5nLXNvdXJjZXMuY3JlYXRlIGJ5Yi1hcGlcL3dlYmhvb2tzLnJldHJpZXMiLCJhdXRoX3RpbWUiOjE2OTQ4MDQ5NjAsImlzcyI6Imh0dHBzOlwvXC9jb2duaXRvLWlkcC51cy13ZXN0LTIuYW1hem9uYXdzLmNvbVwvdXMtd2VzdC0yX2xvT0NCOEZ2eCIsImV4cCI6MTY5NDgwODU2MCwiaWF0IjoxNjk0ODA0OTYwLCJ2ZXJzaW9uIjoyLCJqdGkiOiIzOGU0MWYwMS04YjM1LTRmOTAtODcxYy0wMTU3YzkyNzdhMjAiLCJjbGllbnRfaWQiOiIzZ2I3dTQyMjFkb2RwYWYwdGNyM3VrZm04MSJ9.tUcSnucNWvRK8g609EkO9OyD2VFqvYtJHNVz9-jeYfNf2uN_GFdogaf8HtDWXdX8QshDMZ46w3f4AQLuRdZ3a53b5JX3v9FKnDst-PtLZFV5tfIQlhY6gZyXJO_hLpgJJQ6a0m7ZBNJLS5toUp7qTdcgz_5wufB3pNz25jdV6667W1ZGVt5j6P_vMY1DYnTTZZ6KI3pAT9Mvbqp892pdcNbzZhfIvyl5gheiKnpxUdGK-mwBPpKolDWnFw4G7_gyJB4lVqPg9bXdDGwyFuvgZj2K1xQyEWHfXymveaQ6j1SPy7hLcpHwnyGzp5DXFtp7j8iOkFoqZVp9HzeDqGje2g

...

HTTP/1.1 200 Ok
{
    "_links": {
        "self": {
            "href": "https://api.dwolla.com/external-parties/ef156b8c-159b-45dc-9e1a-9a92fa355cdc/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/447640c8-c554-49d8-be6f-ced7b0c50f95",
                        "type": "application/vnd.dwolla.v1.hal+json",
                        "resource-type": "funding-source"
                    },
                    "external-party": {
                        "href": "https://api.dwolla.com/external-parties/ef156b8c-159b-45dc-9e1a-9a92fa355cdc",
                        "type": "application/vnd.dwolla.v1.hal+json",
                        "resource-type": "external-party"
                    }
                },
                "id": "447640c8-c554-49d8-be6f-ced7b0c50f95",
                "bankAccountType": "savings",
                "name": "Test Bank Account",
                "created": "2023-09-19T22:00:40.360Z",
                "removed": false
            },
            {
                "_links": {
                    "self": {
                        "href": "https://api.dwolla.com/funding-sources/db69159c-7c51-49d2-9476-1fa471ea92d7",
                        "type": "application/vnd.dwolla.v1.hal+json",
                        "resource-type": "funding-source"
                    },
                    "external-party": {
                        "href": "https://api.dwolla.com/external-parties/ef156b8c-159b-45dc-9e1a-9a92fa355cdc",
                        "type": "application/vnd.dwolla.v1.hal+json",
                        "resource-type": "external-party"
                    },
                    "remove": {
                        "href": "https://api.dwolla.com/funding-sources/db69159c-7c51-49d2-9476-1fa471ea92d7",
                        "type": "application/vnd.dwolla.v1.hal+json",
                        "resource-type": "funding-source"
                    }
                },
                "id": "db69159c-7c51-49d2-9476-1fa471ea92d7",
                "bankAccountType": "checking",
                "name": "Test Checking Account",
                "created": "2023-09-19T22:00:57.463Z",
                "removed": false
            },
            {
                "_links": {
                    "self": {
                        "href": "https://api.dwolla.com/funding-sources/2ca64cb8-9835-482c-b29b-15626654b7e7",
                        "type": "application/vnd.dwolla.v1.hal+json",
                        "resource-type": "funding-source"
                    },
                    "external-party": {
                        "href": "https://api.dwolla.com/external-parties/ef156b8c-159b-45dc-9e1a-9a92fa355cdc",
                        "type": "application/vnd.dwolla.v1.hal+json",
                        "resource-type": "external-party"
                    },
                    "remove": {
                        "href": "https://api.dwolla.com/funding-sources/2ca64cb8-9835-482c-b29b-15626654b7e7",
                        "type": "application/vnd.dwolla.v1.hal+json",
                        "resource-type": "funding-source"
                    }
                },
                "id": "2ca64cb8-9835-482c-b29b-15626654b7e7",
                "bankAccountType": "savings",
                "name": "Test Savings Account",
                "created": "2023-09-19T22:01:27.841Z",
                "removed: "false
            }
        ]
    }
}
```

```php theme={"dark"}
/**
 * No example for this language yet.
 **/
```

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

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

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

funding_sources = app_token.get('%s/funding-sources' % external_party_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 externalPartyUrl =
  "https://api.dwolla.com/external-parties/ca32853c-48fa-40be-ae75-77b37504581b";

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