> ## 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 and search transfers for an account

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

# List and search transfers for an account

This section covers how to retrieve an Account's list of transfers.

### 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}/transfers?limit=10&cursor={encoded-cursor}`

## HTTP request

> `GET https://api.dwolla.com/accounts/{id}/transfers`

## Request parameters

| Parameter | Required | Type | Description |
| - | - | - | - |
| id | yes | string | Account unique identifier. |
| correlationId | no | string | A string value to filter on if a `correlationId` was specified on a transfer. |

## HTTP status and error codes

| HTTP Status | Message |
| - | - |
| 404 | Account not found. |

## Request and response

```bash theme={"dark"}
GET https://api.dwolla.com/accounts/62e88a41-f5d0-4a79-90b3-188cf11a3966/transfers
Accept: application/vnd.dwolla.v1.hal+json
Authorization: Bearer connect.eyJraWQiOiJPNVVOUVR0VHdDSXBcL0lsYnNlWldtdUFVZHJaVjFuU3lIYlVubkpwYW54WT0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzZ2I3dTQyMjFkb2RwYWYwdGNyM3VrZm04MSIsInRva2VuX3VzZSI6ImFjY2VzcyIsInNjb3BlIjoiYnliLWFwaVwvZXh0ZXJuYWwtcGFydGllczpleGNoYW5nZXMuY3JlYXRlIGJ5Yi1hcGlcL2FjY291bnRzLnJlYWQgYnliLWFwaVwvZXhjaGFuZ2VzLmNyZWF0ZSBieWItYXBpXC9leHRlcm5hbC1wYXJ0aWVzLmNyZWF0ZSBieWItYXBpXC90cmFuc2ZlcnMuY3JlYXRlIGJ5Yi1hcGlcL2V4dGVybmFsLXBhcnRpZXM6ZXhjaGFuZ2VzLnJlYWQgYnliLWFwaVwvdHJlYXN1cnktYWNjb3VudHMucmVhZCBieWItYXBpXC90cmFuc2ZlcnMucmVhZCBieWItYXBpXC9leGNoYW5nZXMucmVhZCBieWItYXBpXC93ZWJob29rLXN1YnNjcmlwdGlvbnMuZGVsZXRlIGJ5Yi1hcGlcL3RyZWFzdXJ5LWFjY291bnRzLmNyZWF0ZSBieWItYXBpXC9leHRlcm5hbC1wYXJ0aWVzOmZ1bmRpbmctc291cmNlcy5yZWFkIGJ5Yi1hcGlcL3dlYmhvb2stc3Vic2NyaXB0aW9ucy5jcmVhdGUgYnliLWFwaVwvd2ViaG9va3MucmVhZCBieWItYXBpXC9leHRlcm5hbC1wYXJ0aWVzOnRyYW5zZmVycy5yZWFkIGJ5Yi1hcGlcL3dlYmhvb2stc3Vic2NyaXB0aW9ucy5yZWFkIGJ5Yi1hcGlcL2V4dGVybmFsLXBhcnRpZXMucmVhZCBieWItYXBpXC9mdW5kaW5nLXNvdXJjZXMuZGVsZXRlIGJ5Yi1hcGlcL3RyZWFzdXJ5LXBhcnRuZXJzLnJlYWQgYnliLWFwaVwvZnVuZGluZy1zb3VyY2VzLnJlYWQgYnliLWFwaVwvYXBwbGljYXRpb25zLnJlYWQgYnliLWFwaVwvZXh0ZXJuYWwtcGFydGllczpmdW5kaW5nLXNvdXJjZXMuY3JlYXRlIGJ5Yi1hcGlcL3dlYmhvb2stc3Vic2NyaXB0aW9ucy5wYXVzZSBieWItYXBpXC9mdW5kaW5nLXNvdXJjZXMuY3JlYXRlIGJ5Yi1hcGlcL3dlYmhvb2tzLnJldHJpZXMiLCJhdXRoX3RpbWUiOjE2OTUwNjg2MjgsImlzcyI6Imh0dHBzOlwvXC9jb2duaXRvLWlkcC51cy13ZXN0LTIuYW1hem9uYXdzLmNvbVwvdXMtd2VzdC0yX2xvT0NCOEZ2eCIsImV4cCI6MTY5NTA3MjIyOCwiaWF0IjoxNjk1MDY4NjI4LCJ2ZXJzaW9uIjoyLCJqdGkiOiJmNmQ5MjQ4Ni03MjU5LTRjNTQtOWJmMS1jZWY1MDk1NTQzODkiLCJjbGllbnRfaWQiOiIzZ2I3dTQyMjFkb2RwYWYwdGNyM3VrZm04MSJ9.GxCWTNTih35m-ZZX6rjCVr3CAg_Y3u5n_xz4K3yZRPAmemvSniy5k0moBK-Dq534TyjGOIbi0iQyKKPoEip3YRpQLVrk7Bq5HwYZTgjwdxDbhIUe9LkgWXaVKDOVG-ufrMo7vwsDsfNYhLj70OpBZ2fS3Wnuog3875SeVPN2qlLGa6_vU_WsRCcRJw8Y8eWEttZeLZWm7j30s41ssJL8-Epwq7-__bDM3sFLcfQIADAxSHNPYqq9pACA3qrpCOlo17F8EVqSIT2MJrIrhsi8sT8Y9i1cScaoRZf7MWLJzbtnzOP2M7YDfoXxH9MqsABvcoRJaQoSMjDCgheu1h0clQ

...

{
    "_links": {
        "self": {
            "href": "https://api.dwolla.com/accounts/3b0f270c-9cfd-4724-bae8-aa4b1659cbb1/transfers",
            "type": "application/vnd.dwolla.v1.hal+json",
            "resource-type": "transfer"
        }
    },
    "_embedded": {
        "transfers": [
            {
                "_links": {
                    "self": {
                        "href": "https://api.dwolla.com/transfers/586e5620-0a77-40ea-8ba3-3addd5349dcd",
                        "type": "application/vnd.dwolla.v1.hal+json",
                        "resource-type": "transfer"
                    },
                    "source-funding-source": {
                        "href": "https://api.dwolla.com/funding-sources/737d3c04-02c3-416f-b327-cd5419999b3f",
                        "type": "application/vnd.dwolla.v1.hal+json",
                        "resource-type": "funding-source"
                    },
                    "destination-funding-source": {
                        "href": "https://api.dwolla.com/funding-sources/9062c625-2094-47ed-9d1f-f40315e4bea7",
                        "type": "application/vnd.dwolla.v1.hal+json",
                        "resource-type": "funding-source"
                    }
                },
                "id": "586e5620-0a77-40ea-8ba3-3addd5349dcd",
                "created": "2023-09-20T14:44:54.947Z",
                "amount": {
                    "value": "12.00",
                    "currency": "USD"
                },
                "status": "processed",
                "processingChannel": "ach"
            },
            {
                "_links": {
                    "self": {
                        "href": "https://api.dwolla.com/transfers/60075bd9-2492-4d88-b810-13b162cdec03",
                        "type": "application/vnd.dwolla.v1.hal+json",
                        "resource-type": "transfer"
                    },
                    "source-funding-source": {
                        "href": "https://api.dwolla.com/funding-sources/9062c625-2094-47ed-9d1f-f40315e4bea7",
                        "type": "application/vnd.dwolla.v1.hal+json",
                        "resource-type": "funding-source"
                    },
                    "destination-funding-source": {
                        "href": "https://api.dwolla.com/funding-sources/737d3c04-02c3-416f-b327-cd5419999b3f",
                        "type": "application/vnd.dwolla.v1.hal+json",
                        "resource-type": "funding-source"
                    }
                },
                "id": "60075bd9-2492-4d88-b810-13b162cdec03",
                "created": "2023-09-20T14:43:30.403Z",
                "amount": {
                    "value": "5.12",
                    "currency": "USD"
                },
                "status": "processed",
                "processingChannel": "ach"
            }
        ]
    }
}
```

