---
title: "Get existing annotation"
method: GET
path: "/{globalCompanyId}/annotations/{id}"
tags: ["Annotations"]
---

# Get existing annotation

`GET /{globalCompanyId}/annotations/{id}`

## Path parameters

- `globalCompanyId` string, required
- `id` string, required

## Query parameters

- `expansion` string[]
- `locale` string

## Headers

- `Authorization` string, required
- `x-api-key` string, required

## Response `200`

successful operation

- AnalyticsAnnotation
  - `id` string
  - `name` string
  - `description` string
  - `dateRange` string
  - `color` 'STANDARD1' | 'STANDARD2' | 'STANDARD3' | 'STANDARD4' | 'STANDARD5' | 'STANDARD6' | 'STANDARD7' | 'STANDARD8' | 'STANDARD9'
  - `applyToAllReports` boolean
  - `scope` AnnotationScope
    - `metrics` ScopeMetric[]
      - `id` string
      - `componentType` string
    - `filters` ScopeFilter[]
      - `id` string
      - `operator` string
      - `dimensionType` string
      - `terms` string[]
      - `componentType` string
  - `createdDate` string, date-time
  - `modifiedDate` string, date-time
  - `modifiedById` string
  - `tags` object[]
  - `shares` object[]
  - `approved` boolean
  - `favorite` boolean
  - `usageSummary` object
  - `systemUserOwned` boolean
  - `owner` Owner
    - `id` integer, required — the login id of the owner
    - `name` string — the friendly full login name of the owner, included when the expansion parameter ownerFullName is true
    - `login` string — the friendly full login name of the owner, included when the expansion parameter ownerFullName is true
  - `companyId` integer
  - `reportSuiteName` string
  - `rsid` string

## Changes

- **2025-08-07** `f13c80692287` — 1 warning
  - deleted the `header` request parameter `x-gw-ims-org-id`
- **2025-08-06** `f49e893a6c2b` — 1 breaking
  - added the new required `header` request parameter `x-gw-ims-org-id`
- **2022-05-10** `dcd4514630c4` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/adobe/apis/adobe-analytics-apis/changes/:globalCompanyId/annotations/:id/get.md)

---

[API](https://skmtc.dev/adobe/apis/adobe-analytics-apis.md) · [All operations](https://skmtc.dev/adobe/apis/adobe-analytics-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/adobe/adobe-analytics-apis/revisions/b2e01ce0f30a/schema)