---
title: "Retrieve an allocation template by ID"
method: GET
path: "/demand/accounts/{account_id}/allocation-templates/{template_id}"
tags: ["Allocation Templates Admin"]
---

# Retrieve an allocation template by ID

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

## Request

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

Retrieves the details of a specific allocation template by its ID.
NOTE: The response currently includes only Cint Exchange suppliers. Support for private exchange suppliers is not yet available.

## Query parameters

- `locale` string: Unique text code of the locale.

## Response `200`

The allocation template was retrieved successfully.

- GetAccountAllocationTemplateByTemplateIdResponse
  - `template_id` string, ulid, required: A unique identifier for the template.
  - `name` string, required: The name of the account allocation template.
  - `is_default` boolean, required: Whether this template is the default allocation template for the account.
  - `supply_allocations` union[], required
    - union
      - AllocationTemplateExchangeSupplierResponse
        - `type` 'exchange', required: The type of supply allocation. For this object, the value is always `exchange`.
        - `percentage_max` integer, required: Controls the maximum amount of fills from this supply allocation group. The value is `inclusive`.
        - `percentage_min` integer, nullable, required: Controls the minimum amount of fills from this supply allocation group. The value is `inclusive`
        - `suppliers` TemplateSupplierResponse[], required
          - `supplier_id` integer: The ID of the supplier
          - `name` string: The name of the supplier.
          - `type` 'loyalty_panels' | 'non_panel_or_affiliate' | 'survey_panels': The type of the supplier.
      - AllocationTemplateGroupSupplierResponse
        - `type` 'group', required: The type of supply allocation. For this object, the value is always `group`.
        - `name` string, required
        - `percentage_max` integer, required: The inclusive maximum percentage of survey completes that can come from this allocation.
        - `percentage_min` integer, nullable, required: The inclusive minimum percentage of survey completes that can come from this allocation.
        - `suppliers` TemplateSupplierResponse[], required
          - `supplier_id` integer: The ID of the supplier
          - `name` string: The name of the supplier.
          - `type` 'loyalty_panels' | 'non_panel_or_affiliate' | 'survey_panels': The type of the supplier.
      - AllocationTemplateBlockedSupplierResponse
        - `type` 'blocked', required: The type of supply allocation. For this object, the value is always `blocked`.
        - `suppliers` TemplateSupplierResponse[], required
          - `supplier_id` integer: The ID of the supplier
          - `name` string: The name of the supplier.
          - `type` 'loyalty_panels' | 'non_panel_or_affiliate' | 'survey_panels': The type of the supplier.
  - `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.

## 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.
- `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)