Turtle profiles
List a turtle’s sightings
Get a page of sightings from a single turtle’s history, newest first.
/api/integration/v1/individuals/{individual_id}/logsAuthentication
X-API-Key required header
The organization’s active integration key.
Set up accessParameters
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 IntegrationSightingrequiredShow fields
idstring · uuidrequiredobserved_atstring · date-timerequiredeventSightingEvent | NestingEvent | FalseCrawlEvent | StrandedEvent | DeceasedEvent | OtherEventrequiredShow variants
SightingEvent
typesightingrequired
NestingEvent
typenestingrequiredegg_countinteger | nullrequiredMinimum 0
FalseCrawlEvent
typefalse_crawlrequired
StrandedEvent
typestrandedrequiredis_injuredboolean | nullrequired
DeceasedEvent
typedeceasedrequiredsuspected_causestring | nullrequired
OtherEvent
typeotherrequireddescriptionstringrequired
locationLocationrequiredShow fields
namestringrequiredcoordinatesCoordinates | nullrequiredShow fields
latitudenumberrequiredMinimum -90 · Maximum 90
longitudenumberrequiredMinimum -180 · Maximum 180
conditionCondition | nullrequiredShow fields
statusBodyCondition | nullrequiredValues healthy, scarred, injured
notesstring | nullrequiredmarkingsarray of MarkingrequiredShow fields
idstring · uuidrequiredregionBodyRegionrequiredValues head, carapace, front_flipper_left, front_flipper_right, rear_flipper_left, rear_flipper_right, tail
kindMarkingKindrequiredValues scratch, wound, missing_limb, deformity, barnacles, fibropapilloma, tag_scar, other
severitySeverityrequiredValues minor, moderate, severe
notesstring | nullrequiredis_permanentbooleanrequiredcreated_atstring · date-timerequiredupdated_atstring · date-timerequired
turtle_idstring · uuid | nullrequiredbehaviorstring | nullrequiredmeasurementsMeasurements | nullrequiredShow fields
carapace_length_cmnumber | nullrequiredcarapace_width_cmnumber | nullrequiredweight_kgnumber | nullrequired
identificationIdentification | nullrequiredShow fields
methodIdentificationMethodrequiredValues photo_match, manual, flipper_tag, new_individual
confidencenumber | nullrequiredMinimum 0 · Maximum 1
notesstring | nullrequiredphotosarray of SightingPhotorequiredShow fields
idstring · uuidrequiredurlstringrequireddownload_urlstring | nullrequiredexpires_atstring · date-time | nullrequiredcaptured_atstring · date-time | nullrequireduploaded_atstring · date-timerequiredmarking_idstring · uuid | nullrequired
created_atstring · date-timerequiredupdated_atstring · date-timerequired
totalintegerrequiredlimitintegerrequiredoffsetintegerrequired
401Missing, invalid, expired, or revoked authentication credentials
application/jsonApiErrorOut
detailstring | array of ValidationIssueOut | objectrequiredShow fields
locarray of string | integerrequiredmsgstringrequiredtypestringrequired
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 | objectrequiredShow fields
locarray of string | integerrequiredmsgstringrequiredtypestringrequired
codestring | null
422Invalid fields, body, image, or current password
application/jsonApiErrorOut
detailstring | array of ValidationIssueOut | objectrequiredShow fields
locarray of string | integerrequiredmsgstringrequiredtypestringrequired
codestring | null
429Request quota exceeded; wait according to Retry-After
application/jsonApiErrorOut
detailstring | array of ValidationIssueOut | objectrequiredShow fields
locarray of string | integerrequiredmsgstringrequiredtypestringrequired
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 | objectrequiredShow fields
locarray of string | integerrequiredmsgstringrequiredtypestringrequired
codestring | null