> ## Documentation Index
> Fetch the complete documentation index at: https://docs.linkrmap.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a hotspot

> Fetch a single hotspot by id.

Returns a single hotspot by its numeric `id`.

```bash theme={null}
curl -H "x-api-key: linkr_test_demo01" \
  "https://linkrmap.com/api/v1/hotspots/1"
```

## Path parameter

| Parameter | Type    | Notes                                              |
| --------- | ------- | -------------------------------------------------- |
| `id`      | integer | Hotspot id. The current dataset uses ids **1–78**. |

## Response

```json theme={null}
{
  "data": {
    "id": 1,
    "name": "Tony's Deli & Grocery",
    "lat": 40.7189,
    "lng": -73.9847,
    "mbps": 85,
    "risk": "Low",
    "owner": "@tony_deli",
    "note": "Password on the counter next to the register.",
    "signal": "Good",
    "network": "WiFi 5",
    "security": "WPA2",
    "uptime": "96.8%",
    "rating": "4.3/5",
    "avatar": "#FF6B6B",
    "lastUsed": "12 minutes ago",
    "locationImage": "https://images.unsplash.com/photo-1555396273-367ea4eb4db5?w=800&q=80"
  }
}
```

See the [hotspot schema](/docs/api-reference/list-hotspots#hotspot-schema) for every
field. Note that `uptime` and `rating` are strings.

## Not found

An id that is not in the dataset returns `404`:

```json theme={null}
{
  "error": "Not found",
  "message": "Hotspot with id 999 not found."
}
```


## OpenAPI

````yaml GET /api/v1/hotspots/{id}
openapi: 3.1.0
info:
  title: Linkr Public API
  version: 1.0.0
  description: >-
    Read-only API serving the Linkr New York City preview dataset (78 hotspots).
    No write operations exist. The API key is a shape-checked demo key, not an
    issued credential.
servers:
  - url: https://linkrmap.com
    description: Production
security:
  - apiKey: []
paths:
  /api/v1/hotspots/{id}:
    get:
      summary: Get a hotspot
      description: Returns a single hotspot by numeric id.
      operationId: getHotspot
      parameters:
        - name: id
          in: path
          description: Numeric hotspot id (1–78 in the current dataset).
          required: true
          schema:
            type: integer
      responses:
        '200':
          description: The hotspot.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/Hotspot'
        '401':
          description: Missing or malformed API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: No hotspot with that id.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Hotspot:
      type: object
      properties:
        id:
          type: integer
          example: 1
        name:
          type: string
          example: Tony's Deli & Grocery
        lat:
          type: number
          example: 40.7189
        lng:
          type: number
          example: -73.9847
        mbps:
          type: number
          example: 85
        risk:
          type: string
          enum:
            - Low
            - Medium
            - High
          example: Low
        owner:
          type: string
          example: '@tony_deli'
        note:
          type: string
          example: Password on the counter next to the register.
        signal:
          type: string
          example: Good
        network:
          type: string
          example: WiFi 5
        security:
          type: string
          example: WPA2
        uptime:
          type: string
          description: String, not a number.
          example: 96.8%
        rating:
          type: string
          description: String, not a number.
          example: 4.3/5
        avatar:
          type: string
          example: '#FF6B6B'
        lastUsed:
          type: string
          example: 12 minutes ago
        locationImage:
          type: string
          example: https://images.unsplash.com/photo-1555396273-367ea4eb4db5?w=800&q=80
      required:
        - id
        - name
        - lat
        - lng
        - mbps
        - risk
        - owner
        - note
        - signal
        - network
        - security
        - uptime
        - rating
    Error:
      type: object
      properties:
        error:
          type: string
          example: Unauthorized
        message:
          type: string
          example: >-
            Invalid or missing API key. Include x-api-key header with a valid
            key (linkr_test_* or linkr_live_*).
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Value must match linkr_(test|live)_[a-zA-Z0-9]{6,}. This is a shape
        check, not an issued credential.

````