---
title: "List country allocation templates"
method: GET
path: "/demand/accounts/{account_id}/country-allocation-templates"
tags: ["Allocation Templates Admin"]
---

# List country allocation templates

`GET /demand/accounts/{account_id}/country-allocation-templates`

## Request

- Base URL: `https://api.cint.com/v1`
- URL: `https://api.cint.com/v1/demand/accounts/{account_id}/country-allocation-templates`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/cint/apis/demand-api/docs/demand/accounts/:account_id/country-allocation-templates/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a paginated list of country-level allocation templates for the given account. You can filter by name, business unit, country code, or default status, and control pagination using the `page_size`, `start_after`, and `end_before` parameters.

## Query parameters

- `search` string
- `page_size` integer
- `start_after` string
- `end_before` string
- `sort_ascending` 'asc' | 'desc'
- `business_unit_id` string: The unique ID of the business unit, which determines the currency used for the target group.
- `country_code` string: Two-letter country code as per ISO 3166-1 alpha-2 standard.
- `is_default` boolean
- `sort_by` string

## Response `200`

The list of country allocation templates was retrieved successfully.

- ListCountryAllocationTemplatesResponse
  - `templates` CountryAllocationTemplateListItem[], required
    - `template_id` string, ulid, required: A unique identifier for the template.
    - `name` string, required: The name of the country allocation template.
    - `country_code` string, required: Two-letter country code as per ISO 3166-1 alpha-2 standard.
    - `business_unit_id` string, required: The business unit this template belongs to.
    - `is_default` boolean, required: Whether this template is the default for the country and business unit combination.
    - `version` integer, required: The version of the template.
    - `last_modified_at` string, datetime, required: The last time the template was modified
    - `last_modified_by` string, uuid, required: A unique identifier for the user.
  - `has_more` boolean, required: If there are further results to be shown using the returned next cursor or previous cursor, this will be true, otherwise false.
  - `next_cursor` string, required: Provides the string to use as the "start_after" or "end_before" value of the next request. Null if no further results.

## Other responses

- `400`: A request is not valid and can't be processed.
- `401`: A request is unauthorized.
- `403`: A requested is forbidden.
- `404`: A requested resource isn't found.
- `429`: The request was rate limited. Please retry after the specified delay.
- `500`: A request failed due to an internal error.

---

[API](https://skmtc.dev/cint/apis/demand-api.md) - [All operations](https://skmtc.dev/cint/apis/demand-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cint/apis/demand-api/revisions/077a4bdda5cb?raw)