---
title: List all webhook endpoints
slug: list-all-webhook-endpoints
docTags: 
createdAt: 2026-08-25T19:28:59.170Z
---

{
  "id": "m8EdgRp0vlYNJaKLu9u1i",
  "type": "api-oas-v2",
  "data": {
    "method": "GET",
    "url": "https://api.nue.io/webhook-endpoints",
    "servers": [
      {
        "url": "https://api.nue.io/webhook-endpoints",
        "description": "Nue Production API Endpoint"
      },
      {
        "url": "https://api.sandbox.nue.io/webhook-endpoints",
        "description": "Nue Sandbox API Endpoint"
      }
    ],
    "name": "List all webhook endpoints",
    "description": "<p>Retrieve a list of all webhook endpoints configured for your account. Webhooks allow you to receive real-time notifications when important events occur in your billing system, such as when invoices are created, payments are processed, or subscriptions change. Use this endpoint to see which events you're currently monitoring and where notifications are being sent.</p>",
    "contentType": "application/json",
    "request": {
      "pathParameters": [],
      "headerParameters": [
        {
          "name": "accept",
          "type": "string",
          "kind": "optional",
          "description": "Generated from available response content types",
          "enum": [
            "application/json",
            "*/*"
          ],
          "default": "application/json"
        }
      ],
      "queryParameters": [],
      "bodyDataParameters": [],
      "formDataParameters": [],
      "oAuthParameters": [
        {
          "id": "apiKeyAuth",
          "name": "nue-api-key",
          "kind": "optional",
          "type": "apiKey",
          "in": "header"
        }
      ],
      "cookieParameters": []
    },
    "responses": [
      {
        "statusCode": "200",
        "description": "Retrieves a list of webhook endpoints",
        "jsonExample": "",
        "isExpanded": true,
        "subExamples": [
          {
            "label": "GENERATED",
            "code": "// Retrieves a list of webhook endpoints\n{}"
          },
          {
            "label": "List of Configured Webhooks",
            "code": "{\n  \"webhooks\": [\n    {\n      \"id\": \"e4db815d-f8cb-4d51-b729-6417fb1296ee\",\n      \"name\": \"first webhook\",\n      \"eventTypes\": [\n        \"invoice.activated\",\n        \"invoice.canceled\",\n        \"credit_memo.activated\",\n        \"credit_memo.canceled\"\n      ],\n      \"actionType\": \"Webhook\",\n      \"endpoint\": \"https://mywebsite.com/endpoint1\",\n      \"description\": \"about the first webhook\"\n    },\n    {\n      \"id\": \"e4db815d-f8cb-4d51-b729-6417fb1296ee\",\n      \"name\": \"second webhook\",\n      \"eventTypes\": [\n        \"invoice.activated\",\n        \"invoice.canceled\",\n        \"credit_memo.activated\",\n        \"credit_memo.canceled\"\n      ],\n      \"actionType\": \"Webhook\",\n      \"endpoint\": \"https://mywebsite.com/endpoint2\",\n      \"description\": \"about the second webhook\"\n    }\n  ]\n}"
          }
        ],
        "schema": [
          {
            "kind": "optional",
            "type": "object",
            "description": "",
            "customType": "CreateEventTypeRegistrationResponse",
            "schema": [],
            "modelRef": "#/components/schemas/CreateEventTypeRegistrationResponse",
            "isExpanded": true
          }
        ]
      },
      {
        "statusCode": "400",
        "description": "Bad Request",
        "jsonExample": "",
        "isExpanded": true
      },
      {
        "statusCode": "404",
        "description": "Not Found",
        "jsonExample": "",
        "isExpanded": true
      }
    ],
    "hasXCodeSamples": false,
    "examples": {
      "languages": [
        {
          "id": "VlWHgcIaJpwD-yPauYtCj",
          "language": "curl",
          "label": "cURL",
          "code": "curl --request GET \\\n     --url https://api.nue.io/webhook-endpoints \\\n     --header 'accept: application/json'"
        },
        {
          "id": "aIBA1_zaGZu4DTF95EXhH",
          "language": "javascript",
          "label": "javascript",
          "code": "var myHeaders = new Headers();\nmyHeaders.append(\"accept\", \"application/json\");\nmyHeaders.append(\"content-type\", \"application/json\");\n\nvar requestOptions = {\n   method: 'GET',\n   headers: myHeaders,\n   redirect: 'follow'\n};\n\nfetch(\"https://api.nue.io/webhook-endpoints\", requestOptions)\n   .then(response => response.text())\n   .then(result => console.log(result))\n   .catch(error => console.log('error', error));"
        },
        {
          "id": "made5tCGTCXDmqG8vLddt",
          "language": "ruby",
          "label": "Ruby",
          "code": "require \"uri\"\nrequire \"json\"\nrequire \"net/http\"\n\nurl = URI(\"https://api.nue.io/webhook-endpoints\")\n\nhttps = Net::HTTP.new(url.host, url.port)\nhttps.use_ssl = true\n\nrequest = Net::HTTP::Get.new(url)\nrequest[\"accept\"] = \"application/json\"\nrequest[\"content-type\"] = \"application/json\"\n\nresponse = https.request(request)\nputs response.read_body\n"
        },
        {
          "id": "JSb6srxdMtcCN6Qklce0L",
          "language": "python",
          "label": "Python",
          "code": "import requests\nimport json\n\nurl = \"https://api.nue.io/webhook-endpoints\"\n\npayload = {}\nheaders = {\n   'accept': 'application/json',\n   'content-type': 'application/json'\n}\n\nresponse = requests.request(\"GET\", url, headers=headers, data=payload)\n\nprint(response.text)\n"
        }
      ],
      "selectedLanguageId": "VlWHgcIaJpwD-yPauYtCj"
    },
    "results": {
      "languages": [
        {
          "id": "HBuHl9aisCebY-Ud8yB4P",
          "language": "200",
          "code": "// Retrieves a list of webhook endpoints\n{}",
          "subExamples": [
            {
              "label": "GENERATED",
              "code": "// Retrieves a list of webhook endpoints\n{}"
            },
            {
              "label": "List of Configured Webhooks",
              "code": "{\n  \"webhooks\": [\n    {\n      \"id\": \"e4db815d-f8cb-4d51-b729-6417fb1296ee\",\n      \"name\": \"first webhook\",\n      \"eventTypes\": [\n        \"invoice.activated\",\n        \"invoice.canceled\",\n        \"credit_memo.activated\",\n        \"credit_memo.canceled\"\n      ],\n      \"actionType\": \"Webhook\",\n      \"endpoint\": \"https://mywebsite.com/endpoint1\",\n      \"description\": \"about the first webhook\"\n    },\n    {\n      \"id\": \"e4db815d-f8cb-4d51-b729-6417fb1296ee\",\n      \"name\": \"second webhook\",\n      \"eventTypes\": [\n        \"invoice.activated\",\n        \"invoice.canceled\",\n        \"credit_memo.activated\",\n        \"credit_memo.canceled\"\n      ],\n      \"actionType\": \"Webhook\",\n      \"endpoint\": \"https://mywebsite.com/endpoint2\",\n      \"description\": \"about the second webhook\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "id": "b93yey8BM_28W8MNazfdk",
          "language": "400",
          "code": "// Bad Request\n"
        },
        {
          "id": "WjG4ebAYN-L0qz1eznLIn",
          "language": "404",
          "code": "// Not Found\n"
        }
      ],
      "selectedLanguageId": "HBuHl9aisCebY-Ud8yB4P"
    }
  },
  "children": [
    {
      "text": ""
    }
  ]
}