Skip to navigation

Retrieve a team observation glossary item

Retrieves a observation type from your team's glossary. Returns 404 when the entry does not exist or is not a observation type.

Authentication

AuthorizationBearer

OAuth authentication of the form <token>.

Path parameters

teamGlossaryIdstringRequiredformat: "^tgy_[a-zA-Z0-9]{10,22}$"
The unique identifier of the team glossary.

Headers

X-Studies-Api-VersionstringOptional

Response headers

X-RateLimit-LimitintegerOptional
The number of requests permitted in the current rate limit window.
X-RateLimit-RemainingintegerOptional

The number of requests still available in the current rate limit window. When several limits apply, this reflects the per-API-key limit, so a request can be rejected while this value is above zero.

X-RateLimit-ResetintegerOptional
The number of seconds until the current rate limit window resets.

Response

The requested observation type.
idstringformat: "^tgy_[a-zA-Z0-9]{10,22}$"
Unique identifier for an entry in your team's own glossary.
titlestring<=255 characters
The title of the observation type.
labelstring or null<=20 characters
A short label for the observation type.
descriptionstring or null
A longer description of the observation type.
statusenum
Whether a team glossary entry is available for use or archived.
Allowed values:
typeenum

How values are recorded against a team glossary entry. numeric entries have a configured min/max range, severity entries accept Mild/Moderate/Severe, and none entries carry free-form text with no structured value.

Allowed values:
numericobjectOptional

The bounds of a numeric observation type. At least one of min and max is set.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error