---
title: "Map of the mosaic - every tile with its photo, position and size in pixels of the full file"
method: GET
path: "/mosaics/{id}/layout"
tags: ["mosaics"]
---

# Map of the mosaic - every tile with its photo, position and size in pixels of the full file

`GET /mosaics/{id}/layout`

## Request

- Base URL: `https://api.collager.ai/v1`
- URL: `https://api.collager.ai/v1/mosaics/{id}/layout`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Query parameters

- `format` 'json' | 'xml'

## Response `200`

The layout (JSON, or XML with ?format=xml).

- Layout
  - `object` 'layout', required
  - `mosaic_id` string, required
  - `width` integer, required
  - `height` integer, required
  - `tile_count` integer, required
  - `levels` integer
  - `tiles` object[], required
    - `photo` integer, nullable: 0-based position of the photo in your request (main image first, then featured, secondary and tile_image_urls).
    - `source_url` string, nullable
    - `x` integer, required
    - `y` integer, required
    - `w` integer, required
    - `h` integer, required
    - `level` integer, required: 1 = largest tiles.
    - `featured` 'gold' | 'silver' | 'null', nullable
    - `avg_color` string, nullable

## Other responses

- `404`: Error.
- `409`: Error.

---

[API](https://skmtc.dev/collager/apis/collager-ai-photo-mosaic-photo-collage-api.md) · [All operations](https://skmtc.dev/collager/apis/collager-ai-photo-mosaic-photo-collage-api/llms.txt) · [OpenAPI document](https://skmtc.dev/collager/apis/collager-ai-photo-mosaic-photo-collage-api/revisions/719c6e7aaf09?raw)