---
title: "Get site by ID"
method: GET
path: "/sites/{siteId}"
tags: ["Sites"]
---

# Get site by ID

`GET /sites/{siteId}`

## Request

- Base URL: `https://api.8x8.com/admin-provisioning`
- URL: `https://api.8x8.com/admin-provisioning/sites/{siteId}`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/8x8/apis/8x8-administration-site-management-api/docs/sites/:siteId/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a specific site by its ID

## Path parameters

- `siteId` string, required

## Headers

- `X-Request-Id` string, uuid

## Response `200`

Site retrieved successfully

- Site
  - `id` string, nullable
  - `name` string, required
  - `pbxName` string, required
  - `locale` 'da-DK' | 'de-DE' | 'en-AU' | 'en-GB' | 'en-US' | 'es-ES' | 'fi-FI' | 'fr-BE' | 'fr-CA' | 'fr-CH' | 'fr-FR' | 'it-IT' | 'ja-JP' | 'nl-BE' | 'nl-NL' | 'no-NO' | 'pl-PL' | 'pt-BR' | 'pt-PT' | 'sv-SE' | 'zh-CN', required
  - `timezone` string, required
  - `address` SiteAddress, required
    - `id` string, nullable
  - `siteCode` string, nullable
  - `extensionLength` integer, nullable
  - `emergencyNotifications` EmergencyNotification[], nullable
    - `type` 'EMAIL', nullable
    - `values` string[], nullable
  - `callerIdSettings` CallerIdSettings
    - `mainNumber` string, nullable
    - `setMainNumberAsCallerId` boolean, nullable
    - `shareMainNumberAsCallerId` boolean, nullable
    - `displayName` string, nullable
  - `defaultDialPlanCallingCountry` string, nullable
  - `defaultDialPlanRuleset` 'INTERNATIONAL' | 'DOMESTIC' | 'EMERGENCYONLY', nullable
  - `defaultVoicemailZeroOutDestinationExtensionId` string, nullable
  - `defaultVoicemailZeroOutDestinationExtensionNumber` string, nullable

## Other responses

- `400`: Bad Request - Invalid request
- `403`: Forbidden - Access denied to this resource
- `404`: Not Found - Site does not exist
- `408`: Request Timeout - Downstream service timeout
- `429`: Too Many Requests - Rate limit exceeded
- `500`: Internal Server Error - Unexpected error occurred
- `503`: Service Unavailable - Service unavailable due to connectivity or network issues

---

[API](https://skmtc.dev/8x8/apis/8x8-administration-site-management-api.md) - [All operations](https://skmtc.dev/8x8/apis/8x8-administration-site-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/8x8/apis/8x8-administration-site-management-api/revisions/8e00e01e46e0?raw)