Observations

Search Observations

Changed on

Search for observations that match the provided filters.

Keywords are searched for in the observation value field. For image and voice observations, the response includes a time-limited signed_url to access the media file.

get/v1/observation/

Request

  • Base URL
    https://developer.beta.salussafety.io
  • URL
    https://developer.beta.salussafety.io/v1/observation/
  • Auth
    • HTTP bearer
    • or OAuth 2
      Client credentials
      Token URL: https://guardian.beta.salussafety.io/token
    • or OAuth 2
      Authorization code: https://guardian.beta.salussafety.io/authorize
      Token URL: https://guardian.beta.salussafety.io/token

Query parameters

querystring

Keyword to match in the observation text. Empty string returns recent observations.

site_idinteger nullable

Filter to observations from a specific site/project.

typestring nullable

Filter by media type: 'text', 'image', or 'voice'. Note: 'audio' is a legacy value on older rows; filter on both 'voice' and 'audio' for complete history.

limitinteger

Maximum number of results to return.

skipinteger

Number of results to skip for pagination.

Response

Successful Response

errorboolean

A boolean error indicator.

messagestring nullable

Optional message.

Changes