{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Punch Rescue Developer portal","colors":{"primary":"#E1051E","light":"#E1051E","dark":"#E1051E"},"logo":"https://mintcdn.com/punchrescue/O2-yITAI4Lh3gsko/images/svgviewer-output.svg?fit=max\u0026auto=format\u0026n=O2-yITAI4Lh3gsko\u0026q=85\u0026s=0450206ce5ace91d28653dc827183bc4","favicon":"https://mintcdn.com/punchrescue/eXiAGYuzrlrOIu5A/images/cropped-Rescue-Logo-Icon-Favicon-32x32.png?fit=max\u0026auto=format\u0026n=eXiAGYuzrlrOIu5A\u0026q=85\u0026s=529865521acfd6706b9f0aca7bb9177e","api":{"openapi":"openapi.json"},"navbar":{"links":[{"href":"mailto:support@punchrescue.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://dashboard.mintlify.com"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/punch-rescue"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"punchrescue","hasAudioNarration":false,"actualSubdomain":"punchrescue","customDomains":["docs.punchrescue.com"],"gitSource":{"type":"github","owner":"mintlify-community","repo":"docs-punchrescue-48eaf8b8","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6abb956ac9f9b22ff3770563","clientVersion":"0.0.4076","searchFilterCounts":[{"language":"default","tag":"API reference","count":2},{"language":"default","tag":"API documentation","count":2},{"language":"default","tag":"MCP Server","count":1},{"language":"default","tag":"Overview","count":1}]},"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":"rbac-expansion","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":"full-page-search","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":"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":"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":"turbopuffer-dual-write","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},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/emergencies/get-an-emergency","slug":"/api-reference/emergencies/get-an-emergency","pageMetadata":{"title":"Get an emergency","description":"**Required permission:** `read`.","deprecated":null,"version":null,"openapi":"https://api.rescue-serverless.dev.back2back.team/api/public/v1/openapi.json get /orgs/{org_id}/emergencies/{emergency_id}","href":"/api-reference/emergencies/get-an-emergency","autogeneratedByOpenApi":true,"hidden":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 strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Required permission:\"\n }), \" \", _jsx(_components.code, {\n children: \"read\"\n }), \".\"]\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":"Get an emergency","description":"**Required permission:** `read`.","deprecated":null,"version":null,"openapi":"https://api.rescue-serverless.dev.back2back.team/api/public/v1/openapi.json get /orgs/{org_id}/emergencies/{emergency_id}","href":"/api-reference/emergencies/get-an-emergency","autogeneratedByOpenApi":true,"hidden":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Emergencies"],"summary":"Get an emergency","description":"**Required permission:** `read`.","operationId":"emergencies.get","parameters":["9fe19f69-a16e-4a7c-b248-597ca92233a1","cb49db4a-1334-45ed-971a-0b4411fc91c1"],"responses":{"200":"58429d8d-7cac-4a57-86b1-fff7a83cf8bc","422":"4216b2cf-cb34-4e27-b5a8-20c4a93c69cb"},"method":"get","type":"path","servers":["3029d8cd-4e5a-4715-849a-211bc3098e1d"],"security":["bb444628-4fb1-4a94-851f-a263e6f24212"],"path":"/orgs/{org_id}/emergencies/{emergency_id}","baseUrlOptions":["https://api.punchrescue.com/api/public/v1"],"title":"Get an emergency","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"9fe19f69-a16e-4a7c-b248-597ca92233a1":{"name":"org_id","in":"path","required":true,"schema":{"type":"string","description":"Target organization id (from the route path)","title":"Org Id","isRequired":true,"uniqueKey":"","typeLabel":"string"},"description":"Target organization id (from the route path)"},"cb49db4a-1334-45ed-971a-0b4411fc91c1":{"name":"emergency_id","in":"path","required":true,"schema":{"type":"string","description":"Emergency id","title":"Emergency Id","isRequired":true,"uniqueKey":"","typeLabel":"string"},"description":"Emergency id"}},"responses":{"58429d8d-7cac-4a57-86b1-fff7a83cf8bc":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"emergencyId":{"type":"string","title":"Emergencyid","isRequired":true,"uniqueKey":"emergencyId","typeLabel":"string"},"orgId":{"type":"string","title":"Orgid","isRequired":true,"uniqueKey":"orgId","typeLabel":"string"},"status":{"type":"string","title":"Status","isRequired":true,"uniqueKey":"status","typeLabel":"string"},"externalId":{"oneOf":[{"type":"string","title":"Externalid","uniqueKey":"externalId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Externalid","uniqueKey":"externalId.oneOf.1","typeLabel":"null"}],"uniqueKey":"externalId","typeLabel":"string | null"},"category":{"oneOf":[{"type":"object","title":"PublicCategoryRef","description":"Minimal category info embedded on emergencies + webhook payloads.","required":["id","name"],"properties":{"id":{"type":"string","title":"Id","isRequired":true,"uniqueKey":"category.oneOf.0.id","typeLabel":"string"},"name":{"type":"string","title":"Name","isRequired":true,"uniqueKey":"category.oneOf.0.name","typeLabel":"string"},"color":{"oneOf":[{"type":"string","title":"Color","uniqueKey":"category.oneOf.0.color.oneOf.0","typeLabel":"string"},{"type":"null","title":"Color","uniqueKey":"category.oneOf.0.color.oneOf.1","typeLabel":"null"}],"uniqueKey":"category.oneOf.0.color","typeLabel":"string | null"},"severity":{"oneOf":[{"type":"integer","title":"Severity","uniqueKey":"category.oneOf.0.severity.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Severity","uniqueKey":"category.oneOf.0.severity.oneOf.1","typeLabel":"null"}],"uniqueKey":"category.oneOf.0.severity","typeLabel":"integer | null"}},"uniqueKey":"category.oneOf.0","typeLabel":"PublicCategoryRef · object"},{"type":"null","uniqueKey":"category.oneOf.1","typeLabel":"null"}],"uniqueKey":"category","typeLabel":"PublicCategoryRef · object | null"},"source":{"oneOf":[{"type":"string","title":"Source","uniqueKey":"source.oneOf.0","typeLabel":"string"},{"type":"null","title":"Source","uniqueKey":"source.oneOf.1","typeLabel":"null"}],"uniqueKey":"source","typeLabel":"string | null"},"description":{"oneOf":[{"type":"string","title":"Description","uniqueKey":"description.oneOf.0","typeLabel":"string"},{"type":"null","title":"Description","uniqueKey":"description.oneOf.1","typeLabel":"null"}],"uniqueKey":"description","typeLabel":"string | null"},"occurredAt":{"oneOf":[{"type":"string","title":"Occurredat","uniqueKey":"occurredAt.oneOf.0","typeLabel":"string"},{"type":"null","title":"Occurredat","uniqueKey":"occurredAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"occurredAt","typeLabel":"string | null"},"createdAt":{"oneOf":[{"type":"string","title":"Createdat","uniqueKey":"createdAt.oneOf.0","typeLabel":"string"},{"type":"null","title":"Createdat","uniqueKey":"createdAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"createdAt","typeLabel":"string | null"},"resolvedAt":{"oneOf":[{"type":"string","title":"Resolvedat","uniqueKey":"resolvedAt.oneOf.0","typeLabel":"string"},{"type":"null","title":"Resolvedat","uniqueKey":"resolvedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"resolvedAt","typeLabel":"string | null"},"resolvedBy":{"oneOf":[{"type":"object","title":"PublicActorRef","description":"Unified actor shape (declaredBy / resolvedBy) for both user and api_key attribution.","required":["type","id"],"properties":{"type":{"type":"string","title":"Type","description":"user | api_key | system","isRequired":true,"uniqueKey":"resolvedBy.oneOf.0.type","typeLabel":"string"},"id":{"type":"string","title":"Id","isRequired":true,"uniqueKey":"resolvedBy.oneOf.0.id","typeLabel":"string"},"name":{"oneOf":[{"type":"string","title":"Name","uniqueKey":"resolvedBy.oneOf.0.name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Name","uniqueKey":"resolvedBy.oneOf.0.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"resolvedBy.oneOf.0.name","typeLabel":"string | null"}},"uniqueKey":"resolvedBy.oneOf.0","typeLabel":"PublicActorRef · object"},{"type":"null","uniqueKey":"resolvedBy.oneOf.1","typeLabel":"null"}],"uniqueKey":"resolvedBy","typeLabel":"PublicActorRef · object | null"},"declaredBy":{"oneOf":[{"type":"object","title":"PublicActorRef","description":"Unified actor shape (declaredBy / resolvedBy) for both user and api_key attribution.","required":["type","id"],"properties":{"type":{"type":"string","title":"Type","description":"user | api_key | system","isRequired":true,"uniqueKey":"declaredBy.oneOf.0.type","typeLabel":"string"},"id":{"type":"string","title":"Id","isRequired":true,"uniqueKey":"declaredBy.oneOf.0.id","typeLabel":"string"},"name":{"oneOf":[{"type":"string","title":"Name","uniqueKey":"declaredBy.oneOf.0.name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Name","uniqueKey":"declaredBy.oneOf.0.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"declaredBy.oneOf.0.name","typeLabel":"string | null"}},"uniqueKey":"declaredBy.oneOf.0","typeLabel":"PublicActorRef · object"},{"type":"null","uniqueKey":"declaredBy.oneOf.1","typeLabel":"null"}],"uniqueKey":"declaredBy","typeLabel":"PublicActorRef · object | null"},"location":{"oneOf":[{"type":"object","title":"PublicLocation","properties":{"latitude":{"oneOf":[{"type":"number","title":"Latitude","uniqueKey":"location.oneOf.0.latitude.oneOf.0","typeLabel":"number"},{"type":"null","title":"Latitude","uniqueKey":"location.oneOf.0.latitude.oneOf.1","typeLabel":"null"}],"uniqueKey":"location.oneOf.0.latitude","typeLabel":"number | null"},"longitude":{"oneOf":[{"type":"number","title":"Longitude","uniqueKey":"location.oneOf.0.longitude.oneOf.0","typeLabel":"number"},{"type":"null","title":"Longitude","uniqueKey":"location.oneOf.0.longitude.oneOf.1","typeLabel":"null"}],"uniqueKey":"location.oneOf.0.longitude","typeLabel":"number | null"},"floorId":{"oneOf":[{"type":"string","title":"Floorid","uniqueKey":"location.oneOf.0.floorId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Floorid","uniqueKey":"location.oneOf.0.floorId.oneOf.1","typeLabel":"null"}],"uniqueKey":"location.oneOf.0.floorId","typeLabel":"string | null"}},"uniqueKey":"location.oneOf.0","typeLabel":"PublicLocation · object"},{"type":"null","uniqueKey":"location.oneOf.1","typeLabel":"null"}],"uniqueKey":"location","typeLabel":"PublicLocation · object | null"},"resolutionNote":{"oneOf":[{"type":"string","title":"Resolutionnote","uniqueKey":"resolutionNote.oneOf.0","typeLabel":"string"},{"type":"null","title":"Resolutionnote","uniqueKey":"resolutionNote.oneOf.1","typeLabel":"null"}],"uniqueKey":"resolutionNote","typeLabel":"string | null"},"metadata":{"oneOf":[{"type":"object","title":"Metadata","additionalProperties":true,"uniqueKey":"metadata.oneOf.0","typeLabel":"Metadata · object"},{"type":"null","title":"Metadata","uniqueKey":"metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"metadata","typeLabel":"Metadata · object | null"}},"type":"object","required":["emergencyId","orgId","status"],"title":"PublicEmergencyResponse","uniqueKey":"","typeLabel":"PublicEmergencyResponse · object"},"examples":{"Example":{"title":"Example","value":{"emergencyId":"\u003cstring>","orgId":"\u003cstring>","status":"\u003cstring>","externalId":"\u003cstring>","category":{"id":"\u003cstring>","name":"\u003cstring>","color":"\u003cstring>","severity":123},"source":"\u003cstring>","description":"\u003cstring>","occurredAt":"\u003cstring>","createdAt":"\u003cstring>","resolvedAt":"\u003cstring>","resolvedBy":{"type":"\u003cstring>","id":"\u003cstring>","name":"\u003cstring>"},"declaredBy":{"type":"\u003cstring>","id":"\u003cstring>","name":"\u003cstring>"},"location":{"latitude":123,"longitude":123,"floorId":"\u003cstring>"},"resolutionNote":"\u003cstring>","metadata":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"4216b2cf-cb34-4e27-b5a8-20c4a93c69cb":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Location","isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Error Type","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError","uniqueKey":"detail.items.[INDEX]","typeLabel":"ValidationError · object"},"type":"array","title":"Detail","uniqueKey":"detail","typeLabel":"ValidationError · object[]"}},"type":"object","title":"HTTPValidationError","uniqueKey":"","typeLabel":"HTTPValidationError · object"},"examples":{"Example":{"title":"Example","value":{"detail":[{"loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"bb444628-4fb1-4a94-851f-a263e6f24212":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"rk_live_\u003c8hex>\u003c64hex>","scopes":[]}}},"servers":{"3029d8cd-4e5a-4715-849a-211bc3098e1d":{"url":"https://api.punchrescue.com/api/public/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"rk_live_\u003c8hex>\u003c64hex>","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"https://api.rescue-serverless.dev.back2back.team/api/public/v1/openapi.json"},"subdomain":"punchrescue","siteName":"Punch Rescue Developer portal","title":"Get an emergency - Punch Rescue Developer portal","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-29T10:39:44.775Z","originalFileLocation":"api-reference/emergencies/get-an-emergency.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=\"Required permission: read.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Punch Rescue Developer portal\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"noindex\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/punchrescue/bA-DwKcrINUS2Jp_/_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/punchrescue/bA-DwKcrINUS2Jp_/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/punchrescue/bA-DwKcrINUS2Jp_/_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/punchrescue/bA-DwKcrINUS2Jp_/_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/punchrescue/bA-DwKcrINUS2Jp_/_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/punchrescue/bA-DwKcrINUS2Jp_/_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/punchrescue/bA-DwKcrINUS2Jp_/_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/punchrescue/bA-DwKcrINUS2Jp_/_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/punchrescue/bA-DwKcrINUS2Jp_/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get an emergency - Punch Rescue Developer portal\">\u003cmeta data-mint-head property=\"og:description\" content=\"Required permission: read.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Punch Rescue Developer portal\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.punchrescue.com/api-reference/emergencies/get-an-emergency\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://punchrescue.mintlify.site/_mintlify/api/og/v2?division=Emergencies\u0026amp;title=Get+an+emergency\u0026amp;description=**Required+permission%3A**+%60read%60.\u0026amp;theme=bae8430faf2095d1c4817761\u0026amp;signature=40627254c984c8540d4bd49078de03d146c685e2bd6f854c755d88dca8a16c2c\">\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=\"Get an emergency - Punch Rescue Developer portal\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Required permission: read.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://punchrescue.mintlify.site/_mintlify/api/og/v2?division=Emergencies\u0026amp;title=Get+an+emergency\u0026amp;description=**Required+permission%3A**+%60read%60.\u0026amp;theme=bae8430faf2095d1c4817761\u0026amp;signature=40627254c984c8540d4bd49078de03d146c685e2bd6f854c755d88dca8a16c2c\">\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/punchrescue/bA-DwKcrINUS2Jp_/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Punch Rescue Developer portal\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#E1051E\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.punchrescue.com/api-reference/emergencies/get-an-emergency\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/emergencies/get-an-emergency.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.punchrescue.com/#organization\",\"name\":\"Punch Rescue Developer portal\",\"url\":\"https://docs.punchrescue.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/punchrescue/O2-yITAI4Lh3gsko/images/svgviewer-output.svg?fit=max\u0026auto=format\u0026n=O2-yITAI4Lh3gsko\u0026q=85\u0026s=0450206ce5ace91d28653dc827183bc4\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.punchrescue.com#website\",\"name\":\"Punch Rescue Developer portal\",\"url\":\"https://docs.punchrescue.com\",\"publisher\":{\"@id\":\"https://docs.punchrescue.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.punchrescue.com/api-reference/emergencies/get-an-emergency#webpage\",\"url\":\"https://docs.punchrescue.com/api-reference/emergencies/get-an-emergency\",\"name\":\"Get an emergency\",\"description\":\"Required permission: read.\",\"dateModified\":\"2026-09-29T10:39:44.775Z\",\"isPartOf\":{\"@id\":\"https://docs.punchrescue.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.punchrescue.com/api-reference/emergencies/get-an-emergency#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.punchrescue.com/api-reference/emergencies/get-an-emergency#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.punchrescue.com/api-reference/categories/list-emergency-categories\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Emergencies\",\"item\":\"https://docs.punchrescue.com/api-reference/emergencies/list-emergencies\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Get an emergency\",\"item\":\"https://docs.punchrescue.com/api-reference/emergencies/get-an-emergency\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.punchrescue.com/api-reference/emergencies/get-an-emergency#apireference\",\"headline\":\"Get an emergency\",\"name\":\"Get an emergency\",\"description\":\"Required permission: read.\",\"url\":\"https://docs.punchrescue.com/api-reference/emergencies/get-an-emergency\",\"mainEntityOfPage\":{\"@id\":\"https://docs.punchrescue.com/api-reference/emergencies/get-an-emergency#webpage\"},\"dateModified\":\"2026-09-29T10:39:44.775Z\",\"publisher\":{\"@id\":\"https://docs.punchrescue.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.punchrescue.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Punch Rescue Developer portal\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Punch Rescue Developer portal","nav":{"global":null,"tabs":[{"tab":"Guides","hidden":true,"pages":[{"title":"Guides","href":""}]},{"tab":"API reference","groups":[{"group":"API documentation","pages":[{"title":"Introduction","href":"/api-reference/introduction"},{"title":"Webhooks","description":"Receive Punch Rescue events in real time — emergency and device lifecycle transitions delivered as HTTP callbacks with at-least-once delivery, retries, dedup, and stable per-entity ordering.","href":"/api-reference/webhooks"}]},{"group":"Endpoints","hidden":true,"pages":[{"group":"Categories","pages":[{"title":"List emergency categories","description":"**Required permission:** `read`.\n\nReturns the categories an emergency can be declared under for this org.\nUse the resulting `categoryId` (or `name`) in `POST /orgs/{orgId}/emergencies`.\nLives under `/emergencies/` for agent discoverability — answers\n\"what kinds of emergencies can I declare?\" without backing up the tree.","deprecated":null,"version":null,"openapi":"https://api.rescue-serverless.dev.back2back.team/api/public/v1/openapi.json get /orgs/{org_id}/emergencies/categories","href":"/api-reference/categories/list-emergency-categories"}]},{"group":"Onboarding","pages":[{"title":"Get onboarding progress","description":"**Required permission:** `read`.\n\nReturns this org's onboarding-checklist progress: overall `percent`,\n`completed`/`total` counts, and per-step completion grouped with human labels\n(`groups[].steps[]`, each carrying `key`, `label`, `done`, and the entitlement\n`requires` gate). Only steps applicable to the org are listed — the same view\nthe in-app \"Get started\" panel and the `get_onboarding_progress` MCP tool return.","deprecated":null,"version":null,"openapi":"https://api.rescue-serverless.dev.back2back.team/api/public/v1/openapi.json get /orgs/{org_id}/onboarding","href":"/api-reference/onboarding/get-onboarding-progress"},{"title":"Get partner onboarding progress","description":"**Required permission:** `read`. **Key scope:** the partner's own key (not narrowed\nto specific orgs) or a global key.\n\nReturns the partner's own onboarding-checklist progress, same shape as\n`GET /orgs/{orgId}/onboarding`: overall `percent`, `completed`/`total`, and\nper-step completion grouped with labels. The same view the partner portal's\n\"Get started\" panel and the `get_partner_onboarding_progress` MCP tool return.","deprecated":null,"version":null,"openapi":"https://api.rescue-serverless.dev.back2back.team/api/public/v1/openapi.json get /partners/{partner_id}/onboarding","href":"/api-reference/onboarding/get-partner-onboarding-progress"}]},{"group":"Emergencies","pages":[{"title":"List emergencies","description":"**Required permission:** `read`.","deprecated":null,"version":null,"openapi":"https://api.rescue-serverless.dev.back2back.team/api/public/v1/openapi.json get /orgs/{org_id}/emergencies","href":"/api-reference/emergencies/list-emergencies"},{"title":"Declare an emergency","description":"**Required permission:** `write`.\n\nForwarded to the shared EmergencyDeclarationUsecase so Notify and v1 share\na single implementation. Idempotency-Key handling is on the roadmap — for\nnow, retries on a transient failure may create duplicate emergencies.\nPartners that want dedup today can supply `externalId` (unique per org).","deprecated":null,"version":null,"openapi":"https://api.rescue-serverless.dev.back2back.team/api/public/v1/openapi.json post /orgs/{org_id}/emergencies","href":"/api-reference/emergencies/declare-an-emergency"},{"title":"Get an emergency","deprecated":null,"version":null,"openapi":"https://api.rescue-serverless.dev.back2back.team/api/public/v1/openapi.json get /orgs/{org_id}/emergencies/{emergency_id}","href":"/api-reference/emergencies/get-an-emergency"},{"title":"Update an emergency","description":"**Required permission:** `write`. Recategorize an emergency — resolution\nlives at `POST .../resolutions`. Resolved emergencies are immutable.\n\nOnly `categoryId`/`categoryName` are persisted today. Sending\n`description`, `metadata`, or `occurredAt` returns 422 (not yet supported);\nthose fields will be honored once storage is added to AlertDBModel.","deprecated":null,"version":null,"openapi":"https://api.rescue-serverless.dev.back2back.team/api/public/v1/openapi.json patch /orgs/{org_id}/emergencies/{emergency_id}","href":"/api-reference/emergencies/update-an-emergency"},{"title":"Post a message to an emergency's conversation","description":"**Required permission:** `write`.\n\nAccepts optional `attachments`. Each item carries its value under `src` (or the\naccepted aliases `content` / `url` / `data`) and, optionally, `type` and\n`caption`. A bare string, or a single item outside a list, is accepted too.\n\n`src` takes one of two forms:\n\n* **Inline bytes** — a `data:` URI or bare base64. Decoded, verified against\n their own magic bytes, and written to S3 *before* the message row, so a\n storage failure never leaves a message with a broken image in the chat. A\n declared `type` is ignored here: the bytes decide.\n* **A link** — an `https://` URL. Stored as given and **never fetched**: the\n operator's browser loads it directly, so Rescue neither hosts nor guarantees\n it, and a URL that expires will stop rendering. `type` is the only type signal\n a link has; without it the type is guessed from the file extension and\n otherwise falls back to a plain link. Only https, a public host and the\n default port are accepted.\n\nRejections carry a stable code in `detail.error` (see `AttachmentRejectReason`).\n\nRetries of a message whose attachments are *all inline bytes* are safe: an\nidentical payload re-posted inside the dedupe window returns the original message\ninstead of creating a second one. Text-only messages are not deduplicated —\nrepeated posts each create a message, as they always have. Neither are messages\ncarrying a link: a link is identified by its URL, and the media behind a URL can\nchange, so collapsing a re-post would hide a new frame rather than a duplicate.\nRetry a link post only if you want a second message.\n\nThe conversation is created on demand, so a message posted immediately after the\nemergency is declared is accepted rather than rejected with a retry.","deprecated":null,"version":null,"openapi":"https://api.rescue-serverless.dev.back2back.team/api/public/v1/openapi.json post /orgs/{org_id}/emergencies/{emergency_id}/messages","href":"/api-reference/emergencies/post-a-message-to-an-emergencys-conversation"},{"title":"Resolve an emergency","description":"**Required permission:** `write`. Creates the resolution sub-resource.\n\nA second call on an already-resolved emergency returns 409. Idempotency-Key\nsupport is on the roadmap — until then partners should treat a 5xx as\n\"unknown outcome\" and check `GET /emergencies/{id}` before retrying.","deprecated":null,"version":null,"openapi":"https://api.rescue-serverless.dev.back2back.team/api/public/v1/openapi.json post /orgs/{org_id}/emergencies/{emergency_id}/resolutions","href":"/api-reference/emergencies/resolve-an-emergency"}]},{"group":"Devices","pages":[{"title":"List devices","description":"**Required permission:** `read`.\n\nLists devices for this org. Pass `deviceType` to filter to one type, or omit\nit to list every type combined. `status` filters on the effective\nonline/offline state derived from the last heartbeat.","deprecated":null,"version":null,"openapi":"https://api.rescue-serverless.dev.back2back.team/api/public/v1/openapi.json get /orgs/{org_id}/devices","href":"/api-reference/devices/list-devices"},{"title":"Org device status snapshot","description":"**Required permission:** `read`.\n\nReturns a current per-org device snapshot: totals and online counts by\ndevice type, plus low-battery and last-checkin rollups across all types.","deprecated":null,"version":null,"openapi":"https://api.rescue-serverless.dev.back2back.team/api/public/v1/openapi.json get /orgs/{org_id}/devices/status","href":"/api-reference/devices/org-device-status-snapshot"}]},{"group":"Users","pages":[{"title":"List organization users","description":"**Required permission:** `read`.\n\nLists the users belonging to this org. `role` mirrors the Admin Portal's\n\"Role\" column (`responder | user | visitor`, from the user's response level);\n`accessLevel` is the separate admin tier. `ownedDevice*` are per-org.","deprecated":null,"version":null,"openapi":"https://api.rescue-serverless.dev.back2back.team/api/public/v1/openapi.json get /orgs/{org_id}/users","href":"/api-reference/users/list-organization-users"}]}]},{"group":"Endpoints","expanded":true,"pages":[{"group":"Categories","pages":[{"title":"List emergency categories","description":"**Required permission:** `read`.\n\nReturns the categories an emergency can be declared under for this org.\nUse the resulting `categoryId` (or `name`) in `POST /orgs/{orgId}/emergencies`.\nLives under `/emergencies/` for agent discoverability — answers\n\"what kinds of emergencies can I declare?\" without backing up the tree.","deprecated":null,"version":null,"openapi":"https://api.rescue-serverless.dev.back2back.team/api/public/v1/openapi.json get /orgs/{org_id}/emergencies/categories","href":"/api-reference/categories/list-emergency-categories"}]},{"group":"Onboarding","pages":[{"title":"Get onboarding progress","deprecated":null,"version":null,"openapi":"https://api.rescue-serverless.dev.back2back.team/api/public/v1/openapi.json get /orgs/{org_id}/onboarding","href":"/api-reference/onboarding/get-onboarding-progress"},{"title":"Get partner onboarding progress","deprecated":null,"version":null,"openapi":"https://api.rescue-serverless.dev.back2back.team/api/public/v1/openapi.json get /partners/{partner_id}/onboarding","href":"/api-reference/onboarding/get-partner-onboarding-progress"}]},{"group":"Emergencies","pages":[{"title":"List emergencies","deprecated":null,"version":null,"openapi":"https://api.rescue-serverless.dev.back2back.team/api/public/v1/openapi.json get /orgs/{org_id}/emergencies","href":"/api-reference/emergencies/list-emergencies"},{"title":"Declare an emergency","description":"**Required permission:** `write`.\n\nForwarded to the shared EmergencyDeclarationUsecase so Notify and v1 share\na single implementation. Idempotency-Key handling is on the roadmap — for\nnow, retries on a transient failure may create duplicate emergencies.\nPartners that want dedup today can supply `externalId` (unique per org).","deprecated":null,"version":null,"openapi":"https://api.rescue-serverless.dev.back2back.team/api/public/v1/openapi.json post /orgs/{org_id}/emergencies","href":"/api-reference/emergencies/declare-an-emergency"},{"title":"Get an emergency","deprecated":null,"version":null,"openapi":"https://api.rescue-serverless.dev.back2back.team/api/public/v1/openapi.json get /orgs/{org_id}/emergencies/{emergency_id}","href":"/api-reference/emergencies/get-an-emergency"},{"title":"Update an emergency","description":"**Required permission:** `write`. Recategorize an emergency — resolution\nlives at `POST .../resolutions`. Resolved emergencies are immutable.\n\nOnly `categoryId`/`categoryName` are persisted today. Sending\n`description`, `metadata`, or `occurredAt` returns 422 (not yet supported);\nthose fields will be honored once storage is added to AlertDBModel.","deprecated":null,"version":null,"openapi":"https://api.rescue-serverless.dev.back2back.team/api/public/v1/openapi.json patch /orgs/{org_id}/emergencies/{emergency_id}","href":"/api-reference/emergencies/update-an-emergency"},{"title":"Post a message to an emergency's conversation","deprecated":null,"version":null,"openapi":"https://api.rescue-serverless.dev.back2back.team/api/public/v1/openapi.json post /orgs/{org_id}/emergencies/{emergency_id}/messages","href":"/api-reference/emergencies/post-a-message-to-an-emergencys-conversation"},{"title":"Resolve an emergency","deprecated":null,"version":null,"openapi":"https://api.rescue-serverless.dev.back2back.team/api/public/v1/openapi.json post /orgs/{org_id}/emergencies/{emergency_id}/resolutions","href":"/api-reference/emergencies/resolve-an-emergency"}]},{"group":"Devices","pages":[{"title":"List devices","deprecated":null,"version":null,"openapi":"https://api.rescue-serverless.dev.back2back.team/api/public/v1/openapi.json get /orgs/{org_id}/devices","href":"/api-reference/devices/list-devices"},{"title":"Org device status snapshot","deprecated":null,"version":null,"openapi":"https://api.rescue-serverless.dev.back2back.team/api/public/v1/openapi.json get /orgs/{org_id}/devices/status","href":"/api-reference/devices/org-device-status-snapshot"}]},{"group":"Users","pages":[{"title":"List organization users","deprecated":null,"version":null,"openapi":"https://api.rescue-serverless.dev.back2back.team/api/public/v1/openapi.json get /orgs/{org_id}/users","href":"/api-reference/users/list-organization-users"}]}]}]},{"tab":"MCP Server","pages":[{"title":"MCP Server","href":"/introduction"}]}]},"basePath":"","title":"Get an emergency - Punch Rescue Developer portal","buildId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","deploymentId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-i2a3QZ8E.js","utils-ChLwp8m0.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DRktVTDc.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CA2pEs4T.js","snippetPresets-ClQ6XrKD.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Ct_Lv36y.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Cn2PYw9e.js","shallow-rkyymjXQ.js","getApiPlaygroundDisplay-BB9vkXtE.js","CodeSnippet-Bm5RU7m1.js","CodeSnippets-BgU9Deuz.js","Page-BUDYNlhG.js","getPastedJson-BD-6NNum.js","icon-8Z6tud2e.js","MethodPill-Tuzr4g3V.js","DuplicateIcon-0ceWFYhN.js","createIcon-FBXow_ST.js","DynamicMarkdown-CD8713Yy.js","SectionHeading-7zgzQbH-.js","axios-vUo_bRtp.js","Markdown-D7Ofw1oz.js","clsx-eKJ4rcii.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CwjSCXIK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-9EK5IAXV.js"]}