{
"error": {
"code": "validation.failed",
"message": "The request failed schema validation. See `error.details` for per-field issues.",
"request_id": "req_8e1a7f50-90ab-4cde-f012-3456789abcde",
"doc_url": "https://docs.endstate.io/errors/validation-failed"
}
}
{
"error": {
"code": "auth.unauthorized",
"message": "Credential is missing or malformed.",
"request_id": "req_8e1a7f50-90ab-4cde-f012-3456789abcde",
"doc_url": "https://docs.endstate.io/errors/auth-unauthorized"
}
}
{
"error": {
"code": "auth.forbidden",
"message": "Credential is valid but does not have access to the requested resource or action.",
"request_id": "req_8e1a7f50-90ab-4cde-f012-3456789abcde",
"doc_url": "https://docs.endstate.io/errors/auth-forbidden"
}
}
{
"error": {
"code": "webhook_event.not_found",
"message": "The webhook event does not exist in your organization.",
"request_id": "req_8e1a7f50-90ab-4cde-f012-3456789abcde",
"doc_url": "https://docs.endstate.io/errors/webhook-event-not-found"
}
}
{
"error": {
"code": "internal.error",
"message": "An unexpected server error occurred. Retry with exponential backoff and include `request_id` in any support request.",
"request_id": "req_8e1a7f50-90ab-4cde-f012-3456789abcde",
"doc_url": "https://docs.endstate.io/errors/internal-error"
}
}
Webhooks
Fetch a webhook event
Returns one event as it was written, at the payload version it was written in, with its data payload. List rows omit the payload.
{
"error": {
"code": "validation.failed",
"message": "The request failed schema validation. See `error.details` for per-field issues.",
"request_id": "req_8e1a7f50-90ab-4cde-f012-3456789abcde",
"doc_url": "https://docs.endstate.io/errors/validation-failed"
}
}
{
"error": {
"code": "auth.unauthorized",
"message": "Credential is missing or malformed.",
"request_id": "req_8e1a7f50-90ab-4cde-f012-3456789abcde",
"doc_url": "https://docs.endstate.io/errors/auth-unauthorized"
}
}
{
"error": {
"code": "auth.forbidden",
"message": "Credential is valid but does not have access to the requested resource or action.",
"request_id": "req_8e1a7f50-90ab-4cde-f012-3456789abcde",
"doc_url": "https://docs.endstate.io/errors/auth-forbidden"
}
}
{
"error": {
"code": "webhook_event.not_found",
"message": "The webhook event does not exist in your organization.",
"request_id": "req_8e1a7f50-90ab-4cde-f012-3456789abcde",
"doc_url": "https://docs.endstate.io/errors/webhook-event-not-found"
}
}
{
"error": {
"code": "internal.error",
"message": "An unexpected server error occurred. Retry with exponential backoff and include `request_id` in any support request.",
"request_id": "req_8e1a7f50-90ab-4cde-f012-3456789abcde",
"doc_url": "https://docs.endstate.io/errors/internal-error"
}
}
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Endstate API","colors":{"primary":"#0D9373","light":"#07C983","dark":"#0D9373"},"logo":{"light":"https://mintcdn.com/endstate/7r-sSPorwOnbb4QJ/logo/light.png?fit=max\u0026auto=format\u0026n=7r-sSPorwOnbb4QJ\u0026q=85\u0026s=565266775e787378280a8d9fc438da1c","dark":"https://mintcdn.com/endstate/7r-sSPorwOnbb4QJ/logo/dark.png?fit=max\u0026auto=format\u0026n=7r-sSPorwOnbb4QJ\u0026q=85\u0026s=05c5d28cb884129713cb966e0773b3f9"},"favicon":"https://mintcdn.com/endstate/-o0caas8YOAvZHeK/favicon.png?fit=max\u0026auto=format\u0026n=-o0caas8YOAvZHeK\u0026q=85\u0026s=63980c55cef5eefd51957777c8cb7630","icons":{"library":"lucide"},"contextual":{"options":["copy","view","claude","chatgpt","mcp"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"endstate","hasAudioNarration":false,"actualSubdomain":"endstate","customDomains":["docs.endstate.io"],"gitSource":{"type":"github","owner":"end-state","repo":"endstate","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"collectionId":"0aefdd91-a1d0-4b8c-9237-466bf41d9069","liveDeploymentHistoryId":"6ae146c04e6f686841d5b0ab","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae146c04e6f686841d5b0ab"},"feedback":{"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae1b3b7b8d58072c0207180","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"default","tag":"SDKs","count":144},{"language":"default","tag":"Reference","count":129},{"language":"default","tag":"Core SDK","count":82},{"language":"default","tag":"API Reference","count":49},{"language":"default","tag":"Endpoints","count":48},{"language":"default","tag":"Reader SDK","count":31},{"language":"default","tag":"Web SDK","count":30},{"language":"default","tag":"Documentation","count":24},{"language":"default","tag":"Webhooks","count":17},{"language":"default","tag":"Session","count":13}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/webhooks/fetch-a-webhook-event","slug":"/api-reference/webhooks/fetch-a-webhook-event","pageMetadata":{"title":"Fetch a webhook event","description":"Returns one event as it was written, at the payload version it was written in, with its `data` payload. List rows omit the payload.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/webhooks/events/{event_id}","href":"/api-reference/webhooks/fetch-a-webhook-event","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Returns one event as it was written, at the payload version it was written in, with its \", _jsx(_components.code, {\n children: \"data\"\n }), \" payload. List rows omit the payload.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Fetch a webhook event","description":"Returns one event as it was written, at the payload version it was written in, with its `data` payload. List rows omit the payload.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/webhooks/events/{event_id}","href":"/api-reference/webhooks/fetch-a-webhook-event","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"getWebhookEvent","summary":"Fetch a webhook event","description":"Returns one event as it was written, at the payload version it was written in, with its `data` payload. List rows omit the payload.","tags":["Webhooks"],"security":["84d98209-2a75-4088-a604-4b3939f7409f"],"parameters":["6f4710d6-b90e-431e-9f39-976de1fd3ff8"],"responses":{"200":"cd899ec6-5164-4164-a8e0-6149764a1627","400":"2da367de-4d0a-4130-a7aa-062e4e73537f","401":"e6baa7a6-c340-49f4-9b17-2f5d234485b8","403":"160ef396-02f3-48d4-82de-7c67d0deb799","404":"4fa37e7f-d8b8-47bd-9f98-13a4ecccdbcd","500":"29bb763c-80c1-4540-91c0-09f63c0f095d"},"method":"get","type":"path","servers":["50b89c0d-b575-4dba-8f38-0083ece47f3a","37acff5c-c235-465a-ae2e-54702160b9af"],"path":"/v1/webhooks/events/{event_id}","baseUrlOptions":["https://api2.endstate.io","https://api-staging.endstate.io"],"title":"Fetch a webhook event","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"6f4710d6-b90e-431e-9f39-976de1fd3ff8":{"schema":{"type":"string","format":"uuid","example":"3f1c9a2b-7d4e-4f10-9a8b-2c6d5e4f3a21","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"},"required":true,"name":"event_id","in":"path"}},"responses":{"cd899ec6-5164-4164-a8e0-6149764a1627":{"description":"The event with its payload.","content":{"application/json":{"schema":{"type":"object","required":["data","id","type","audience","api_version","resource","created_at"],"properties":{"id":{"type":"string","format":"uuid","description":"Event id; also the `webhook-id` header on every delivery.","example":"3f1c9a2b-7d4e-4f10-9a8b-2c6d5e4f3a21","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"type":{"type":"string","example":"example.updated","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"audience":{"type":"string","description":"Which view of the resource the payload carries.","example":"brand","isRequired":true,"uniqueKey":"audience","typeLabel":"string"},"api_version":{"type":"string","example":"2026-09-01","isRequired":true,"uniqueKey":"api_version","typeLabel":"string"},"resource":{"type":"object","properties":{"type":{"type":"string","example":"warranty","isRequired":true,"uniqueKey":"resource.type","typeLabel":"string"},"id":{"type":"string","example":"6b1e2a3c-4d5e-4f60-8172-839405162738","isRequired":true,"uniqueKey":"resource.id","typeLabel":"string"},"revision":{"type":"integer","example":1,"isRequired":true,"uniqueKey":"resource.revision","typeLabel":"integer"}},"required":["type","id","revision"],"isRequired":true,"uniqueKey":"resource","typeLabel":"object"},"created_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"data":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"data.additionalProperties","typeLabel":"any"},"description":"The payload as it was written, at `api_version`; the `data` member of every delivery of this event.","example":{"example_id":"6b1e2a3c-4d5e-4f60-8172-839405162738","status":"updated"},"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"id":"3f1c9a2b-7d4e-4f10-9a8b-2c6d5e4f3a21","type":"example.updated","audience":"brand","api_version":"2026-09-01","resource":{"type":"example","id":"6b1e2a3c-4d5e-4f60-8172-839405162738","revision":1},"created_at":"2026-09-22T12:00:00.000Z","data":{"example_id":"6b1e2a3c-4d5e-4f60-8172-839405162738","status":"updated"}},"examples":{"Example":{"title":"Example","value":{"id":"3f1c9a2b-7d4e-4f10-9a8b-2c6d5e4f3a21","type":"example.updated","audience":"brand","api_version":"2026-09-01","resource":{"type":"example","id":"6b1e2a3c-4d5e-4f60-8172-839405162738","revision":1},"created_at":"2026-09-22T12:00:00.000Z","data":{"example_id":"6b1e2a3c-4d5e-4f60-8172-839405162738","status":"updated"}}}},"exampleType":"examples"}},"exampleType":"examples"},"2da367de-4d0a-4130-a7aa-062e4e73537f":{"description":"The request was malformed or failed validation.\n\n| Error code | When |\n| --- | --- |\n| `validation.failed` | The request failed schema validation. See `error.details` for per-field issues. |","x-error-codes":["validation.failed"],"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"oneOf":[{"type":"string","description":"Stable, namespaced error code. The `ErrorCode` catalogue lists every code defined today; handle an unrecognized value as a generic failure rather than throwing, since codes are added over time.","enum":["environment.conflict","environment.invalid_configuration","organization.changed","validation.failed","auth.unauthorized","auth.forbidden","session_token.invalid_or_expired","session_token.wrong_chip","wallet_session.invalid_or_expired","not_found.resource","rate_limit.exceeded","chip.not_found","chip.invalid_e_value","chip.already_scanned","quota.exceeded","chip.not_a_test_chip","unit.not_found","unit.already_exists","unit.not_minted","collection.not_found","collection.already_exists","collection.not_active","collection_backfill.blocked","organization.not_found","chip.already_paired","chip.key_unusable","chip.mac_required","chip.bulk_mixed_collections","chip.bulk_pending","unit.issuance_pending","claim.owner_unknown","claim.already_to_recipient","claim.in_progress","claim.not_found","chip_replacement.locked","chip_replacement.in_progress","chip_replacement.not_found","transfer.owner_unknown","transfer.already_to_recipient","transfer.in_progress","transfer.not_found","submission.not_executable","vault.not_found","vault.already_exists","vault.provisioning_failed","vault.not_permitted","vault.unavailable","vault.challenge_invalid","vault.address_in_use","vault.key_conflict","vault.signer_unauthorized","vault_connection.not_found","vault_connection.not_active","vault_connection.already_exists","vault_connection.conflict","idempotency.key_conflict","idempotency.in_progress","internal.error","webhook_endpoint.not_found","webhook_endpoint.deleted","webhook_endpoint.limit_reached","webhook_endpoint.url_refused","webhook_endpoint.signing_unavailable","webhook_event_type.unknown","webhook_event.not_found","webhook_endpoint.disabled","webhook_delivery.in_progress","webhook_endpoint.not_subscribed"],"example":"chip.not_found","isRequired":true,"uniqueKey":"error.code.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"string","description":"Stable, namespaced error code. The `ErrorCode` catalogue lists every code defined today; handle an unrecognized value as a generic failure rather than throwing, since codes are added over time.","example":"chip.not_found","isRequired":true,"uniqueKey":"error.code.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring> | string"},"message":{"type":"string","description":"Human-readable description, for logs and debugging. Wording may change without notice - never parse or match against it.","example":"Chip not found","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Identifier for this request, matching the `X-Request-Id` response header. Log it and include it in any support request.","example":"req_8e1a7f50-90ab-4cde-f012-3456789abcde","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"doc_url":{"type":"string","description":"Documentation page for this error code.","example":"https://docs.endstate.io/errors/chip-not-found","isRequired":true,"uniqueKey":"error.doc_url","typeLabel":"string"},"details":{"type":"object","properties":{"formErrors":{"type":"array","items":{"type":"string","uniqueKey":"error.details.formErrors.items.[INDEX]","typeLabel":"string"},"description":"Issues that apply to the request as a whole rather than one field.","example":[],"isRequired":true,"uniqueKey":"error.details.formErrors","typeLabel":"string[]"},"fieldErrors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"error.details.fieldErrors.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"error.details.fieldErrors.additionalProperties","typeLabel":"string[]"},"description":"Validation issues keyed by the field that failed.","example":{"name":["Required"]},"isRequired":true,"uniqueKey":"error.details.fieldErrors","typeLabel":"object"}},"required":["formErrors","fieldErrors"],"description":"Per-field validation detail. Present only on `validation.failed`.","uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message","request_id","doc_url"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"description":"Every error response, regardless of endpoint or HTTP status, uses this envelope.","uniqueKey":"","typeLabel":"object"},"examples":{"validation.failed":{"title":"validation.failed","value":{"error":{"code":"validation.failed","message":"The request failed schema validation. See `error.details` for per-field issues.","request_id":"req_8e1a7f50-90ab-4cde-f012-3456789abcde","doc_url":"https://docs.endstate.io/errors/validation-failed"}}}},"exampleType":"examples"}},"exampleType":"examples"},"e6baa7a6-c340-49f4-9b17-2f5d234485b8":{"description":"Authentication failed.\n\n| Error code | When |\n| --- | --- |\n| `auth.unauthorized` | Credential is missing or malformed. |","x-error-codes":["auth.unauthorized"],"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"oneOf":[{"type":"string","description":"Stable, namespaced error code. The `ErrorCode` catalogue lists every code defined today; handle an unrecognized value as a generic failure rather than throwing, since codes are added over time.","enum":["environment.conflict","environment.invalid_configuration","organization.changed","validation.failed","auth.unauthorized","auth.forbidden","session_token.invalid_or_expired","session_token.wrong_chip","wallet_session.invalid_or_expired","not_found.resource","rate_limit.exceeded","chip.not_found","chip.invalid_e_value","chip.already_scanned","quota.exceeded","chip.not_a_test_chip","unit.not_found","unit.already_exists","unit.not_minted","collection.not_found","collection.already_exists","collection.not_active","collection_backfill.blocked","organization.not_found","chip.already_paired","chip.key_unusable","chip.mac_required","chip.bulk_mixed_collections","chip.bulk_pending","unit.issuance_pending","claim.owner_unknown","claim.already_to_recipient","claim.in_progress","claim.not_found","chip_replacement.locked","chip_replacement.in_progress","chip_replacement.not_found","transfer.owner_unknown","transfer.already_to_recipient","transfer.in_progress","transfer.not_found","submission.not_executable","vault.not_found","vault.already_exists","vault.provisioning_failed","vault.not_permitted","vault.unavailable","vault.challenge_invalid","vault.address_in_use","vault.key_conflict","vault.signer_unauthorized","vault_connection.not_found","vault_connection.not_active","vault_connection.already_exists","vault_connection.conflict","idempotency.key_conflict","idempotency.in_progress","internal.error","webhook_endpoint.not_found","webhook_endpoint.deleted","webhook_endpoint.limit_reached","webhook_endpoint.url_refused","webhook_endpoint.signing_unavailable","webhook_event_type.unknown","webhook_event.not_found","webhook_endpoint.disabled","webhook_delivery.in_progress","webhook_endpoint.not_subscribed"],"example":"chip.not_found","isRequired":true,"uniqueKey":"error.code.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"string","description":"Stable, namespaced error code. The `ErrorCode` catalogue lists every code defined today; handle an unrecognized value as a generic failure rather than throwing, since codes are added over time.","example":"chip.not_found","isRequired":true,"uniqueKey":"error.code.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring> | string"},"message":{"type":"string","description":"Human-readable description, for logs and debugging. Wording may change without notice - never parse or match against it.","example":"Chip not found","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Identifier for this request, matching the `X-Request-Id` response header. Log it and include it in any support request.","example":"req_8e1a7f50-90ab-4cde-f012-3456789abcde","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"doc_url":{"type":"string","description":"Documentation page for this error code.","example":"https://docs.endstate.io/errors/chip-not-found","isRequired":true,"uniqueKey":"error.doc_url","typeLabel":"string"},"details":{"type":"object","properties":{"formErrors":{"type":"array","items":{"type":"string","uniqueKey":"error.details.formErrors.items.[INDEX]","typeLabel":"string"},"description":"Issues that apply to the request as a whole rather than one field.","example":[],"isRequired":true,"uniqueKey":"error.details.formErrors","typeLabel":"string[]"},"fieldErrors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"error.details.fieldErrors.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"error.details.fieldErrors.additionalProperties","typeLabel":"string[]"},"description":"Validation issues keyed by the field that failed.","example":{"name":["Required"]},"isRequired":true,"uniqueKey":"error.details.fieldErrors","typeLabel":"object"}},"required":["formErrors","fieldErrors"],"description":"Per-field validation detail. Present only on `validation.failed`.","uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message","request_id","doc_url"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"description":"Every error response, regardless of endpoint or HTTP status, uses this envelope.","uniqueKey":"","typeLabel":"object"},"examples":{"auth.unauthorized":{"title":"auth.unauthorized","value":{"error":{"code":"auth.unauthorized","message":"Credential is missing or malformed.","request_id":"req_8e1a7f50-90ab-4cde-f012-3456789abcde","doc_url":"https://docs.endstate.io/errors/auth-unauthorized"}}}},"exampleType":"examples"}},"exampleType":"examples"},"160ef396-02f3-48d4-82de-7c67d0deb799":{"description":"Authenticated, but not permitted.\n\n| Error code | When |\n| --- | --- |\n| `auth.forbidden` | Credential is valid but does not have access to the requested resource or action. |","x-error-codes":["auth.forbidden"],"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"oneOf":[{"type":"string","description":"Stable, namespaced error code. The `ErrorCode` catalogue lists every code defined today; handle an unrecognized value as a generic failure rather than throwing, since codes are added over time.","enum":["environment.conflict","environment.invalid_configuration","organization.changed","validation.failed","auth.unauthorized","auth.forbidden","session_token.invalid_or_expired","session_token.wrong_chip","wallet_session.invalid_or_expired","not_found.resource","rate_limit.exceeded","chip.not_found","chip.invalid_e_value","chip.already_scanned","quota.exceeded","chip.not_a_test_chip","unit.not_found","unit.already_exists","unit.not_minted","collection.not_found","collection.already_exists","collection.not_active","collection_backfill.blocked","organization.not_found","chip.already_paired","chip.key_unusable","chip.mac_required","chip.bulk_mixed_collections","chip.bulk_pending","unit.issuance_pending","claim.owner_unknown","claim.already_to_recipient","claim.in_progress","claim.not_found","chip_replacement.locked","chip_replacement.in_progress","chip_replacement.not_found","transfer.owner_unknown","transfer.already_to_recipient","transfer.in_progress","transfer.not_found","submission.not_executable","vault.not_found","vault.already_exists","vault.provisioning_failed","vault.not_permitted","vault.unavailable","vault.challenge_invalid","vault.address_in_use","vault.key_conflict","vault.signer_unauthorized","vault_connection.not_found","vault_connection.not_active","vault_connection.already_exists","vault_connection.conflict","idempotency.key_conflict","idempotency.in_progress","internal.error","webhook_endpoint.not_found","webhook_endpoint.deleted","webhook_endpoint.limit_reached","webhook_endpoint.url_refused","webhook_endpoint.signing_unavailable","webhook_event_type.unknown","webhook_event.not_found","webhook_endpoint.disabled","webhook_delivery.in_progress","webhook_endpoint.not_subscribed"],"example":"chip.not_found","isRequired":true,"uniqueKey":"error.code.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"string","description":"Stable, namespaced error code. The `ErrorCode` catalogue lists every code defined today; handle an unrecognized value as a generic failure rather than throwing, since codes are added over time.","example":"chip.not_found","isRequired":true,"uniqueKey":"error.code.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring> | string"},"message":{"type":"string","description":"Human-readable description, for logs and debugging. Wording may change without notice - never parse or match against it.","example":"Chip not found","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Identifier for this request, matching the `X-Request-Id` response header. Log it and include it in any support request.","example":"req_8e1a7f50-90ab-4cde-f012-3456789abcde","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"doc_url":{"type":"string","description":"Documentation page for this error code.","example":"https://docs.endstate.io/errors/chip-not-found","isRequired":true,"uniqueKey":"error.doc_url","typeLabel":"string"},"details":{"type":"object","properties":{"formErrors":{"type":"array","items":{"type":"string","uniqueKey":"error.details.formErrors.items.[INDEX]","typeLabel":"string"},"description":"Issues that apply to the request as a whole rather than one field.","example":[],"isRequired":true,"uniqueKey":"error.details.formErrors","typeLabel":"string[]"},"fieldErrors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"error.details.fieldErrors.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"error.details.fieldErrors.additionalProperties","typeLabel":"string[]"},"description":"Validation issues keyed by the field that failed.","example":{"name":["Required"]},"isRequired":true,"uniqueKey":"error.details.fieldErrors","typeLabel":"object"}},"required":["formErrors","fieldErrors"],"description":"Per-field validation detail. Present only on `validation.failed`.","uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message","request_id","doc_url"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"description":"Every error response, regardless of endpoint or HTTP status, uses this envelope.","uniqueKey":"","typeLabel":"object"},"examples":{"auth.forbidden":{"title":"auth.forbidden","value":{"error":{"code":"auth.forbidden","message":"Credential is valid but does not have access to the requested resource or action.","request_id":"req_8e1a7f50-90ab-4cde-f012-3456789abcde","doc_url":"https://docs.endstate.io/errors/auth-forbidden"}}}},"exampleType":"examples"}},"exampleType":"examples"},"4fa37e7f-d8b8-47bd-9f98-13a4ecccdbcd":{"description":"The resource does not exist within your organization.\n\n| Error code | When |\n| --- | --- |\n| `webhook_event.not_found` | The webhook event does not exist in your organization. |","x-error-codes":["webhook_event.not_found"],"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"oneOf":[{"type":"string","description":"Stable, namespaced error code. The `ErrorCode` catalogue lists every code defined today; handle an unrecognized value as a generic failure rather than throwing, since codes are added over time.","enum":["environment.conflict","environment.invalid_configuration","organization.changed","validation.failed","auth.unauthorized","auth.forbidden","session_token.invalid_or_expired","session_token.wrong_chip","wallet_session.invalid_or_expired","not_found.resource","rate_limit.exceeded","chip.not_found","chip.invalid_e_value","chip.already_scanned","quota.exceeded","chip.not_a_test_chip","unit.not_found","unit.already_exists","unit.not_minted","collection.not_found","collection.already_exists","collection.not_active","collection_backfill.blocked","organization.not_found","chip.already_paired","chip.key_unusable","chip.mac_required","chip.bulk_mixed_collections","chip.bulk_pending","unit.issuance_pending","claim.owner_unknown","claim.already_to_recipient","claim.in_progress","claim.not_found","chip_replacement.locked","chip_replacement.in_progress","chip_replacement.not_found","transfer.owner_unknown","transfer.already_to_recipient","transfer.in_progress","transfer.not_found","submission.not_executable","vault.not_found","vault.already_exists","vault.provisioning_failed","vault.not_permitted","vault.unavailable","vault.challenge_invalid","vault.address_in_use","vault.key_conflict","vault.signer_unauthorized","vault_connection.not_found","vault_connection.not_active","vault_connection.already_exists","vault_connection.conflict","idempotency.key_conflict","idempotency.in_progress","internal.error","webhook_endpoint.not_found","webhook_endpoint.deleted","webhook_endpoint.limit_reached","webhook_endpoint.url_refused","webhook_endpoint.signing_unavailable","webhook_event_type.unknown","webhook_event.not_found","webhook_endpoint.disabled","webhook_delivery.in_progress","webhook_endpoint.not_subscribed"],"example":"chip.not_found","isRequired":true,"uniqueKey":"error.code.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"string","description":"Stable, namespaced error code. The `ErrorCode` catalogue lists every code defined today; handle an unrecognized value as a generic failure rather than throwing, since codes are added over time.","example":"chip.not_found","isRequired":true,"uniqueKey":"error.code.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring> | string"},"message":{"type":"string","description":"Human-readable description, for logs and debugging. Wording may change without notice - never parse or match against it.","example":"Chip not found","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Identifier for this request, matching the `X-Request-Id` response header. Log it and include it in any support request.","example":"req_8e1a7f50-90ab-4cde-f012-3456789abcde","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"doc_url":{"type":"string","description":"Documentation page for this error code.","example":"https://docs.endstate.io/errors/chip-not-found","isRequired":true,"uniqueKey":"error.doc_url","typeLabel":"string"},"details":{"type":"object","properties":{"formErrors":{"type":"array","items":{"type":"string","uniqueKey":"error.details.formErrors.items.[INDEX]","typeLabel":"string"},"description":"Issues that apply to the request as a whole rather than one field.","example":[],"isRequired":true,"uniqueKey":"error.details.formErrors","typeLabel":"string[]"},"fieldErrors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"error.details.fieldErrors.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"error.details.fieldErrors.additionalProperties","typeLabel":"string[]"},"description":"Validation issues keyed by the field that failed.","example":{"name":["Required"]},"isRequired":true,"uniqueKey":"error.details.fieldErrors","typeLabel":"object"}},"required":["formErrors","fieldErrors"],"description":"Per-field validation detail. Present only on `validation.failed`.","uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message","request_id","doc_url"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"description":"Every error response, regardless of endpoint or HTTP status, uses this envelope.","uniqueKey":"","typeLabel":"object"},"examples":{"webhook_event.not_found":{"title":"webhook_event.not_found","value":{"error":{"code":"webhook_event.not_found","message":"The webhook event does not exist in your organization.","request_id":"req_8e1a7f50-90ab-4cde-f012-3456789abcde","doc_url":"https://docs.endstate.io/errors/webhook-event-not-found"}}}},"exampleType":"examples"}},"exampleType":"examples"},"29bb763c-80c1-4540-91c0-09f63c0f095d":{"description":"Something went wrong on our end.\n\n| Error code | When |\n| --- | --- |\n| `internal.error` | An unexpected server error occurred. Retry with exponential backoff and include `request_id` in any support request. |","x-error-codes":["internal.error"],"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"oneOf":[{"type":"string","description":"Stable, namespaced error code. The `ErrorCode` catalogue lists every code defined today; handle an unrecognized value as a generic failure rather than throwing, since codes are added over time.","enum":["environment.conflict","environment.invalid_configuration","organization.changed","validation.failed","auth.unauthorized","auth.forbidden","session_token.invalid_or_expired","session_token.wrong_chip","wallet_session.invalid_or_expired","not_found.resource","rate_limit.exceeded","chip.not_found","chip.invalid_e_value","chip.already_scanned","quota.exceeded","chip.not_a_test_chip","unit.not_found","unit.already_exists","unit.not_minted","collection.not_found","collection.already_exists","collection.not_active","collection_backfill.blocked","organization.not_found","chip.already_paired","chip.key_unusable","chip.mac_required","chip.bulk_mixed_collections","chip.bulk_pending","unit.issuance_pending","claim.owner_unknown","claim.already_to_recipient","claim.in_progress","claim.not_found","chip_replacement.locked","chip_replacement.in_progress","chip_replacement.not_found","transfer.owner_unknown","transfer.already_to_recipient","transfer.in_progress","transfer.not_found","submission.not_executable","vault.not_found","vault.already_exists","vault.provisioning_failed","vault.not_permitted","vault.unavailable","vault.challenge_invalid","vault.address_in_use","vault.key_conflict","vault.signer_unauthorized","vault_connection.not_found","vault_connection.not_active","vault_connection.already_exists","vault_connection.conflict","idempotency.key_conflict","idempotency.in_progress","internal.error","webhook_endpoint.not_found","webhook_endpoint.deleted","webhook_endpoint.limit_reached","webhook_endpoint.url_refused","webhook_endpoint.signing_unavailable","webhook_event_type.unknown","webhook_event.not_found","webhook_endpoint.disabled","webhook_delivery.in_progress","webhook_endpoint.not_subscribed"],"example":"chip.not_found","isRequired":true,"uniqueKey":"error.code.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"string","description":"Stable, namespaced error code. The `ErrorCode` catalogue lists every code defined today; handle an unrecognized value as a generic failure rather than throwing, since codes are added over time.","example":"chip.not_found","isRequired":true,"uniqueKey":"error.code.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring> | string"},"message":{"type":"string","description":"Human-readable description, for logs and debugging. Wording may change without notice - never parse or match against it.","example":"Chip not found","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Identifier for this request, matching the `X-Request-Id` response header. Log it and include it in any support request.","example":"req_8e1a7f50-90ab-4cde-f012-3456789abcde","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"doc_url":{"type":"string","description":"Documentation page for this error code.","example":"https://docs.endstate.io/errors/chip-not-found","isRequired":true,"uniqueKey":"error.doc_url","typeLabel":"string"},"details":{"type":"object","properties":{"formErrors":{"type":"array","items":{"type":"string","uniqueKey":"error.details.formErrors.items.[INDEX]","typeLabel":"string"},"description":"Issues that apply to the request as a whole rather than one field.","example":[],"isRequired":true,"uniqueKey":"error.details.formErrors","typeLabel":"string[]"},"fieldErrors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"error.details.fieldErrors.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"error.details.fieldErrors.additionalProperties","typeLabel":"string[]"},"description":"Validation issues keyed by the field that failed.","example":{"name":["Required"]},"isRequired":true,"uniqueKey":"error.details.fieldErrors","typeLabel":"object"}},"required":["formErrors","fieldErrors"],"description":"Per-field validation detail. Present only on `validation.failed`.","uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message","request_id","doc_url"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"description":"Every error response, regardless of endpoint or HTTP status, uses this envelope.","uniqueKey":"","typeLabel":"object"},"examples":{"internal.error":{"title":"internal.error","value":{"error":{"code":"internal.error","message":"An unexpected server error occurred. Retry with exponential backoff and include `request_id` in any support request.","request_id":"req_8e1a7f50-90ab-4cde-f012-3456789abcde","doc_url":"https://docs.endstate.io/errors/internal-error"}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"84d98209-2a75-4088-a604-4b3939f7409f":{"ApiKeyBearer":{"type":"http","scheme":"bearer","bearerFormat":"end_sk","description":"Use `Authorization: Bearer end_sk_*` for partner API keys (e.g. `end_sk_AbCd_example_api_key`).","scopes":[],"schemeName":"ApiKeyBearer"}}},"servers":{"50b89c0d-b575-4dba-8f38-0083ece47f3a":{"url":"https://api2.endstate.io","description":"Production"},"37acff5c-c235-465a-ae2e-54702160b9af":{"url":"https://api-staging.endstate.io","description":"Staging"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"end_sk","description":"Use `Authorization: Bearer end_sk_*` for partner API keys (e.g. `end_sk_AbCd_example_api_key`).","scopes":[],"schemeName":"ApiKeyBearer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Use `Authorization: Bearer end_sk_*` for partner API keys (e.g. `end_sk_AbCd_example_api_key`).","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"ApiKeyBearer","name":"Authorization"}],"title":"ApiKeyBearer"}]},"originalFileLocation":"openapi.json"},"subdomain":"endstate","siteName":"Endstate API","title":"Fetch a webhook event - Endstate API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-28T00:50:13.743Z","originalFileLocation":"api-reference/webhooks/fetch-a-webhook-event.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Returns one event as it was written, at the payload version it was written in, with its data payload. List rows omit the payload.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Endstate API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/endstate/BhrYECvbn-kli8W2/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/endstate/BhrYECvbn-kli8W2/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/endstate/BhrYECvbn-kli8W2/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/endstate/BhrYECvbn-kli8W2/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/endstate/BhrYECvbn-kli8W2/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/endstate/BhrYECvbn-kli8W2/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/endstate/BhrYECvbn-kli8W2/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/endstate/BhrYECvbn-kli8W2/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/endstate/BhrYECvbn-kli8W2/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Fetch a webhook event - Endstate API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns one event as it was written, at the payload version it was written in, with its data payload. List rows omit the payload.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Endstate API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.endstate.io/api-reference/webhooks/fetch-a-webhook-event\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://endstate.mintlify.app/_mintlify/api/og/v2?division=Webhooks\u0026amp;title=Fetch+a+webhook+event\u0026amp;description=Returns+one+event+as+it+was+written%2C+at+the+payload+version+it+was+written+in%2C+with+its+%60data%60+payload.+List+rows+omit+the+payload.\u0026amp;theme=95894d2e15e1795f3b1a5a6e\u0026amp;signature=b2dc546854386a08911bd540d96ea8344f87f8ed45db70a622337546aa9ac06a\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Fetch a webhook event - Endstate API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns one event as it was written, at the payload version it was written in, with its data payload. List rows omit the payload.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://endstate.mintlify.app/_mintlify/api/og/v2?division=Webhooks\u0026amp;title=Fetch+a+webhook+event\u0026amp;description=Returns+one+event+as+it+was+written%2C+at+the+payload+version+it+was+written+in%2C+with+its+%60data%60+payload.+List+rows+omit+the+payload.\u0026amp;theme=95894d2e15e1795f3b1a5a6e\u0026amp;signature=b2dc546854386a08911bd540d96ea8344f87f8ed45db70a622337546aa9ac06a\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/endstate/BhrYECvbn-kli8W2/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Endstate API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0D9373\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.endstate.io/api-reference/webhooks/fetch-a-webhook-event\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/webhooks/fetch-a-webhook-event.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.endstate.io/#organization\",\"name\":\"Endstate API\",\"url\":\"https://docs.endstate.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/endstate/7r-sSPorwOnbb4QJ/logo/light.png?fit=max\u0026auto=format\u0026n=7r-sSPorwOnbb4QJ\u0026q=85\u0026s=565266775e787378280a8d9fc438da1c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.endstate.io#website\",\"name\":\"Endstate API\",\"url\":\"https://docs.endstate.io\",\"publisher\":{\"@id\":\"https://docs.endstate.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.endstate.io/api-reference/webhooks/fetch-a-webhook-event#webpage\",\"url\":\"https://docs.endstate.io/api-reference/webhooks/fetch-a-webhook-event\",\"name\":\"Fetch a webhook event\",\"description\":\"Returns one event as it was written, at the payload version it was written in, with its data payload. List rows omit the payload.\",\"dateModified\":\"2026-10-28T00:50:13.743Z\",\"isPartOf\":{\"@id\":\"https://docs.endstate.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.endstate.io/api-reference/webhooks/fetch-a-webhook-event#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.endstate.io/api-reference/webhooks/fetch-a-webhook-event#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.endstate.io/api-reference/service/service-health-check\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Webhooks\",\"item\":\"https://docs.endstate.io/api-reference/webhooks/count-a-webhook-endpoints-deliveries-by-outcome\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Fetch a webhook event\",\"item\":\"https://docs.endstate.io/api-reference/webhooks/fetch-a-webhook-event\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.endstate.io/api-reference/webhooks/fetch-a-webhook-event#apireference\",\"headline\":\"Fetch a webhook event\",\"name\":\"Fetch a webhook event\",\"description\":\"Returns one event as it was written, at the payload version it was written in, with its data payload. List rows omit the payload.\",\"url\":\"https://docs.endstate.io/api-reference/webhooks/fetch-a-webhook-event\",\"mainEntityOfPage\":{\"@id\":\"https://docs.endstate.io/api-reference/webhooks/fetch-a-webhook-event#webpage\"},\"dateModified\":\"2026-10-28T00:50:13.743Z\",\"publisher\":{\"@id\":\"https://docs.endstate.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.endstate.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Endstate API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Endstate API","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/set-up-catalog"}]},{"tab":"SDKs","pages":[{"title":"SDKs","href":"/sdks/overview"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]},{"group":"Endpoints","pages":[{"group":"Service","pages":[{"title":"Service health check","deprecated":null,"version":null,"openapi":"/openapi.json get /health","href":"/api-reference/service/service-health-check"},{"title":"Service welcome","deprecated":null,"version":null,"openapi":"/openapi.json get /","href":"/api-reference/service/service-welcome"}]},{"group":"Chips","pages":[{"title":"Fetch a chip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/chips/{chip_id}","href":"/api-reference/chips/fetch-a-chip"},{"title":"Pair chips in bulk","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/chips/bulk","href":"/api-reference/chips/pair-chips-in-bulk"},{"title":"List chips","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/chips","href":"/api-reference/chips/list-chips"},{"title":"Pair a chip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/chips","href":"/api-reference/chips/pair-a-chip"},{"title":"Get a chip replacement","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/units/{unit_id}/chip-replacements/{replacement_id}","href":"/api-reference/chips/get-a-chip-replacement"},{"title":"Replace a unit's chip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/units/{unit_id}/chip-replacements","href":"/api-reference/chips/replace-a-units-chip"}]},{"group":"Collections","pages":[{"title":"Fetch a collection","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/collections/{collection_id}","href":"/api-reference/collections/fetch-a-collection"},{"title":"Update a collection","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/collections/{collection_id}","href":"/api-reference/collections/update-a-collection"},{"title":"List collections","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/collections","href":"/api-reference/collections/list-collections"},{"title":"Create a collection","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/collections","href":"/api-reference/collections/create-a-collection"}]},{"group":"Publishable keys","pages":[{"title":"List publishable keys","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/publishable-keys","href":"/api-reference/publishable-keys/list-publishable-keys"}]},{"group":"Session Tokens","pages":[{"title":"Introspect the bearer session token","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/session-tokens/current","href":"/api-reference/session-tokens/introspect-the-bearer-session-token"},{"title":"Revoke the bearer session token","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/session-tokens/current","href":"/api-reference/session-tokens/revoke-the-bearer-session-token"}]},{"group":"Settings","pages":[{"title":"Get external auth settings","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/settings/auth","href":"/api-reference/settings/get-external-auth-settings"},{"title":"Register your own token issuer","deprecated":null,"version":null,"openapi":"/openapi.json put /v1/settings/auth","href":"/api-reference/settings/register-your-own-token-issuer"},{"title":"Return to Endstate-managed identity","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/settings/auth","href":"/api-reference/settings/return-to-endstate-managed-identity"},{"title":"List CORS origins","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/settings/cors-origins","href":"/api-reference/settings/list-cors-origins"},{"title":"Replace CORS origins","deprecated":null,"version":null,"openapi":"/openapi.json put /v1/settings/cors-origins","href":"/api-reference/settings/replace-cors-origins"},{"title":"Get org settings","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/settings","href":"/api-reference/settings/get-org-settings"},{"title":"Update org settings","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/settings","href":"/api-reference/settings/update-org-settings"}]},{"group":"Taps","pages":[{"title":"List taps","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/taps","href":"/api-reference/taps/list-taps"},{"title":"Record a tap and issue a session token","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/taps","href":"/api-reference/taps/record-a-tap-and-issue-a-session-token"}]},{"group":"Test helpers","pages":[{"title":"Generate an e/c pair for a test chip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/test-helpers/taps","href":"/api-reference/test-helpers/generate-an-ec-pair-for-a-test-chip"}]},{"group":"Claims","pages":[{"title":"Get a claim","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/units/{unit_id}/claims/{claim_id}","href":"/api-reference/claims/get-a-claim"},{"title":"Claim a unit","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/units/{unit_id}/claims","href":"/api-reference/claims/claim-a-unit"}]},{"group":"Units","pages":[{"title":"Fetch a unit","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/units/{unit_id}","href":"/api-reference/units/fetch-a-unit"},{"title":"Update a unit","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/units/{unit_id}","href":"/api-reference/units/update-a-unit"},{"title":"List units","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/units","href":"/api-reference/units/list-units"},{"title":"Create a unit","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/units","href":"/api-reference/units/create-a-unit"}]},{"group":"Transfers","pages":[{"title":"Get a transfer","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/units/{unit_id}/transfers/{transfer_id}","href":"/api-reference/transfers/get-a-transfer"},{"title":"Transfer a unit","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/units/{unit_id}/transfers","href":"/api-reference/transfers/transfer-a-unit"}]},{"group":"Webhooks","pages":[{"title":"Count a webhook endpoint's deliveries by outcome","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/webhooks/endpoints/{endpoint_id}/health","href":"/api-reference/webhooks/count-a-webhook-endpoints-deliveries-by-outcome"},{"title":"Recover events a webhook endpoint missed","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/webhooks/endpoints/{endpoint_id}/recover","href":"/api-reference/webhooks/recover-events-a-webhook-endpoint-missed"},{"title":"Rotate a webhook endpoint's signing secret","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/webhooks/endpoints/{endpoint_id}/rotate-secret","href":"/api-reference/webhooks/rotate-a-webhook-endpoints-signing-secret"},{"title":"Fetch a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/webhooks/endpoints/{endpoint_id}","href":"/api-reference/webhooks/fetch-a-webhook-endpoint"},{"title":"Delete a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/webhooks/endpoints/{endpoint_id}","href":"/api-reference/webhooks/delete-a-webhook-endpoint"},{"title":"Update a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/webhooks/endpoints/{endpoint_id}","href":"/api-reference/webhooks/update-a-webhook-endpoint"},{"title":"Read a webhook endpoint's signing secret","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/webhooks/endpoints/{endpoint_id}/secret","href":"/api-reference/webhooks/read-a-webhook-endpoints-signing-secret"},{"title":"Send a test event to a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/webhooks/endpoints/{endpoint_id}/test","href":"/api-reference/webhooks/send-a-test-event-to-a-webhook-endpoint"},{"title":"List webhook endpoints","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/webhooks/endpoints","href":"/api-reference/webhooks/list-webhook-endpoints"},{"title":"Create a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/webhooks/endpoints","href":"/api-reference/webhooks/create-a-webhook-endpoint"},{"title":"List webhook event types","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/webhooks/event-types","href":"/api-reference/webhooks/list-webhook-event-types"},{"title":"List delivery attempts for a webhook event","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/webhooks/events/{event_id}/attempts","href":"/api-reference/webhooks/list-delivery-attempts-for-a-webhook-event"},{"title":"Deliver a webhook event to an endpoint again","description":"Sends the event to the given endpoint now. A retry that is scheduled for later is sent at once instead of waiting; otherwise one more attempt is created, for example after the retry schedule was exhausted. Refused while an attempt is being sent at this moment, and, when the event never reached the endpoint, unless the endpoint subscribes to its type.","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/webhooks/events/{event_id}/redeliver","href":"/api-reference/webhooks/deliver-a-webhook-event-to-an-endpoint-again"},{"title":"Fetch a webhook event","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/webhooks/events/{event_id}","href":"/api-reference/webhooks/fetch-a-webhook-event"},{"title":"List webhook events","description":"Returns a cursor-paginated list of events written for your organization, oldest first unless `order=desc`. Filter by `type`, by `endpoint_id` (events attempted to that endpoint, each carrying its latest `delivery` to it) by `resource_id`, or by a `since`/`until` window.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/webhooks/events","href":"/api-reference/webhooks/list-webhook-events"}]}]}]}]},"title":"Fetch a webhook event - Endstate API","buildId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","deploymentId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-26-lDe7V.js","utils-CWQmgYtH.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-4-Aw3rSD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C2zjXYA5.js","snippetPresets-DFmpFA7C.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-FJpQavWq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D_GvPF7k.js","shallow-Bs2ZB0NO.js","getApiPlaygroundDisplay-DCcqJJk-.js","CodeSnippet-DzDxawVe.js","CodeSnippets-aUr7fU-7.js","Page-CT9uE8Ip.js","getPastedJson-Y1fKsj_I.js","icon-DI4zTsDr.js","MethodPill-C0nDlmSQ.js","DuplicateIcon-NUXbx2nQ.js","createIcon-BdTHrPAi.js","DynamicMarkdown-CtpgKJwj.js","SectionHeading-B3x35tOt.js","axios-vUo_bRtp.js","Markdown-3OmurJMP.js","clsx-DMKzROTp.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-1ms6tsT-.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Ke9xIMFx.js"]}