OpenFish Documentation

Appearance

Get annotations​

GET
/api/v1/annotations

Get paginated annotations, with options to filter by video stream, capture source, observer and observation.

Parameters​

Query Parameters

limit

Number of results to return.

Typeinteger
default20
minimum1
offset

Number of results to skip.

Typeinteger
minimum0
name

Name to filter by.

Typestring
videostream

Video stream to filter by.

Typeinteger
capturesource

Capture source to filter by.

Typeinteger
observer

Observer to filter by.

Typestring
observation[<key>]

Observation key/value to filter by. Use * to filter on presence of the key only.

Typestring

Responses​

OK
application/json
JSON
{
"limit": 20,
"offset": 0,
"results": [
{
"id": 1234567890,
"keypoints": [
{
"box": {
"x1": 10,
"x2": 50,
"y1": 25,
"y2": 75
},
"time": "01:56:05.500"
}
],
"observation": {
"additionalProperties": "string"
},
"observer": 1234567890,
"videostreamId": 1234567890
}
],
"total": 1
}

Samples​