Remove a label #

This section outlines how to remove a Label by its unique identifier. The amount of a Label must be reduced to zero prior to removing a label. Once a label is removed it can no longer be retrieved by its unique identifier.

HTTP request #

DELETE https://api.dwolla.com/labels/{id}

Request parameters #

Parameter	Required	Type	Description
id	yes	string	Label unique identifier

HTTP status and error codes #

HTTP Status	Code	Description
403	InvalidResourceState	Amount must be zero to remove label.

Request and response #

Raw

DELETE https://api-sandbox.dwolla.com/labels/30165ded-2f32-4ee9-b340-ac44dda1d7fc
Accept: application/vnd.dwolla.v1.hal+json
Authorization: Bearer pBA9fVDBEyYZCEsLf/wKehyh1RTpzjUj5KzIRfDi0wKTii7DqY

{
    "_links": {
        "ledger-entries": {
            "href": "https://api-sandbox.dwolla.com/labels/30165ded-2f32-4ee9-b340-ac44dda1d7fc/ledger-entries",
            "type": "application/vnd.dwolla.v1.hal+json",
            "resource-type": "ledger-entry"
        },
        "self": {
            "href": "https://api-sandbox.dwolla.com/labels/30165ded-2f32-4ee9-b340-ac44dda1d7fc",
            "type": "application/vnd.dwolla.v1.hal+json",
            "resource-type": "label"
        },
        "remove": {
            "href": "https://api-sandbox.dwolla.com/labels/30165ded-2f32-4ee9-b340-ac44dda1d7fc",
            "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"
        },
        "update": {
            "href": "https://api-sandbox.dwolla.com/labels/30165ded-2f32-4ee9-b340-ac44dda1d7fc/ledger-entries",
            "type": "application/vnd.dwolla.v1.hal+json",
            "resource-type": "ledger-entry"
        }
    },
    "id": "30165ded-2f32-4ee9-b340-ac44dda1d7fc",
    "created": "2019-05-16T14:56:52.629Z",
    "amount": {
        "value": "0.00",
        "currency": "USD"
    }
}

Retrieve 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.