GET
/
streams
/
{stream}
/
records
/
tail
Check the 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 has been acknowledged 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 access token.

Path Parameters

​
stream
string
required

Stream name.

Response

​
tail
object
required

Sequence number that will be assigned to the next record on the stream, and timestamp of the last record.