curl --request GET \
--url https://app.clipstake.com/api/v1/brand/brands/{brand_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.clipstake.com/api/v1/brand/brands/{brand_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.clipstake.com/api/v1/brand/brands/{brand_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://app.clipstake.com/api/v1/brand/brands/{brand_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 => [
"Authorization: Bearer <token>"
],
]);
$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://app.clipstake.com/api/v1/brand/brands/{brand_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.clipstake.com/api/v1/brand/brands/{brand_id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.clipstake.com/api/v1/brand/brands/{brand_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "brd_3f9c0a1b2c3d4e5f60718293a4b5c6d7",
"name": "Northwind Coffee",
"description": "Specialty coffee roasted in small batches.",
"website_url": "https://northwind.example",
"primary_color": "#1F6FEB",
"status": "active",
"created_at": "2026-09-02T10:15:00.000Z",
"updated_at": "2026-09-20T08:40:00.000Z"
}{
"error": {
"code": "unauthorized",
"message": "Provide a valid API key as `Authorization: Bearer cb_live_...`.",
"request_id": "0b7e4d2c-9a1f-4e3b-8c6d-5f2a1b9c7e34"
}
}{
"error": {
"code": "not_found",
"message": "No such brand.",
"request_id": "3c9a8b7d-2e1f-4a6b-9c8d-7e6f5a4b3c21"
}
}{
"error": {
"code": "internal_error",
"message": "An unexpected error occurred.",
"request_id": "5a4b3c2d-1e0f-4a9b-8c7d-6e5f4a3b2c19"
}
}Get a brand
Returns one brand. An ID you cannot read gives 404.
curl --request GET \
--url https://app.clipstake.com/api/v1/brand/brands/{brand_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.clipstake.com/api/v1/brand/brands/{brand_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.clipstake.com/api/v1/brand/brands/{brand_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://app.clipstake.com/api/v1/brand/brands/{brand_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 => [
"Authorization: Bearer <token>"
],
]);
$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://app.clipstake.com/api/v1/brand/brands/{brand_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.clipstake.com/api/v1/brand/brands/{brand_id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.clipstake.com/api/v1/brand/brands/{brand_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "brd_3f9c0a1b2c3d4e5f60718293a4b5c6d7",
"name": "Northwind Coffee",
"description": "Specialty coffee roasted in small batches.",
"website_url": "https://northwind.example",
"primary_color": "#1F6FEB",
"status": "active",
"created_at": "2026-09-02T10:15:00.000Z",
"updated_at": "2026-09-20T08:40:00.000Z"
}{
"error": {
"code": "unauthorized",
"message": "Provide a valid API key as `Authorization: Bearer cb_live_...`.",
"request_id": "0b7e4d2c-9a1f-4e3b-8c6d-5f2a1b9c7e34"
}
}{
"error": {
"code": "not_found",
"message": "No such brand.",
"request_id": "3c9a8b7d-2e1f-4a6b-9c8d-7e6f5a4b3c21"
}
}{
"error": {
"code": "internal_error",
"message": "An unexpected error occurred.",
"request_id": "5a4b3c2d-1e0f-4a9b-8c7d-6e5f4a3b2c19"
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Brand ID. Format: brd_ followed by 32 lowercase hexadecimal characters.
"brd_3f9c0a1b2c3d4e5f60718293a4b5c6d7"
Response
Successful response
A brand you can read.
Brand ID.
^brd_[0-9a-f]{32}$"brd_3f9c0a1b2c3d4e5f60718293a4b5c6d7"
The brand name.
"Northwind Coffee"
The brand description, if one was set.
"Specialty coffee roasted in small batches."
The brand website, if one was set.
"https://northwind.example"
The brand color as a hex value, if one was set.
"#1F6FEB"
active brands can run campaigns. inactive brands are archived.
active, inactive "active"
When the brand was created.
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$"2026-09-02T10:15:00.000Z"
When the brand was last changed. Null if it never changed.
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$"2026-09-20T08:40:00.000Z"