---
schema_version: "1"
id: 191be10931c85d09b0d7b2b720fc9ac8a1f3a98177aba892538c0964a20009c8
title: Annotations List Resource
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/bi_dev_guide_rest/bi_resources_annotations.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_resources_annotations.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 99ea5b66a4567c26787bbd650f37dc1d0790f5867d3a3ce7ffda5beef53e42f9
description: Returns a list of annotations and creates an annotation.
---
# Annotations List Resource

Returns a list of annotations and creates an annotation.

Resource URL

/wave/annotations

Formats

JSON

Available Version

37.0

HTTP Methods

GET POST

Request parameters for GET

| Parameter Name | Type | Description | Required or Optional | Available Version |
| --- | --- | --- | --- | --- |
| assetId | Id | The ID of the asset. | Required | 37.0 |

The following REST URL shows how to use the assetId parameter in the GET request.

/wave/annotations?assetId=<id>

Response body for GET

[Annotation Collection](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_responses_annotation_collection.htm "A collection of annotations.")

Request body for POST

[Annotation Input](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_requests_annotation_input.htm "An Analytics annotation.")

Response body for POST

[Annotation](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_responses_annotation.htm "An Analytics annotation.")