Get Annotation Set Metadata API

Call the Get Annotation Set Metadata API to return the metadata for the specified annotation set.

HTTP method and path

GET v1/skills/{skillId}/asrAnnotationSets/{annotationSetId}
Attributes Type Description Required
skillId String Skill Id as part of the request URI. Yes
annotationSetId String Annotation set Id as part of the request URI. Yes


Request headers

Content-Type: application/json
Accept: application/json

Request body



HTTP status


Response headers

Content-Type: application/json

Response body

    "annotationSets": [
        "id": string,
        "name": String,
        "annotationCount": integer,
        "lastUpdatedTimestamp": timestamp,
        "eligibleForEvaluation": boolean
    "paginationContext": {
        "nextToken": string
Attributes Type Description Required
name String Name of the annotation set. Yes
annotationCount Integer Number of annotations in the annotation set. Yes
lastUpdatedTimestamp String Timestamp for the last update to the annotation set (ISO 8601 format). Yes
eligibleForEvaluation Boolean Indicates if the annotation set is eligible for evaluation. A set is ineligible for evaluation if any annotation within the set has a missing uploadId, filePathInUpload, expectedTranscription, or expectedTranscription. Yes

Error response

The following table lists call-specific errors. For a reference of errors that can apply to all Automatic Speech Recognition (ASR) APIs, see Automatic Speech Recognition API Error Reference.

HTTP Status Code Error Code Scenario

404 Not Found


Requested skill does not exist

Requested annotation set does not exist

400 Bad Request


Annotation set Id is malformed

500 Internal Server Error


Request failed due to an internal server error


Sample Request Sample Response
GET /v1/skills/1234/asrAnnotationSets/1234-1234123-1234 HTTP/1.1 Accept: application/json HTTP 200 OK Content-Type: application/json { "name": "my annotation set", "annotationCount": 12, "lastUpdatedTimestamp": "2019-08-12T18:46:31.674Z" }
GET /v1/skills/1234/asrAnnotationSets/1234-1234123-1234 HTTP/1.1 Accept: application/json
HTTP 404 Not Found Content-Type: application/json { "message": "Resource with identfier \"1234-1234123-1234\" cannot be found", "code": "RESOURCE_NOT_FOUND" }