---
title: "Retrieves share codes related to the specific shocker the the given APIkey has claimed one or more share code for."
method: GET
path: "/Share/ById/{ShockerId}"
tags: ["Share"]
---

# Retrieves share codes related to the specific shocker the the given APIkey has claimed one or more share code for.

`GET /Share/ById/{ShockerId}`

## Request

- Base URL: `https://api.pishock.com`
- URL: `https://api.pishock.com/Share/ById/{ShockerId}`
- Auth: one of:
  - API key in header `X-PiShock-Token`
  - API key in header `X-PiShock-UserId`
  - API key in header `X-PiShock-Server-Key`
  - API key in header `X-PiShock-Api-Key`

## Path parameters

- `ShockerId` string, required

## Response `200`

Success

- GetSharedShockerResponse[]
  - `HubId` integer
  - `ShockerId` integer
  - `Name` string
  - `IsV3` boolean
  - `CanBeep` boolean
  - `CanVibrate` boolean
  - `CanShock` boolean
  - `CanPause` boolean
  - `MaxDuration` integer
  - `MaxIntensity` integer

## Other responses

- `401`: Unauthorized
- `403`: Forbidden

## Changes

- **2026-09-22** `e39f4566848b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/pishock/apis/pishock-public-api-v1/changes/Share/ById/:ShockerId/get.md)

---

[API](https://skmtc.dev/pishock/apis/pishock-public-api-v1.md) - [All operations](https://skmtc.dev/pishock/apis/pishock-public-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/pishock/apis/pishock-public-api-v1/revisions/6398a6a65c40?raw)