---
title: "QueryCustomTargetKeys"
method: POST
path: "/rmp/mgmt/v1/platforms/{platform_id}/custom-target-keys"
tags: ["CustomTargeting"]
---

# QueryCustomTargetKeys

`POST /rmp/mgmt/v1/platforms/{platform_id}/custom-target-keys`

Query all available custom target keys for the platform.

## Path parameters

- `platform_id` string, required

## Request body

- object — QueryCustomTargetKeys public request. Query all available custom target keys for the platform.
  - `cursor` string — Cursor for pagination. Required after the first request.
  - `limit` integer — Number of items to be returned. Default: 15, Maximum value: 50
  - `ad_type` 'UNKNOWN_AD_TYPE' | 'ITEM' | 'BRAND' | 'DISPLAY' | 'RESERVED_DISPLAY', required

## Response `200`

A successful response.

- PublicQueryCustomTargetKeysResponse — QueryCustomTargetKeys public response.
  - `custom_target_keys` V1CustomTargetKey[], required — List of custom target keys matching the query criteria.
    - `id` string, required — The id of the custom target key.
    - `label` string, required — The label of the custom target key.
    - `description` string, required — The description of the custom target key.
    - `is_multi_select` boolean, required — Whether the custom target key allows multi select.
    - `valid` boolean, required — The validity of the custom target key.
    - `created_at` string, date-time, required — Created timestamp. API user should not touch this field; it is set internally.
    - `updated_at` string, date-time, required — Updated timestamp. Set internally during creation, but required during update. This should match the updated timestamp updated_at of the custom target key.
  - `prev_cursor` string — Cursor for the previous page. Omitted if this is the first page.
  - `next_cursor` string — Cursor for the next page. Omitted if this is the last page.
  - `total` integer, required — Total number of custom target keys matching the query criteria.

## Other responses

- `400` — Bad request. Detailed cause can be found in the response message.
- `401` — Unauthorized.
- `403` — Permission denied.
- `404` — Not found. One or more required resources do not exist.You can see the details in the response message.
- `500` — Internal server error. Detailed cause can be found in the response message.

---

[API](https://skmtc.dev/moloco/apis/decision-api.md) · [All operations](https://skmtc.dev/moloco/apis/decision-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/moloco/decision-api/revisions/206968b164e7/schema)