---
updatedAt: 2026-05-27T17:24:02.000Z
agentTools:
  projectIndex: https://docs.getspot.com/llms.txt
---

# Fetch Webhook Configuration

Endpoint to fetch the registered webhook for a partner. For now, only a single configuration per partner is permitted.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "paths": {
    "/api/v2/enrollments/webhooks": {
      "get": {
        "operationId": "fetchWebhookConfiguration v2",
        "x-readme": {
          "code-samples": [
            {
              "language": "node",
              "code": "import { Spotsdk } from '@getspot/spot-sdk';\n\n(async () => {\n const spotsdk = new Spotsdk({\n    clientId: 'CLIENT_ID',\n    clientSecret: 'CLIENT_SECRET',\n    spotPartnerId: 'PARTNER_ID',\n  });\n\n  const { data } = await spotsdk.enrollments.fetchWebhookConfiguration();\n\n  console.log(data);\n})();",
              "install": "npm install @getspot/spot-sdk"
            }
          ]
        },
        "summary": "Fetch Webhook Configuration",
        "description": "Endpoint to fetch the registered webhook for a partner. For now, only a single configuration per partner is permitted.",
        "parameters": [
          {
            "name": "X-Spot-Partner-Id",
            "in": "header",
            "description": "Spot Provided ID for Partner",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The currently configured webhook configuration for the authorized partner.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/PartnerWebhookConfigurationDto"
                  }
                }
              }
            }
          },
          "401": {
            "description": "You do not have access to webhook configuration."
          },
          "429": {
            "description": "A rate limit is in effect. Inspect the Retry-After header."
          }
        },
        "security": [
          {
            "oauth2": []
          },
          {
            "bearer": []
          }
        ],
        "tags": [
          "Webhooks"
        ]
      }
    }
  },
  "info": {
    "title": "Spot Enrollments API",
    "description": "Spot Platform API",
    "version": "3.x",
    "contact": {}
  },
  "servers": [
    {
      "url": "https://api.sandbox.getspot.com",
      "description": "Sandbox Enrollments API"
    }
  ],
  "components": {
    "securitySchemes": {
      "bearer": {
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "type": "http"
      }
    },
    "schemas": {
      "PartnerWebhookConfigurationDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The public id of this webhook configuration",
            "example": "8ab0a49f-30e9-4578-a1df-4423736911e7"
          },
          "url": {
            "type": "string",
            "description": "The URL from the partner where enrollment\nwebhook events will be sent."
          }
        },
        "required": [
          "id",
          "url"
        ]
      }
    }
  }
}
```