Skip to content

Sightings

Get a sighting

Get a sighting’s event, location, condition, measurements, identification, and photo metadata.

GET/api/integration/v1/logs/{log_id}
View examples

Authentication

X-API-Key required header

The organization’s active integration key.

Set up access

Parameters

log_idstring · uuidpath · required
The sighting ID.

Responses

200Successful Response

application/jsonIntegrationSighting

  • idstring · uuidrequired
  • observed_atstring · date-timerequired
  • eventSightingEvent | NestingEvent | FalseCrawlEvent | StrandedEvent | DeceasedEvent | OtherEventrequired
    Show variants

    SightingEvent

    • typesightingrequired

    NestingEvent

    • typenestingrequired
    • egg_countinteger | nullrequired

      Minimum 0

    FalseCrawlEvent

    • typefalse_crawlrequired

    StrandedEvent

    • typestrandedrequired
    • is_injuredboolean | nullrequired

    DeceasedEvent

    • typedeceasedrequired
    • suspected_causestring | nullrequired

    OtherEvent

    • typeotherrequired
    • descriptionstringrequired
  • locationLocationrequired
    Show fields
    • namestringrequired
    • coordinatesCoordinates | nullrequired
      Show fields
      • latitudenumberrequired

        Minimum -90 · Maximum 90

      • longitudenumberrequired

        Minimum -180 · Maximum 180

  • conditionCondition | nullrequired
    Show fields
    • statusBodyCondition | nullrequired

      Values healthy, scarred, injured

    • notesstring | nullrequired
    • markingsarray of Markingrequired
      Show fields
      • idstring · uuidrequired
      • regionBodyRegionrequired

        Values head, carapace, front_flipper_left, front_flipper_right, rear_flipper_left, rear_flipper_right, tail

      • kindMarkingKindrequired

        Values scratch, wound, missing_limb, deformity, barnacles, fibropapilloma, tag_scar, other

      • severitySeverityrequired

        Values minor, moderate, severe

      • notesstring | nullrequired
      • is_permanentbooleanrequired
      • created_atstring · date-timerequired
      • updated_atstring · date-timerequired
  • turtle_idstring · uuid | nullrequired
  • behaviorstring | nullrequired
  • measurementsMeasurements | nullrequired
    Show fields
    • carapace_length_cmnumber | nullrequired
    • carapace_width_cmnumber | nullrequired
    • weight_kgnumber | nullrequired
  • identificationIdentification | nullrequired
    Show fields
    • methodIdentificationMethodrequired

      Values photo_match, manual, flipper_tag, new_individual

    • confidencenumber | nullrequired

      Minimum 0 · Maximum 1

  • notesstring | nullrequired
  • photosarray of SightingPhotorequired
    Show fields
    • idstring · uuidrequired
    • urlstringrequired
    • download_urlstring | nullrequired
    • expires_atstring · date-time | nullrequired
    • captured_atstring · date-time | nullrequired
    • uploaded_atstring · date-timerequired
    • marking_idstring · uuid | nullrequired
  • created_atstring · date-timerequired
  • updated_atstring · date-timerequired
401Missing, invalid, expired, or revoked authentication credentials

application/jsonApiErrorOut

  • detailstring | array of ValidationIssueOut | objectrequired
    Show fields
    • locarray of string | integerrequired
    • msgstringrequired
    • typestringrequired
  • codestring | null

WWW-Authenticate · Authentication challenge for the required credential scheme

404Resource not found or outside the authenticated organization

application/jsonApiErrorOut

  • detailstring | array of ValidationIssueOut | objectrequired
    Show fields
    • locarray of string | integerrequired
    • msgstringrequired
    • typestringrequired
  • codestring | null
422Invalid fields, body, image, or current password

application/jsonApiErrorOut

  • detailstring | array of ValidationIssueOut | objectrequired
    Show fields
    • locarray of string | integerrequired
    • msgstringrequired
    • typestringrequired
  • codestring | null
429Request quota exceeded; wait according to Retry-After

application/jsonApiErrorOut

  • detailstring | array of ValidationIssueOut | objectrequired
    Show fields
    • locarray of string | integerrequired
    • msgstringrequired
    • typestringrequired
  • codestring | null

Retry-After · Advised delay in seconds (currently fixed at 60)

500Unexpected server error; internal details are withheld

application/jsonApiErrorOut

  • detailstring | array of ValidationIssueOut | objectrequired
    Show fields
    • locarray of string | integerrequired
    • msgstringrequired
    • typestringrequired
  • codestring | null