---
title: "List the public template library"
type: reference
method: GET
path: /rest-api/template-catalog/list.do
tag: "Templates"
---

# List the public template library

`GET https://YOUR-NETWORK-DOMAIN/rest-api/template-catalog/list.do`

Lists the templates of Epom's public template library - rich-media and adapter formats such as catfish, interstitial, skin, video slider - each with what it does, its placement type, its properties and whether this network already has it: AVAILABLE (not installed), INSTALLED (installedTemplateId is yours to use), UPDATE_AVAILABLE (installed, the library has a newer build) or NOT_SHARED (installed, but not shared with you). An AVAILABLE template that has an active template of the same name in the account lists it in sameNameTemplateIds (a copy made by hand). Each template also carries devices (desktop, mobile or both), lastChanged (the date its source last changed, when known), readmeUrl (its README: what it does, its settings, gotchas) and previewUrls (desktop / mobile screenshots, when it has them). Requires the Templates create permission and the Templates view permission on all templates (the library reports what the whole network holds).

## Query params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `query` | string | no | `catfish` | Words that must all appear in a template's name, format, description, devices or placement type, e.g. "catfish mobile" |
| `placementType` | string | no | `MOBILE_SITE_PLACEMENT` | Only templates for this placement type |

## Responses

- `200` — The library's templates with their status on this network
- `400` — Bad request — invalid or missing parameters
- `401` — Authentication error
- `403` — No Templates create permission, or Templates view is not granted on all templates
- `503` — The template library is not set up on this network or could not be read

## Example request

```bash
curl --request GET \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/template-catalog/list.do?placementType=MOBILE_SITE_PLACEMENT&query=catfish' \
  --header 'X-Api-Key: YOUR_API_KEY'
```

Source: https://epom.com/ad-server/docs/api/templates/get-template-catalog-list