---
title: "Get a site"
method: GET
path: "/v1/sites/{site_id}"
tags: ["Sites"]
---

# Get a site

`GET /v1/sites/{site_id}`

## Request

- Base URL: `https://api.getsitecontrol.com`
- URL: `https://api.getsitecontrol.com/v1/sites/{site_id}`
- Auth: HTTP bearer

One site with the same fields as `list_sites`. Call it to check the state of a site you already know, e.g. whether it is suspended before turning widgets on with `update_widgets`.

## Path parameters

- `site_id` integer, required

## Response `200`

Successful Response

- Site
  - `id` integer, required
  - `name` string, nullable: Name given in the admin; null when none was given
  - `url` string, nullable: Address of the site
  - `timezone` string, nullable: IANA time zone name, e.g. Europe/Berlin; null when not set
  - `is_suspended` boolean, nullable: true: the site is suspended and widgets cannot be turned on (`update_widgets` refuses to turn one on); false: not suspended
  - `is_script_installed` boolean, nullable: true: the Getsitecontrol script was found on the site, e.g. a widget was shown there; false: not found yet
  - `created_at` string, date-time, nullable
  - `updated_at` string, date-time, nullable
  - `access` object, nullable: In `list_sites`: your level in each section of the site, widgets, emails and contacts: none, view (read), edit (change), full (also turn widgets on and send); a change needs edit or full

## Other responses

- `400`: Unsupported GSC-Version
- `401`: Missing or invalid API key or access token
- `403`: Access denied
- `404`: `site_not_found`: no such site, it is deleted, or it belongs to another account
- `422`: Validation failed
- `429`: Rate limited
- `503`: Temporarily unavailable; retry later

---

[API](https://skmtc.dev/getsitecontrol/apis/getsitecontrol-public-api.md) - [All operations](https://skmtc.dev/getsitecontrol/apis/getsitecontrol-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getsitecontrol/apis/getsitecontrol-public-api/revisions/084fcad80e75?raw)