List labels for a customer #

List all Labels for a specified Verified Customer. Labels are sorted by created date in descending order (most recent first).

HTTP request #

GET https://api.dwolla.com/customers/{id}/labels

Request parameters #

Parameter	Required	Type	Description
id	yes	string	Customer unique identifier to retrieve labels for.
limit	no	integer	Number of results to return. Defaults to 25.
offset	no	integer	Number of results to skip. Used for pagination.

Request and response #

Raw

GET https://api-sandbox.dwolla.com/customers/315a9456-3750-44bf-8b41-487b10d1d4bb/labels
Accept: application/vnd.dwolla.v1.hal+json
Authorization: Bearer pBA9fVDBEyYZCEsLf/wKehyh1RTpzjUj5KzIRfDi0wKTii7DqY

{
    "_links": {
        "self": {
            "href": "https://api-sandbox.dwolla.com/customers/315a9456-3750-44bf-8b41-487b10d1d4bb/labels",
            "type": "application/vnd.dwolla.v1.hal+json",
            "resource-type": "label"
        },
        "first": {
            "href": "https://api-sandbox.dwolla.com/customers/315a9456-3750-44bf-8b41-487b10d1d4bb/labels?limit=25&offset=0",
            "type": "application/vnd.dwolla.v1.hal+json",
            "resource-type": "label"
        },
        "last": {
            "href": "https://api-sandbox.dwolla.com/customers/315a9456-3750-44bf-8b41-487b10d1d4bb/labels?limit=25&offset=0",
            "type": "application/vnd.dwolla.v1.hal+json",
            "resource-type": "label"
        },
        "customer": {
            "href": "https://api-sandbox.dwolla.com/customers/315a9456-3750-44bf-8b41-487b10d1d4bb",
            "type": "application/vnd.dwolla.v1.hal+json",
            "resource-type": "customer"
        }
    },
    "_embedded": {
        "labels": [
            {
                "_links": {
                    "self": {
                        "href": "https://api-sandbox.dwolla.com/labels/7e042ffe-e25e-40d2-b86e-748b98845ecc",
                        "type": "application/vnd.dwolla.v1.hal+json",
                        "resource-type": "label"
                    },
                    "update": {
                        "href": "https://api-sandbox.dwolla.com/labels/7e042ffe-e25e-40d2-b86e-748b98845ecc/ledger-entries",
                        "type": "application/vnd.dwolla.v1.hal+json",
                        "resource-type": "ledger-entry"
                    },
                    "ledger-entries": {
                        "href": "https://api-sandbox.dwolla.com/labels/7e042ffe-e25e-40d2-b86e-748b98845ecc/ledger-entries",
                        "type": "application/vnd.dwolla.v1.hal+json",
                        "resource-type": "ledger-entry"
                    },
                    "customer": {
                        "href": "https://api-sandbox.dwolla.com/customers/315a9456-3750-44bf-8b41-487b10d1d4bb",
                        "type": "application/vnd.dwolla.v1.hal+json",
                        "resource-type": "customer"
                    }
                },
                "id": "7e042ffe-e25e-40d2-b86e-748b98845ecc",
                "created": "2019-05-15T22:19:09.635Z",
                "amount": {
                    "value": "5.00",
                    "currency": "USD"
                }
            }
        ]
    },
    "total": 1
}

List label ledger entries

Create a label reallocation

Test in the Sandbox for free today.

Use sandbox environment to test API requests.

Get API Keys

Dwolla

Product

Developers

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.