Skip to content

Turtle profiles

List a turtle’s sightings

Get a page of sightings from a single turtle’s history, newest first.

GET/api/integration/v1/individuals/{individual_id}/logs
View examples

Authentication

X-API-Key required header

The organization’s active integration key.

Set up access

Parameters

individual_idstring · uuidpath · required
The turtle profile ID.
limitintegerquery · optional
Maximum number of records to return.Minimum 1 · Maximum 200 · Default 50
offsetintegerquery · optional
Number of records to skip.Minimum 0 · Default 0

Responses

200Successful Response

application/jsonPage[IntegrationSighting]

  • itemsarray of IntegrationSightingrequired
    Show fields
    • 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
  • totalintegerrequired
  • limitintegerrequired
  • offsetintegerrequired
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