Get Owner

GET

owners

{id}

curl "https://api.clustr-ai.com/api/public/owners/9c8e77d1-4b2a-4c8f-9a30-6e21d4f0aa57" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": {
    "owner": {
      "id": "9c8e77d1-4b2a-4c8f-9a30-6e21d4f0aa57",
      "email": "sam@northstar.vc",
      "first_name": "Sam",
      "last_name": "Okafor",
      "name": "Sam Okafor",
      "avatar_url": "",
      "is_member": false,
      "source": "manual",
      "opportunity_count": 0
    }
  }
}

{
  "success": false,
  "error": { "message": "Invalid id format", "code": "BAD_REQUEST" }
}

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

{
  "success": false,
  "error": { "message": "Invalid or missing API key", "code": "UNAUTHORIZED" }
}

Fetch a single owner by ID. Use List Owners to find the ID, or keep the id returned by Create Owner. Deletes are soft, but a deleted owner is gone from this endpoint. It returns 404, exactly as it would for an ID that never existed.

opportunity_count is always 0 here. Counting the opportunities an owner holds costs a lookup per owner, so it is only done by List Owners with with_counts=true.

Path Parameters

string

required

Owner UUID. A value that is not a UUID returns 400, not 404.

Response Fields

object

The owner.

string

Owner UUID. Pass this as owner_id when updating an opportunity.

string

Email address. Pass this as owner_email when updating an opportunity.

string

First name, empty when the owner has none.

string

Last name, empty when the owner has none.

string

Display name. First and last name joined, falling back to the email address when the owner has no name, and to Unknown owner when it has neither.

string

Profile picture URL, empty when the owner has no picture.

boolean

true when the owner is also a member of your workspace with a login, false for a directory-only owner.

string

How the owner got into the directory: user for one provisioned automatically from a workspace member, manual for Create Owner, csv for Import Owners, api for one created by passing owner_email with create_owner_if_missing to Update Opportunity.

integer

Always 0 on this endpoint. See the note above.

curl "https://api.clustr-ai.com/api/public/owners/9c8e77d1-4b2a-4c8f-9a30-6e21d4f0aa57" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": {
    "owner": {
      "id": "9c8e77d1-4b2a-4c8f-9a30-6e21d4f0aa57",
      "email": "sam@northstar.vc",
      "first_name": "Sam",
      "last_name": "Okafor",
      "name": "Sam Okafor",
      "avatar_url": "",
      "is_member": false,
      "source": "manual",
      "opportunity_count": 0
    }
  }
}

{
  "success": false,
  "error": { "message": "Invalid id format", "code": "BAD_REQUEST" }
}

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

{
  "success": false,
  "error": { "message": "Invalid or missing API key", "code": "UNAUTHORIZED" }
}

curl "https://api.clustr-ai.com/api/public/owners/9c8e77d1-4b2a-4c8f-9a30-6e21d4f0aa57" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": {
    "owner": {
      "id": "9c8e77d1-4b2a-4c8f-9a30-6e21d4f0aa57",
      "email": "sam@northstar.vc",
      "first_name": "Sam",
      "last_name": "Okafor",
      "name": "Sam Okafor",
      "avatar_url": "",
      "is_member": false,
      "source": "manual",
      "opportunity_count": 0
    }
  }
}

{
  "success": false,
  "error": { "message": "Invalid id format", "code": "BAD_REQUEST" }
}

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

{
  "success": false,
  "error": { "message": "Invalid or missing API key", "code": "UNAUTHORIZED" }
}

API Reference

Import

Search

Jobs

Network

Opportunities

Owners

Target Accounts

ICP

Competitor Monitoring

Path Parameters

Response Fields

​Path Parameters

​Response Fields

Path Parameters

Response Fields