Get a theme

curl --request GET \
  --url https://api.closedloop.sh/v1/themes/{id} \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.closedloop.sh/v1/themes/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.closedloop.sh/v1/themes/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.closedloop.sh/v1/themes/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.closedloop.sh/v1/themes/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "id": "a1b2c3d4-e5f6-4a7b-8c9d-000000000001",
  "title": "Dark mode across the product",
  "ric_score": 7.8,
  "status": "active",
  "replacement_theme_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "description": "Customers repeatedly ask for a dark theme for night-time and accessibility.",
  "reach": 0.62,
  "impact": 0.8,
  "confidence": 0.9,
  "insight_count": 34,
  "unique_customer_count": 19,
  "deal_blocker_count": 4,
  "feature_count": 4,
  "created_at": "2026-04-02T00:00:00Z",
  "updated_at": "2026-06-01T00:00:00Z",
  "severity_breakdown": {
    "critical": 1,
    "high": 8,
    "medium": 20,
    "low": 5
  },
  "features": [
    {
      "id": "b2c3d4e5-f6a7-4b8c-9d0e-000000000002",
      "theme_id": "a1b2c3d4-e5f6-4a7b-8c9d-000000000001",
      "title": "Dark mode toggle in settings",
      "ric_score": 6.9,
      "status": "active",
      "description": "A user-controllable dark / light toggle in the settings panel.",
      "insight_count": 12,
      "unique_customer_count": 9,
      "product_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "product_name": "Core Platform",
      "created_at": "2026-04-05T00:00:00Z",
      "updated_at": "2026-06-01T00:00:00Z"
    }
  ],
  "top_insights": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "title": "<string>",
      "severity": "critical",
      "source": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "category": "<string>",
      "customer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "customer_name": "<string>",
      "source_date": "2023-11-07T05:31:56Z"
    }
  ],
  "affected_customers": [
    {
      "id": "c0ffee00-0000-4000-8000-000000000001",
      "name": "Acme Co",
      "parent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "parent_name": "<string>",
      "domain": "acme.com",
      "industry": "Hospitality",
      "employee_count": 250,
      "arr": 48000,
      "currency": "USD",
      "is_active_customer": true,
      "churn_state": "active",
      "insight_count": 23,
      "last_seen": "2026-06-10T09:00:00Z"
    }
  ]
}

GET

themes

{id}

Get a theme

curl --request GET \
  --url https://api.closedloop.sh/v1/themes/{id} \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.closedloop.sh/v1/themes/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.closedloop.sh/v1/themes/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.closedloop.sh/v1/themes/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.closedloop.sh/v1/themes/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "id": "a1b2c3d4-e5f6-4a7b-8c9d-000000000001",
  "title": "Dark mode across the product",
  "ric_score": 7.8,
  "status": "active",
  "replacement_theme_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "description": "Customers repeatedly ask for a dark theme for night-time and accessibility.",
  "reach": 0.62,
  "impact": 0.8,
  "confidence": 0.9,
  "insight_count": 34,
  "unique_customer_count": 19,
  "deal_blocker_count": 4,
  "feature_count": 4,
  "created_at": "2026-04-02T00:00:00Z",
  "updated_at": "2026-06-01T00:00:00Z",
  "severity_breakdown": {
    "critical": 1,
    "high": 8,
    "medium": 20,
    "low": 5
  },
  "features": [
    {
      "id": "b2c3d4e5-f6a7-4b8c-9d0e-000000000002",
      "theme_id": "a1b2c3d4-e5f6-4a7b-8c9d-000000000001",
      "title": "Dark mode toggle in settings",
      "ric_score": 6.9,
      "status": "active",
      "description": "A user-controllable dark / light toggle in the settings panel.",
      "insight_count": 12,
      "unique_customer_count": 9,
      "product_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "product_name": "Core Platform",
      "created_at": "2026-04-05T00:00:00Z",
      "updated_at": "2026-06-01T00:00:00Z"
    }
  ],
  "top_insights": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "title": "<string>",
      "severity": "critical",
      "source": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "category": "<string>",
      "customer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "customer_name": "<string>",
      "source_date": "2023-11-07T05:31:56Z"
    }
  ],
  "affected_customers": [
    {
      "id": "c0ffee00-0000-4000-8000-000000000001",
      "name": "Acme Co",
      "parent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "parent_name": "<string>",
      "domain": "acme.com",
      "industry": "Hospitality",
      "employee_count": 250,
      "arr": 48000,
      "currency": "USD",
      "is_active_customer": true,
      "churn_state": "active",
      "insight_count": 23,
      "last_seen": "2026-06-10T09:00:00Z"
    }
  ]
}

Authorizations

X-API-Key

string

header

required

Team-scoped API key created in the app (Settings → API Keys). Sent as X-API-Key: <key> on every request. The header name apikey is also accepted as an alias.

Path Parameters

string<uuid>

required

Resource UUID.

Response

Theme detail

string<uuid>

required

Immutable UUID; never reassigned to another theme.

Example:

"a1b2c3d4-e5f6-4a7b-8c9d-000000000001"

title

string

required

Example:

"Dark mode across the product"

ric_score

number

required

Reach × Impact × Confidence.

Example:

7.8

status

enum<string>

required

Available options:

active,

declined,

shipped,

parked

Example:

"active"

replacement_theme_id

string<uuid>

Present only for a valid merged theme returned by a list request; points directly to the final surviving theme.

description

string

Example:

"Customers repeatedly ask for a dark theme for night-time and accessibility."

reach

number

Example:

0.62

impact

number

Example:

0.8

confidence

number

Example:

0.9

insight_count

integer

Supporting insights across the theme.

Example:

34

unique_customer_count

integer

Example:

19

deal_blocker_count

integer

Distinct customers represented by deal-blocker evidence.

Example:

4

feature_count

integer

Buildable features under this theme.

Example:

4

created_at

string<date-time>

Example:

"2026-04-02T00:00:00Z"

updated_at

string<date-time>

Example:

"2026-06-01T00:00:00Z"

severity_breakdown

object

Example:

{
  "critical": 1,
  "high": 8,
  "medium": 20,
  "low": 5
}

features

object[]

The buildable features under this theme.

Show child attributes

top_insights

object[]

Show child attributes

affected_customers

object[]

Show child attributes

Getting started

Endpoints

Get a theme

Authorizations

Path Parameters

Response