Email Universal Layouts

Get universal layouts

With this endpoint you can get a paginated list of universal layouts.

Sorting: Items are returned in descending order by creation time (newest first). This is based on the internal document ID which contains a timestamp.

Pagination: This endpoint uses cursor-based pagination for efficient traversal of large datasets.

  • Use the paging.cursors.after value from the response to get the next page
  • Use the paging.cursors.before value from the response to get the previous page
  • The paging.hasMore field indicates if more results are available
  • Do not use both after and before parameters simultaneously
  • Maximum page size is 250 items (default 100)
  • If limit is less than 1 or greater than 250, returns 400 Bad Request

Filtering: Use nameContains to filter layouts by name (case-insensitive partial match, max 200 characters)

Scopes: email-templates.read

Rate Limiting: This endpoint is rate limited to 400 requests per minute.

get/email-universal-layouts

Request

  • Base URL
    https://api.omnisend.com/api
  • URL
    https://api.omnisend.com/api/email-universal-layouts
  • Auth
    • OAuth 2
      Client credentials
      Token URL: https://app.omnisend.com/oauth2/token scopes: email-templates.read
    • or API key in header Authorization

Query parameters

limitinteger

Number of items per page (1-250, default 100)

afterstring

Cursor for next page (base64-encoded, from previous response)

beforestring

Cursor for previous page (base64-encoded, from previous response)

nameContainsstring

Filter layouts by name (case-insensitive partial match, max 200 characters)

Headers

Omnisend-Versionstring required

API version that specifies the response format and behaviour

Response

List of universal layouts with pagination

Changes

No recorded changes to this operation across all 1 revision of this API.