Download location image​

GET
/locations/{locationId}/images/{imageId}/download

Returns binary PNG bytes (Content-Type: image/png), not JSON. The mobile rendition is the default; thumbnail is smaller for compact previews.

Use cases

  • Retrieve the image for display in a client or location gallery.
  • Use the thumbnail rendition when a compact preview is sufficient.

Related endpoints

  • GET /locations/{locationId}/images — find image IDs and categories.
  • GET /locations/{locationId}/images/{imageId} — read image metadata.

Authorizations​

bearerAuth

Generate an API token here

Type
HTTP (bearer)

Parameters​

Header Parameters

compatibility-date*

API compatibility date in YYYY-MM-DD format. Must be a date after 2025-11-01.

Type
string
Required
Example"2025-11-02"
Pattern
^\d{4}-\d{2}-\d{2}$
organization-id*

Routes the request to the organization named by this ID. The bearer token must be authorized for that organization.

Type
string
Required
Example"3b241101-e2bb-4255-8caf-4136c566a962"
Min Length
1
Max Length
40

Path Parameters

locationId*

ID returned by POST /locations or GET /locations. It scopes location updates and image operations to one site.

Type
string
Required
Example"2ABCDEFGHJKLMNPQRSTU"
Min Length
1
Max Length
40
imageId*

ID returned in the image-id response header or images[]. Pair it with locationId to retrieve or update that image.

Type
string
Required
Example"image-7f3a9c"
Min Length
1
Max Length
40

Query Parameters

variant

mobile is the standard display rendition and default; choose thumbnail for compact previews.

Type
string
Valid values
"mobile""thumbnail"
Example"thumbnail"
Default
"mobile"

Responses​

raw

application/json

Playground​

Authorization
Headers
Variables
Key
Value

Samples​