On this page:
/sightings resource
The /sightings endpoint lets you add a new orca whale sighting, update an existing sighting by its ID, list all sightings, list a sighting by its ID, or delete an existing sighting by its ID.
Also see the /users resource.
Endpoint
{base_url}/sightings
Also see Base URL
Properties
Example of a full /sightings resource:
{
"id": 1,
"user_id": 1,
"pod": "J-pod",
"time": "2025-05-03T10:00",
"location": "Lime Kiln Point State Park"
}
Description of resource properties:
| Property | Type | Description | Example |
|---|---|---|---|
id | integer | Unique identifier for the sighting. Read-only and automatically generated. | 1 |
user_id | integer | The ID of the user who reported the sighting, as described in the /users resource. | 1 |
pod | string | The identified pod of orca. Available attributes are J-pod, K-pod, T49A, and unknown). | "J-pod" |
time | string | The timestamp of the sighting in ISO 8601 format. | "2025-05-03T10:00" |
location | string | The location where the sighting occurred. | "Lime Kiln Point State Park" |