GET
/
streams
/
{stream}
/
records
/
tail
curl --request GET \
  --url https://{basin}.b.aws.s2.dev/v1/streams/{stream}/records/tail \
  --header 'Authorization: Bearer <token>'
{
  "tail": {
    "seq_num": 1,
    "timestamp": 1
  }
}

The tail of the stream is the next sequence number that will be assigned to a record, and the timestamp of the last record on the stream. Both these values will be 0 for an empty stream.

This is a fast operation, expected to complete in single-digit milliseconds.

Checking the tail is linearizable — if an append request has received an acknowledgment before a check-tail request is made, the response will reflect the write.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
stream
string
required

Stream name.

Response

200
application/json

The response is of type object.