---
title: "Get a Photo"
method: GET
path: "/photos/{id}"
tags: ["Locations Photos"]
---

# Get a Photo

`GET /photos/{id}`

Get a photo identified by its uberall unique id

## Path parameters

- `id` string, required

## Response `200`

Successfully retrieved the photo

- object
  - `status` 'SUCCESS' | 'PENDING' | 'QUOTA_LIMIT_EXCEED' | 'NOT_AUTHORIZED' | 'FORBIDDEN' | 'BAD_ACCESS_TOKEN' | 'BAD_PRIVATE_KEY' | 'BAD_PUBLIC_KEY' | 'MISSING_PARAMETER' | 'INVALID_PARAMETER' | 'WRONG_PARAMETER_TYPE' | 'CONFLICT' | 'RESOURCE_LOCKED' | 'SERVER_ERROR' | 'ERROR' | 'NOT_FOUND' | 'BAD_REQUEST' | 'USER_ERROR' | 'PARTIAL_ERROR' | 'SERVICE_TEMPORARILY_UNAVAILABLE', required
  - `message` string — (optional) Holds further information about the response
  - `warnings` string[] — (optional) Holds further warnings
  - `response` object, required — The actual response object of the response
    - `photo` object — Location photo response model
      - `id` integer — The uberall unique id for the photo
      - `dateCreated` string, date-time — The date when the object was created in uberall database
      - `repoKey` string — File name
      - `locationId` integer — The uberall unique id of this photo's location
      - `description` string — A description for the photo
      - `identifier` string — The photo identifier based on your internal identification system
      - `main` boolean — A boolean indicating whether this photo is the location's main photo. Maximum one per location
      - `logo` boolean — A boolean indicating whether this photo is the location's logo. Maximum one logo per location
      - `type` string, required — Required - One of: <br> MAIN <br> LOGO <br> SQUARED_LOGO <br> DOCTOR_COM_PORTRAIT - Doctor.com clients only <br> LANDSCAPE - Updates Google Cover Photo<br> APPLE_LANDSCAPE <br> PHOTO <br> STOREFINDER_LOGO - Only for Uberall locator product <br> STOREFINDER_COVER - Only for Uberall locator product<br> FACEBOOK_LANDSCAPE - Facebook Cover Photo <br> EXTERIOR - Google's Exterior Photo tag - availability dependent on a location's business category <br> INTERIOR - Google's Interior Photo tag - availability dependent on a location's business category <br> FOOD_AND_DRINK - Google's Food and Drink Photo tag - availability dependent on a location's business category <br> MENU - Google's Menu Photo tag, which should only be photos of the menu - availability dependent on a location's business category <br> PRODUCT - Google's Product Photo tag - availability dependent on a location's business category <br> TEAMS - Google's Teams Photo tag - availability dependent on a location's business category <br> AT_WORK - Google's At Work Photo tag - availability dependent on a location's business category <br> COMMON_AREA - Google's Common Area Photo tag - availability dependent on a location's business category <br> ROOMS - Google's Rooms Photo tag - availability dependent on a location's business category
      - `url` string — The URL of the photo
      - `publicUrl` string — A public url for this photo
      - `thumbnailUrl` string — Url for the image thumbnail
      - `cropOffsetX` integer — Horizontal pixel offset of the top-left corner of the cropped area [LANDSCAPE photo only]
      - `cropOffsetY` integer — Vertical pixel offset of the top-left corner of the cropped area [LANDSCAPE photo only]
      - `cropWidth` integer — Width of the 16:9 cropped area [LANDSCAPE photo only]
      - `cropHeight` integer — Height of the 16:9 cropped area [LANDSCAPE photo only]
      - `sourceUrl` string — The client supplied url for a photo

## Other responses

- `400` — Bad Request - The request was invalid or cannot be otherwise served
- `401` — Unauthorized - Authentication credentials are missing or invalid
- `403` — Forbidden - The request is understood, but has been refused or access is not allowed
- `404` — Not Found - The requested resource could not be found

---

[API](https://skmtc.net/uberall/apis/uberall-api.md) · [All operations](https://skmtc.net/uberall/apis/uberall-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/uberall/uberall-api/versions/a506e82d7cbe/schema)