---
title: "Get SIM webhook"
method: GET
path: "/devices/{deviceId}/webhook"
tags: ["SIMs (Devices)"]
---

# Get SIM webhook

`GET /devices/{deviceId}/webhook`

## Request

- Base URL: `https://dashboard.hologram.io/api/1`
- URL: `https://dashboard.hologram.io/api/1/devices/{deviceId}/webhook`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/hologram/apis/hologram-rest-api-v1/docs/devices/:deviceId/webhook/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the webhook configuration for the specified SIM (device).

## Path parameters

- `deviceId` integer, required

## Query parameters

- `guid` string

## Response `200`

OK

- GetDeviceWebhookResponse
  - `success` boolean: Indicates whether the request was successful.
  - `data` DeviceWebhookObject
    - `guid` string: Unique webhook GUID used to construct the webhook URL
    - `deviceid` integer: Device ID
    - `protocol` string: Network protocol (TCP or UDP)
    - `port` integer: Port number (1–65535)
    - `encrypted` 0 | 1: 1 if the webhook connection is encrypted
    - `url` string: Webhook URL for sending messages to this device

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/hologram/apis/hologram-rest-api-v1.md) - [All operations](https://skmtc.dev/hologram/apis/hologram-rest-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/hologram/apis/hologram-rest-api-v1/revisions/1bc07dcd1631?raw)