{
  "opencollection": "1.0.0",
  "info": {
    "name": "Dwolla API - Labels",
    "version": "2.0"
  },
  "request": {
    "auth": {
      "type": "oauth2",
      "flow": "client_credentials",
      "accessTokenUrl": "/token",
      "credentials": {
        "clientId": "{{clientId}}",
        "clientSecret": "{{clientSecret}}"
      }
    }
  },
  "items": [
    {
      "info": {
        "name": "labels",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Retrieve a label",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.dwolla.com/labels/:id",
            "headers": [
              {
                "name": "Accept",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "Label unique identifier"
              }
            ]
          },
          "docs": "Retrieve details for a specific Label used to categorize and track funds within your account. Returns Label information including unique identifier, current amount with currency, and creation timestamp."
        },
        {
          "info": {
            "name": "Remove a label",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://api.dwolla.com/labels/:id",
            "headers": [
              {
                "name": "Accept",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "A label unique identifier"
              }
            ]
          },
          "docs": "Delete a Label to stop tracking funds and remove it from your account. Returns success status if the Label is successfully removed. Use this to streamline your account management and remove unused Labels from your system."
        },
        {
          "info": {
            "name": "List labels for a customer",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.dwolla.com/customers/:id/labels",
            "headers": [
              {
                "name": "Accept",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "ID of customer"
              },
              {
                "name": "limit",
                "value": "",
                "type": "query",
                "description": "How many results to return"
              },
              {
                "name": "offset",
                "value": "",
                "type": "query",
                "description": "How many results to skip"
              }
            ]
          },
          "docs": "Returns all labels for a specified Verified Customer, sorted by creation date (most recent first). Supports pagination with limit and offset parameters. Each label includes its current amount and creation timestamp."
        },
        {
          "info": {
            "name": "Create a label for a customer",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.dwolla.com/customers/:id/labels",
            "headers": [
              {
                "name": "Accept",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "ID of customer to create a label for"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Creates a new label for a Verified Customer with a specified amount. Labels help organize and track funds within a customer's balance. Returns the location of the created label resource in the response header."
        },
        {
          "info": {
            "name": "List label ledger entries",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.dwolla.com/labels/:id/ledger-entries",
            "headers": [
              {
                "name": "Accept",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "A label unique identifier"
              },
              {
                "name": "limit",
                "value": "",
                "type": "query",
                "description": "How many results to return"
              },
              {
                "name": "offset",
                "value": "",
                "type": "query",
                "description": "How many results to skip"
              }
            ]
          },
          "docs": "Returns all ledger entries for a specific Label, sorted by creation date (newest first). Supports pagination with limit and offset parameters. Each ledger entry includes its amount, currency, and creation timestamp."
        },
        {
          "info": {
            "name": "Create a label ledger entry",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.dwolla.com/labels/:id/ledger-entries",
            "headers": [
              {
                "name": "Accept",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "The Id of the Label to update."
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Create a new ledger entry to track fund adjustments on a Label by specifying a positive or negative amount value. Returns the location of the created ledger entry in the response header. Label amounts cannot go negative, so validation errors occur if the entry would result in a negative Label balance."
        },
        {
          "info": {
            "name": "Retrieve a label ledger entry",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.dwolla.com/ledger-entries/:ledgerEntryId",
            "headers": [
              {
                "name": "Accept",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "ledgerEntryId",
                "value": "",
                "type": "path",
                "description": "A label ledger entry unique identifier"
              }
            ]
          },
          "docs": "Returns detailed information for a specific ledger entry on a Label, including its amount, currency, and creation timestamp."
        },
        {
          "info": {
            "name": "Create a label reallocation",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.dwolla.com/label-reallocations",
            "headers": [
              {
                "name": "Accept",
                "value": ""
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Reallocates funds between two labels belonging to the same Verified Customer. Moves the specified amount from the source label to the destination label, creating ledger entries for both. The reallocation only succeeds if the source label has sufficient funds."
        },
        {
          "info": {
            "name": "Retrieve a label reallocation",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.dwolla.com/label-reallocations/:reallocationId",
            "headers": [
              {
                "name": "Accept",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "reallocationId",
                "value": "",
                "type": "path",
                "description": "Label reallocation unique identifier"
              }
            ]
          },
          "docs": "Retrieve details for a specific label reallocation that transfers funds between Labels. Returns reallocation information including source and destination Labels, amount transferred, status, and creation timestamp. Use this to track and audit fund movements between different Labels."
        }
      ]
    }
  ],
  "bundled": true
}