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

# Retrieve a global allocation template by ID

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

## Request

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

Retrieves the details of a specific global 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 global allocation template was retrieved successfully.

- GetGlobalAllocationTemplateByTemplateIdResponse
  - `template_id` string, ulid, required: A unique identifier for the template.
  - `name` string, required: The name of the global allocation template.
  - `supply_allocations` union[], required: A list of allocation objects. The `type` field in each object determines its structure and purpose.
    - 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.

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