---
title: "Get Layer"
method: GET
path: "/v1/template/{template_id}/layer/{layer_id}"
tags: ["Layers"]
---

# Get Layer

`GET /v1/template/{template_id}/layer/{layer_id}`

## Request

- Base URL: `https://layerre.com` (the document declares no server; this is the origin it was published from)
- URL: `https://layerre.com/v1/template/{template_id}/layer/{layer_id}`
- Auth: HTTP bearer

Get a specific layer by ID. Refreshes signed URL if expired.

## Path parameters

- `template_id` string, uuid, required
- `layer_id` string, uuid, required

## Response `200`

Layer retrieved successfully

- LayerResponse
  - `id` string, uuid, required
  - `template_id` string, uuid, required
  - `name` string, required: Layer name
  - `layer_type` 'image' | 'text', required: Enum for layer types
  - `x` number: X position in pixels
  - `y` number: Y position in pixels
  - `position` integer: Z-order position (0=bottom/back, higher=top/front)
  - `page_number` integer: Page index within a multi-page template (0-based)
  - `properties` FlexibleLayerProperties, required: Flexible layer properties that can handle any combination of text and image properties
    - `width` number, nullable: Layer width in pixels
    - `height` number, nullable: Layer height in pixels
    - `color` string, nullable: Color in hex format (#RRGGBB)
    - `rotation` number, nullable: Rotation angle in degrees
    - `text` string, nullable: Text content
    - `font_size` number, nullable: Font size in pixels
    - `font_name` string, nullable: Font family name
    - `font_style` FontStyle: Font styling properties
      - `weight` string, nullable
      - `italic` boolean, nullable
      - `underline` boolean, nullable
    - `text_align` 'left' | 'center' | 'right' | 'justify': Text alignment options
    - `text_direction` 'rtl', nullable: Text direction; only set for right-to-left text (Arabic, Hebrew, etc.). Absent/null means LTR.
    - `letter_spacing` number, nullable: Letter spacing in pixels
    - `line_spacing` number, nullable: Line spacing in pixels
    - `vertical_align` string, nullable: Vertical alignment for text (e.g. 'middle')
    - `img_url` string, nullable: Image URL for image layers: public HTTPS, data URI, or Google Drive link shared for viewing.
    - `image_fit` 'cover' | 'contain'
    - `image_position` 'top-left' | 'top-center' | 'top-right' | 'center-left' | 'center' | 'center-right' | 'bottom-left' | 'bottom-center' | 'bottom-right'
    - `signed_url_expiry` string, date-time, nullable
    - `opacity` number, nullable: Opacity value (0.0 = fully transparent, 1.0 = fully opaque)
    - `flip_horizontal` boolean, nullable: Flip the layer horizontally
    - `flip_vertical` boolean, nullable: Flip the layer vertically
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `404`: Layer or template not found
- `422`: Validation Error
- `500`: Internal server error

---

[API](https://skmtc.dev/layerre/apis/layerre-api-documentation.md) · [All operations](https://skmtc.dev/layerre/apis/layerre-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/layerre/apis/layerre-api-documentation/revisions/66b268766603?raw)