Set Competitor Customer Verdict

PATCH

competitors

{id}

customers

{customerId}

curl -X PATCH https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/customers/ccus_3jm919aa345jdss56074sb5vy2 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"verdict": "rejected"}'

import requests

requests.patch(
    "https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/customers/ccus_3jm919aa345jdss56074sb5vy2",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"verdict": "rejected"},
)

await fetch("https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/customers/ccus_3jm919aa345jdss56074sb5vy2", {
  method: "PATCH",
  headers: { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ verdict: "rejected" }),
});

{
  "success": true,
  "data": {
    "clustr_competitor_customer_id": "ccus_3jm919aa345jdss56074sb5vy2",
    "id": "8b4e2f6a-1c3d-4e5f-9a7b-0c2d4e6f8a1b",
    "user_verdict": "rejected",
    "renewal_date": null
  }
}

{
  "success": false,
  "error": { "message": "Competitor customer not found", "code": "NOT_FOUND" }
}

Confirm or reject a customer Clustr found for a competitor, or clear your verdict, and record its renewal date when you know it. Send only the field you change. A rejected customer is hidden everywhere, and the search never adds it back. A confirmed one is labelled confirmed whatever its signals. Send null (or "clear") to clear the verdict. renewal_date is always the one you or a teammate recorded, for example after the account owner found it out through a renewal task.

curl -X PATCH https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/customers/ccus_3jm919aa345jdss56074sb5vy2 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"verdict": "rejected"}'

import requests

requests.patch(
    "https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/customers/ccus_3jm919aa345jdss56074sb5vy2",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"verdict": "rejected"},
)

await fetch("https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/customers/ccus_3jm919aa345jdss56074sb5vy2", {
  method: "PATCH",
  headers: { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ verdict: "rejected" }),
});

{
  "success": true,
  "data": {
    "clustr_competitor_customer_id": "ccus_3jm919aa345jdss56074sb5vy2",
    "id": "8b4e2f6a-1c3d-4e5f-9a7b-0c2d4e6f8a1b",
    "user_verdict": "rejected",
    "renewal_date": null
  }
}

{
  "success": false,
  "error": { "message": "Competitor customer not found", "code": "NOT_FOUND" }
}

Authorizations

Authorization

string

header

required

The API key you created on the API settings page of the Clustr app.

Path Parameters

string

required

The competitor's Clustr ID (cmp_…), from List Competitors. The id from earlier responses also works.

customerId

string

required

The customer's Clustr ID (ccus_…), from List Competitor Customers. The id from earlier responses also works.

Body

application/json

verdict

enum<string> | null

The verdict: confirmed or rejected. Send null or clear to clear it.

Available options:

confirmed,

rejected,

clear,

null

renewal_date

string | null

The date the customer's contract renews, as YYYY-MM-DD. Send null or clear to remove it.

Example:

"2027-03-31"

Response

The verdict, as saved

success

boolean

required

Example:

true

data

object

required

Show child attributes

curl -X PATCH https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/customers/ccus_3jm919aa345jdss56074sb5vy2 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"verdict": "rejected"}'

import requests

requests.patch(
    "https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/customers/ccus_3jm919aa345jdss56074sb5vy2",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"verdict": "rejected"},
)

await fetch("https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/customers/ccus_3jm919aa345jdss56074sb5vy2", {
  method: "PATCH",
  headers: { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ verdict: "rejected" }),
});

{
  "success": true,
  "data": {
    "clustr_competitor_customer_id": "ccus_3jm919aa345jdss56074sb5vy2",
    "id": "8b4e2f6a-1c3d-4e5f-9a7b-0c2d4e6f8a1b",
    "user_verdict": "rejected",
    "renewal_date": null
  }
}

{
  "success": false,
  "error": { "message": "Competitor customer not found", "code": "NOT_FOUND" }
}

API Reference

Import

Search

Jobs

Network

Opportunities

Owners

Accounts

Account States

Saved Views

Workflows

Intro Requests

Notes

Record Activity

Tags

Target Accounts

Client Companies

Excluded Companies

Buyer Titles

ICP

Competitor Monitoring

Connector Refresh

Notifications

Set Competitor Customer Verdict

Authorizations

Path Parameters

Body

Response