---
title: "Service Information"
method: GET
path: "/service"
tags: ["Service"]
---

# Service Information

`GET /service`

Provide information about the service.

## Response `200`

- Service — Provides information about the service instance
  - `name` string — The service instance name. This should be a very short, human-readable name that may be displayed in listings of Service instances.
  - `description` string — The service instance description. This should be a human-readable description that may be showed in detailed views of Service instances. The description should be longer and more detailed than `name`.
  - `type` string, required — The type identifier for the service instance. The value must start with 'urn:x-tams:service'
  - `api_version` string, required — The version of the TAMS API specification this service instance implements
  - `service_version` string — The version of software providing this service. Note: Different implementations and software houses may use different conventions for their version identification. As such, this field is intentionally permissive and intended to be informative only. Client implementations should avoid using this field to determine compatibility.
  - `event_stream_mechanisms` Eventstreamcommon[] — List the types of event stream that this service implementation supports
    - `name` string, required — Name of this type of event stream mechanism. Must be unique. Any name defined in this specification is reserved
    - `docs` string — Location (e.g. a URL) at which documentation for this event stream mechanism may be found
    - `config` object — Configuration options required to make use of this mechanism
  - `min_object_timeout` string, required — A signed nanosecond resolution timestamp represented as "{sign?}{seconds}:{nanoseconds}". The intended interpretation of the value is assumed to be defined elsewhere. E.g. * "1:40000000" is the timestamp of the 27th video frame for 25 Hz video with origin at "0:0". * "1694429247:40000000" is the TAI timestamp for a video frame at 2023-09-11T10:46:50.04Z UTC. Details of the format can be found in the [Timestamps in TAMS](https://github.com/bbc/tams/blob/main/docs/appnotes/0008-timestamps-in-TAMS.md) application note.
  - `min_presigned_url_timeout` string — A signed nanosecond resolution timestamp represented as "{sign?}{seconds}:{nanoseconds}". The intended interpretation of the value is assumed to be defined elsewhere. E.g. * "1:40000000" is the timestamp of the 27th video frame for 25 Hz video with origin at "0:0". * "1694429247:40000000" is the TAI timestamp for a video frame at 2023-09-11T10:46:50.04Z UTC. Details of the format can be found in the [Timestamps in TAMS](https://github.com/bbc/tams/blob/main/docs/appnotes/0008-timestamps-in-TAMS.md) application note.

## Changes

> 23 revisions in range; 16 could not be searched.

- **2025-04-24** `b01aaf8cffe2` — 1 breaking, 1 warning, 1 info
  - removed the required property `min_object_timeout` from the response with the `200` status
  - removed the optional property `min_presigned_url_timeout` from the response with the `200` status
  - added the required property `media_store` to the response with the `200` status

[Change history](https://skmtc.dev/aws-samples/apis/time-addressable-media-store/changes/service/get.md)

---

[API](https://skmtc.dev/aws-samples/apis/time-addressable-media-store.md) · [All operations](https://skmtc.dev/aws-samples/apis/time-addressable-media-store/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/aws-samples/time-addressable-media-store/revisions/eb3977b33601/schema)
