DocsRetrieve an Exchange Session #
This section shows you how to retrieve an exchange session resource. The retrieve an Exchange Session API endpoint allows you to fetch the details of a previously initiated exchange session. This is a crucial step in Dwolla's Open Banking flow, which facilitates secure access to user's bank account information.
HTTP request #
GET https://api.dwolla.com/exchange-sessions/{id}
Request parameters #
| Parameter | Required | Type | Description |
|---|---|---|---|
| id | yes | string | Exchange Session resource unique identifier. |
HTTP status and error codes #
| HTTP Status | Code | Description |
|---|---|---|
| 200 | Ok | The Dwolla API accepted the request and returned a response. |
| 404 | NotFound | The requested resource was not found. Check Exchange Session ID. |
Request and response (Visa) #
GET https://api.dwolla.com/exchange-sessions/fcd15e5f-8d13-4570-a9b7-7fb49e55941d
Accept: application/vnd.dwolla.v1.hal+json
Authorization: Bearer pBA9fVDBEyYZCEsLf/wKehyh1RTpzjUj5KzIRfDi0wKTii7DqY
...
{
"created": "2024-03-25T17:13:38.430Z",
"_links": {
"self": {
"href": "https://api.dwolla.com/exchange-sessions/9b7fb629-0fad-44f4-8c5e-44c25a0bfa8e",
"type": "application/vnd.dwolla.v1.hal+json",
"resource-type": "exchange-sessions"
},
"exchange-partner": {
"href": "https://api.dwolla.com/exchange-partners/bca8d065-49a5-475b-a6b4-509bc8504d22",
"type": "application/vnd.dwolla.v1.hal+json",
"resource-type": "exchange-partner"
},
"external-provider-session": {
"href": "https://int-widgets.moneydesktop.com/md/connect/lAfkc7m897s3t1ks9mmwyj4ry7Zq0xql4grzAg1kz77x7c9jrwls1t22w6xt8d2lsxx9zpqv30js3wswfdwcrpAsqgbAfkqwpksp7c2chsx167xy90Asfc67dkj9y48y8p142xw3yp4x5l9t9gkk6m3yk5vwsvyq2qq7w9trszxwdl14lmkg7l6949bn5n41chdkbnxycy40n9b6fkbdwl6qt5wl107k1x8srvlkpz325p412x9tkyA5clf39109lsfrgz2lkgsvntqf7l0zzwb5hl658gdjbxwhb52krwybnbdAqfq69cdy54l05jkvfwyf01q89x48jtgtx290lzjdfcty1lwb8d648wns/eyJ1aV9tZXNzYWdlX3ZlcnNpb24iOjQsInVpX21lc3NhZ2Vfd2Vidmlld191cmxfc2NoZW1lIjoibXgiLCJtb2RlIjoidmVyaWZpY2F0aW9uIn0%3D",
"type": "application/vnd.dwolla.v1.hal+json",
"resource-type": "text/html"
}
}
}
Request and response (Plaid) #
GET https://api.dwolla.com/exchange-sessions/fcd15e5f-8d13-4570-a9b7-7fb49e55941d
Accept: application/vnd.dwolla.v1.hal+json
Authorization: Bearer pBA9fVDBEyYZCEsLf/wKehyh1RTpzjUj5KzIRfDi0wKTii7DqY
...
{
"created": "2024-11-18T18:48:11.357Z",
"_links": {
"self": {
"href": "https://api.dwolla.com/exchange-sessions/fcd15e5f-8d13-4570-a9b7-7fb49e55941d",
"type": "application/vnd.dwolla.v1.hal+json",
"resource-type": "exchange-sessions"
},
"exchange-partner": {
"href": "https://api.dwolla.com/exchange-partners/f53ffb32-c84f-496a-9d9d-acd100d396ef",
"type": "application/vnd.dwolla.v1.hal+json",
"resource-type": "exchange-partner"
}
},
"externalProviderSessionToken": "link-production-b41e8ed3-0874-4c64-b07d-a77088979d5f"
}
Request and response (MX) #
GET https://api.dwolla.com/exchange-sessions/fcd15e5f-8d13-4570-a9b7-7fb49e55941d
Accept: application/vnd.dwolla.v1.hal+json
Authorization: Bearer pBA9fVDBEyYZCEsLf/wKehyh1RTpzjUj5KzIRfDi0wKTii7DqY
...
{
"created": "2024-03-25T17:13:38.430Z",
"_links": {
"self": {
"href": "https://api.dwolla.com/exchange-sessions/9b7fb629-0fad-44f4-8c5e-44c25a0bfa8e",
"type": "application/vnd.dwolla.v1.hal+json",
"resource-type": "exchange-sessions"
},
"exchange-partner": {
"href": "https://api.dwolla.com/exchange-partners/2164407f-33c3-4555-a6a1-40d5e9e58744",
"type": "application/vnd.dwolla.v1.hal+json",
"resource-type": "exchange-partner"
},
"external-provider-session": {
"href": "https://int-widgets.moneydesktop.com/md/connect/MmU5OGVlNWI4ZTMwMjdjM2RjNWRhYzAyMjUwMWRkYjY1OThhZWM1ZTRkN2NjNjg3ODM1M2RkNmU2NWVhZjlkZjhjZDJiNGE0NWFjMDZjMDY0M2FhNjA4NWM5Yzk2ZGUwMmQ1ZTRiODg0ZDgxYzA4NzZkMDBjMDBhMmZlYmE5MDk5MjdkODJiMDBmNjczMGU2OTNkNzcyMTliOWFlMTk0M3xVU1ItZTUyZDhlYjItMmYxNi00NzE0LTgwM2YtMTdjOGZjNGU5OWI3/eyJ1aV9tZXNzYWdlX3ZlcnNpb24iOjQsInVpX21lc3NhZ2Vfd2Vidmlld191cmxfc2NoZW1lIjoibXgiLCJtb2RlIjoidmVyaWZpY2F0aW9uIn0%3D",
"type": "application/vnd.dwolla.v1.hal+json",
"resource-type": "text/html"
}
}
}
Previous
2025 All Rights Reserved
Financial institutions play an important role in our network.
All funds transfers made using the Dwolla Platform are performed by a financial institution partner, and any funds held in a Dwolla Balance are held by a financial institution partner. Learn more about our financial institution partners.