---
title: "List templates"
method: GET
path: "/ad_accounts/{ad_account_id}/templates"
tags: ["ad_accounts"]
---

# List templates

`GET /ad_accounts/{ad_account_id}/templates`

Gets all Templates associated with an ad account ID.

## Path parameters

- `ad_account_id` string, required

## Query parameters

- `bookmark` string
- `page_size` integer
- `order` 'ASCENDING' | 'DESCENDING'

## Response `200`

The request has succeeded.

- object
  - `bookmark` string, nullable
  - `items` AccountTemplate[], required
    - `ad_account_id` string — ID of the Ad Account that owns the template
    - `ad_account_ids` string[] — IDs of the Ad Accounts that have access to this template
    - `ade_columns` AdeColumn[] — A list of ADE columns
    - `attribution_type` string — Attribution type for Brand/Category/SKU reports
    - `click_window_days` number — The length of the sliding window over which click conversions will be attributed
    - `columns` ReportingColumn[] — A list of columns to be included in the report
    - `conversion_report_time_type` 'TIME_OF_AD_ACTION' | 'TIME_OF_CONVERSION' — Conversion report time type
    - `creation_source` 'ADS_API' | 'ADS_MANAGER_REPORTING_PAGE' | 'ADS_MANAGER_REPORT_BUILDER' — The source of conversion events ingestion
    - `custom_column_ids` string[], nullable — A list of custom column IDs
    - `display_metadata` string — Additional metadata about this reporting template
    - `engagement_window_days` number — The length of the sliding window over which engagement conversions will be attributed
    - `filters_json` string, nullable — A JSON representation of any filters to be applied before returning report data. Each filter object should contain all of the following fields:\ "field": The column name\ "operator": The operator. Allowed operators: ["=", "!=", "in", "not_in", "~", ">", "<", "contains_substring"]\ "value": A single value or a list of values
    - `granularity` 'TOTAL' | 'DAY' | 'HOUR' | 'WEEK' | 'MONTH' — Specifies the time interval at which analytics data is broken down. Determines how metrics are grouped within the requested date range. **Note:** The `HOUR` enum no longer provides data for conversion metrics, but it still returns data for non-conversion metrics. All other enums are unchanged.
    - `id` string, required — Template ID
    - `ingestion_sources` IngestionSource[], nullable — The filter on the conversion ingestion source method for conversion metrics
    - `is_default` boolean — A boolean representing if this is the default view that loads for this template type
    - `is_deleted` boolean, nullable — A boolean that indicates if the template has been deleted
    - `is_owned_by_user` boolean — A boolean value that indicates if the user owns the template
    - `is_scheduled` boolean — A boolean value that indicates if this template has been used to create a scheduled report
    - `name` string, nullable — Template Name
    - `report_end_relative_days_in_past` number — The number of days prior to the day the report will be delivered at which the report will end
    - `report_format` 'JSON' | 'CSV' — Format of generated report
    - `report_level` 'ADVERTISER' | 'ADVERTISER_TARGETING' | 'CAMPAIGN' | 'CAMPAIGN_TARGETING' | 'AD_GROUP' | 'AD_GROUP_TARGETING' | 'PIN_PROMOTION' | 'PIN_PROMOTION_TARGETING' | 'KEYWORD' | 'PRODUCT_GROUP' | 'PRODUCT_GROUP_TARGETING' | 'PRODUCT_ITEM' | 'PRODUCT_ITEM_TARGETING' — Level of the reporting request
    - `report_start_relative_days_in_past` number — The number of days prior to the day the report will be delivered at which the report will start
    - `reporting_time_zone` 'PINTEREST_TIME_ZONE' | 'AD_ACCOUNT_TIME_ZONE' — Specify the timezone to be applied for the reporting.
    - `sort_by` unknown
    - `type` string — Type of the template
    - `updated_time` number — Time of last update in seconds since Unix epoch
    - `user_id` string — ID of the user who created the template
    - `view_window_days` number — The length of the sliding window over which view conversions will be attributed

## Other responses

- `400` — The request could not be understood by the server due to unexpected data.
- `401` — Authentication is required and has either failed or not been provided.
- `403` — The request was valid, but the server is refusing action. The user might not have the necessary permissions for a resource.
- `404` — The requested resource could not be found on this server.
- `429` — The user has sent too many requests in a given amount of time and is being rate limited.
- `default` — An unexpected error response.

---

[API](https://skmtc.net/pinterest/apis/pinterest-rest-api.md) · [All operations](https://skmtc.net/pinterest/apis/pinterest-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pinterest/pinterest-rest-api/revisions/b698c180678a/schema)