```ruby theme={"dark"}
# Using dwolla_v2 - https://github.com/Dwolla/dwolla-v2-ruby
account_url = 'https://api.dwolla.com/accounts/62e88a41-f5d0-4a79-90b3-188cf11a3966'

transfers = app_token.get "#{account_url}/transfers"
transfers._embedded['transfers'][0].status # => "processed"
```

```php theme={"dark"}
<?php
// Using dwollaswagger - https://github.com/Dwolla/dwolla-swagger-php
$accountUrl = 'https://api.dwolla.com/accounts/62e88a41-f5d0-4a79-90b3-188cf11a3966';

$transfersApi = new DwollaSwagger\TransfersApi($apiClient);

$transfers = $transfersApi->getAccountTransfers($accountUrl);
$transfers->_embedded->{'transfers'}[0]->status; # => "processed"
?>
```

```python theme={"dark"}
# Using dwollav2 - https://github.com/Dwolla/dwolla-v2-python
account_url = 'https://api.dwolla.com/accounts/62e88a41-f5d0-4a79-90b3-188cf11a3966'

transfers = app_token.get('%s/transfers' % account_url)
transfers.body['_embedded']['transfers'][0]['status'] # => "processed"
```

```javascript theme={"dark"}
// Using dwolla-v2 - https://github.com/Dwolla/dwolla-v2-node
var accountUrl =
  "https://api.dwolla.com/accounts/62e88a41-f5d0-4a79-90b3-188cf11a3966";

dwolla
  .get(`${accountUrl}/transfers`)
  .then((res) => res.body._embedded["transfers"][0].status); // => 'processed'
```


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