# Photo

A photo with its metadata and owner.

Group: Objects.

## Fields

- `mediaId` (string, required): The photo's id.
- `url` (string, required): The stored photo (at most 2048 px on the long side).
- `thumbUrl` (string or null, required): The ~640 px variant, or null until it is made.
- `ownerType` (string, required): What the photo belongs to. One of `spot`, `product`, `collection`, `listing`.
- `ownerId` (string, required): The owner row's id.
- `caption` (string or null, required): Caption.
- `alt` (string or null, required): Alt text.
- `credit` (string or null, required): Photographer credit.
- `width` (number or null, required): Width in pixels.
- `height` (number or null, required): Height in pixels.
- `order` (number, required): Position in the owner's gallery (ascending, fractional).
- `focalX` (number or null, required): Focal point from 0 (left) to 1 (right).
- `focalY` (number or null, required): Focal point from 0 (top) to 1 (bottom).
- `sourcePageUrl` (string or null, required): The page the photo was licensed from.
- `licence` (string or null, required): Licence name.
- `creditUrl` (string or null, required): The photographer's profile page.
- `shows` (PhotoShows or null, required): What the photo shows.
  Fields of PhotoShows: https://developers.sceniq.earth/fields/photo-shows.md
- `takenAt` (PhotoTakenAt or null, required): Where it was taken.
  Fields of PhotoTakenAt: https://developers.sceniq.earth/fields/photo-taken-at.md
- `locationVerifiedBy` (string or null, required): How the location was confirmed. One of `geotag`, `landmark`, `photographer_caption`, `creator`, `other`.
- `capturedOn` (string or null, required): Capture date (YYYY-MM-DD).
- `reviewNotes` (string or null, required): Notes for the creator's review, never shown to buyers.

## Used by

- [list_media](https://developers.sceniq.earth/reference/list_media.md)
