---
title: "Get campaign keys by key"
method: GET
path: "/api/campaigns/keys"
tags: ["Campaign Keys"]
---

# Get campaign keys by key

`GET /api/campaigns/keys`

Retrieve campaign keys by key value

## Response `200`

Campaign keys

- object
  - `ok` boolean
  - `data` object[]
    - `id` string, uuid, required — Campaign Key ID
    - `campaign_id` string, uuid, required — Campaign ID
    - `campaign_key` string — The signed campaign secret used to assign rewards. Conditional: it is only included for roles allowed to see campaign keys (owner, collaborator, editor, developer and support) and omitted from the response for any other role, such as viewer.
    - `enabled` boolean, required — Whether the key is enabled
    - `active_since` string, date-time, nullable — Key activation time
    - `active_until` string, date-time, nullable — Key expiration time
    - `requires_authentication` boolean — Whether the key requires user authentication
    - `requires_captcha` boolean — Whether the key requires captcha verification
    - `requires_catalyst` boolean — Whether the key requires catalyst verification
    - `requires_position` string, nullable — Required position for catalyst verification
    - `assign_target` string, address, nullable — Target contract for reward assignment
    - `assign_value` string, nullable — Value for reward assignment
    - `assign_group` string, nullable — Group for reward assignment
    - `assign_limit` number, nullable — Assignment limit for the key
    - `created_at` string, date-time, required — Key creation time
    - `updated_at` string, date-time, required — Key last update time

## Other responses

- `500` — Internal server error

---

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