---
title: "Get customers (v4)"
method: GET
path: "/api/v1/business/customers-v4/{id}"
tags: ["business"]
---

# Get customers (v4)

`GET /api/v1/business/customers-v4/{id}`

## Request

- Base URL: `https://point11.ai`
- URL: `https://point11.ai/api/v1/business/customers-v4/{id}`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://auth.point11.ai/oauth2/authorize`, token URL `https://auth.point11.ai/oauth2/token`)

Get one customer by its id, customer key, or the id of the run that generated it: its current version as the customer model states it (persona: every attribute under its key, in the model's groups and order; each category as its id and label; Age, Household income and Company size with the band stored beside them; Employer with its source link; Household; Product; Buyer type, derived from the audience's declared type, with the attributes only the other buyer type has left out), its editable fields by the same keys with the options each category and band may take (a fixed list whole; an open category's profile options and the values members added for its business profile, marked memberAdded), its audiences and sources, any CRM field pins and open pin reviews by field, and its latest activity in Discovery, Experience, and Research.

## Path parameters

- `id` string, required: The customer's id or customer key, or the id of the run that generated it

## Headers

- `Point11-Organization` string, uuid

## Response `200`

Success.

- BusinessCustomersGetV4Response
  - `id` string, uuid, required
  - `customerKey` string, required
  - `businessProfileId` string, uuid, required
  - `brandProfileId` string, uuid, required
  - `businessProfileKey` string, nullable, required
  - `profileLabel` string, required
  - `hasOtherProfileCustomers` boolean, required
  - `storeProfile` object, nullable, required
    - `locationKey` string, required
    - `label` string, required
    - `locality` string, nullable, required
  - `profileStoreCount` integer, required
  - `generationProfileId` string, uuid, nullable, required
  - `generatedByRunId` string, uuid, nullable, required
  - `source` 'generated' | 'manual' | 'connected', required
  - `poolStatus` 'active' | 'retired', required
  - `retiredAt` string, date-time, nullable, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `currentVersion` object, required
    - `customerVersionId` string, uuid, required
    - `version` integer, required
  - `audiences` object[], required
    - `id` string, uuid, required
    - `name` string, required
    - `kind` 'source' | 'system-audience' | 'user-audience', required
  - `interviewEligible` boolean, required
  - `campaignName` string, required
  - `activity` object, required
    - `discovery` boolean, required
    - `experience` boolean, required
    - `research` boolean, required
  - `latestActivity` union, required
    - object
      - `product` 'discovery', required
      - `id` string, required
      - `campaignId` string, uuid, nullable, required
      - `occurredAt` string, date-time, required
      - `outcome` DiscoveryItemLatestDiscoveryOutcome, nullable, required
        - `result` 'won' | 'lost', required
        - `brand` string, required
        - `color` string, nullable
        - `source` object, nullable
          - `url` string, nullable, required
          - `label` string, required
          - `faviconUrl` string, nullable, required
          - `faviconTone` 'dark' | 'light' | 'mixed' | 'unknown', nullable
          - `faviconTransparent` boolean, nullable
          - `faviconNeedsLightBackplate` boolean, nullable
          - `faviconNeedsDarkBackplate` boolean, nullable
          - `color` string, nullable
    - BusinessLatestActivity
      - `product` 'experience' | 'research', required
      - `id` string, required
      - `campaignId` string, uuid, nullable, required
      - `occurredAt` string, date-time, required
      - `label` string, required
      - `status` 'scheduled' | 'waiting' | 'running' | 'completed' | 'failed' | 'cancelled', nullable, required
  - `latestDiscoveryResult` 'won' | 'lost', nullable, required
  - `persona` BusinessPersona, required: The customer's current version under the customer model's keys, in its order. An attribute only consumers or only organizations have is absent for the other buyer type.
    - `name` string, nullable, required: Name: The person's name. There is one name; there is no separate display name.
    - `gender` object, nullable, required: Gender: Their gender.
      - `id` string, required
      - `label` string, nullable, required: What the customer's profile calls it; null when nothing names it
    - `age` object, required: Age: Their age in years, with its band beside it.
      - `value` string, nullable, required
      - `band` object, nullable, required
        - `id` string, required
        - `label` string, nullable, required: What the customer's profile calls it; null when nothing names it
    - `language` object, nullable, required: Language: The language they use with an assistant.
      - `id` string, required
      - `label` string, nullable, required: What the customer's profile calls it; null when nothing names it
    - `location` object, required: Location: Where they live. An address, not a segment. Place names print from the codes.
      - `countryCode` string, nullable, required
      - `subdivisionCode` string, nullable, required
      - `locality` string, nullable, required
      - `postalCode` string, nullable, required
      - `street` string, nullable, required
      - `latitude` number, nullable, required
      - `longitude` number, nullable, required
      - `coordinateSource` 'source' | 'derived_descendants' | 'unavailable' | 'street_address', nullable, required
      - `country` string, nullable, required
      - `subdivision` string, nullable, required
      - `label` string, nullable, required
    - `market` object, nullable, required: Market: The Profile market they were planned in. A segment, not an address.
      - `id` string, required
      - `label` string, nullable, required: What the customer's profile calls it; null when nothing names it
    - `areaType` object, nullable, required: Area type: Urban core, suburban, town or rural.
      - `id` string, required
      - `label` string, nullable, required: What the customer's profile calls it; null when nothing names it
    - `education` object, nullable, required: Education: The highest level they completed.
      - `id` string, required
      - `label` string, nullable, required: What the customer's profile calls it; null when nothing names it
    - `lifeStage` object, nullable: Life stage: Where they are in life, student through retired.
      - `id` string, required
      - `label` string, nullable, required: What the customer's profile calls it; null when nothing names it
    - `household` object, nullable: Household: Who they live with.
      - `adults` integer, nullable, required
      - `children` integer, nullable, required
      - `pets` integer, nullable, required
    - `householdIncome` object: Household income: The household's yearly income.
      - `value` string, nullable, required
      - `band` object, nullable, required
        - `id` string, required
        - `label` string, nullable, required: What the customer's profile calls it; null when nothing names it
    - `jobTitle` string, nullable, required: Job title: Their actual job. Not their role in the purchase.
    - `occupation` object, nullable: Occupation: The category of a consumer's job title.
      - `id` string, required
      - `label` string, nullable, required: What the customer's profile calls it; null when nothing names it
    - `seniority` object, nullable: Seniority: The level of a business buyer's job title.
      - `id` string, required
      - `label` string, nullable, required: What the customer's profile calls it; null when nothing names it
    - `employer` object, required: Employer: Where they work.
      - `value` string, nullable, required
      - `link` string, nullable, required
    - `yearsInRole` string, nullable, required: Years in role: How long they have held the job title.
    - `companySize` object: Company size: Their organization's employee count. Not its revenue (Annual revenue).
      - `value` string, nullable, required
      - `band` object, nullable, required
        - `id` string, required
        - `label` string, nullable, required: What the customer's profile calls it; null when nothing names it
    - `annualRevenue` string, nullable: Annual revenue: Their organization's yearly revenue.
    - `buyerType` 'consumer' | 'organization', nullable, required: Buyer type: Who is buying: a person or household, or an organization. It decides which attributes apply.
    - `audience` object, nullable, required: Audience: The Profile audience they belong to.
      - `id` string, required
      - `label` string, nullable, required: What the customer's profile calls it; null when nothing names it
    - `product` object, nullable, required: Product: The product they would buy.
      - `id` string, required
      - `label` string, nullable, required: What the customer's profile calls it; null when nothing names it
    - `channel` object, nullable, required: Channel: Where they buy it.
      - `id` string, required
      - `label` string, nullable, required: What the customer's profile calls it; null when nothing names it
    - `buyerRole` object, nullable, required: Buyer role: Their own part in the decision, such as decider or influencer. Not anyone else in the decision (Stakeholders).
      - `id` string, required
      - `label` string, nullable, required: What the customer's profile calls it; null when nothing names it
    - `stakeholders` string, nullable, required: Stakeholders: Everyone else in the decision, and their stance.
    - `intentStage` object, nullable, required: Intent stage: Awareness, consideration or decision.
      - `id` string, required
      - `label` string, nullable, required: What the customer's profile calls it; null when nothing names it
    - `budget` string, nullable, required: Budget: What they can spend, and how price-sensitive they are. Not a hard limit.
    - `constraints` string, nullable, required: Constraints: Hard limits that can block the purchase. Budget appears here only when it is a hard limit.
    - `job` object, nullable, required: Job to be done: The Profile's category of progress they are after. Not how they want to feel (Emotional need) or be seen (Social need), nor how they will judge success (Desired outcome).
      - `id` string, required
      - `label` string, nullable, required: What the customer's profile calls it; null when nothing names it
    - `situation` string, nullable, required: Situation: Their circumstances today: the steady state.
    - `triggerType` object, nullable, required: Trigger type: The category of the trigger.
      - `id` string, required
      - `label` string, nullable, required: What the customer's profile calls it; null when nothing names it
    - `trigger` string, nullable, required: Trigger: What changed that started them looking now.
    - `functionalNeed` string, nullable, required: Functional need: What they are trying to get done, in their own words.
    - `emotionalNeed` string, nullable, required: Emotional need: How they want to feel.
    - `socialNeed` string, nullable, required: Social need: How they want to be seen.
    - `desiredOutcome` string, nullable, required: Desired outcome: How they will judge success once it is done. Not the progress they are after (Job to be done).
    - `labels` object[], required: Labels: The lists a member put them on.
      - `id` string, required
      - `label` string, required
  - `editable` BusinessEditable, required: The fields as business_customers_update_v4 edits them: a category as its id, a banded attribute as its value and band id, the household as its counts, the place as its codes and names
    - `name` string, nullable, required
    - `gender` string, nullable, required
    - `age` object, required
      - `value` string, nullable, required
      - `band` string, nullable, required
    - `language` string, nullable, required
    - `location` object, required
      - `countryCode` string, nullable, required
      - `subdivisionCode` string, nullable, required
      - `locality` string, nullable, required
      - `postalCode` string, nullable, required
      - `country` string, nullable, required
      - `subdivision` string, nullable, required
    - `market` string, nullable, required
    - `areaType` string, nullable, required
    - `education` string, nullable, required
    - `lifeStage` string, nullable
    - `household` object, nullable
      - `adults` integer, nullable, required
      - `children` integer, nullable, required
      - `pets` integer, nullable, required
    - `householdIncome` object
      - `value` string, nullable, required
      - `band` string, nullable, required
    - `jobTitle` string, nullable, required
    - `occupation` string, nullable
    - `seniority` string, nullable
    - `employer` string, nullable, required
    - `yearsInRole` string, nullable, required
    - `companySize` object
      - `value` string, nullable, required
      - `band` string, nullable, required
    - `annualRevenue` string, nullable
    - `audience` string, nullable, required
    - `product` string, nullable, required
    - `channel` string, nullable, required
    - `buyerRole` string, nullable, required
    - `stakeholders` string, nullable, required
    - `intentStage` string, nullable, required
    - `budget` string, nullable, required
    - `constraints` string, nullable, required
    - `job` string, nullable, required
    - `situation` string, nullable, required
    - `triggerType` string, nullable, required
    - `trigger` string, nullable, required
    - `functionalNeed` string, nullable, required
    - `emotionalNeed` string, nullable, required
    - `socialNeed` string, nullable, required
    - `desiredOutcome` string, nullable, required
  - `pins` BusinessPins, nullable, required
    - `provider` 'hubspot' | 'salesforce', required
    - `pins` object[], required
      - `id` string, uuid, required
      - `field` 'name' | 'gender' | 'age' | 'language' | 'location' | 'market' | 'areaType' | 'education' | 'lifeStage' | 'household' | 'householdIncome' | 'jobTitle' | 'occupation' | 'seniority' | 'employer' | 'yearsInRole' | 'companySize' | 'annualRevenue' | 'audience' | 'product' | 'channel' | 'buyerRole' | 'stakeholders' | 'intentStage' | 'budget' | 'constraints' | 'job' | 'situation' | 'triggerType' | 'trigger' | 'functionalNeed' | 'emotionalNeed' | 'socialNeed' | 'desiredOutcome', required
      - `pinnedAt` string, date-time, required
      - `review` object, nullable, required
        - `refreshId` string, uuid, required
        - `raisedAt` string, date-time, required
        - `crmValue` string, nullable, required
  - `bucketOptions` BusinessBucketOptions, required: Each category's options for this customer, and each banded attribute's bands: a fixed list whole, an open category's profile options then the values members added for its business profile; the ids business_customers_update_v4 takes
    - `gender` object[], required
      - `id` string, required
      - `label` string, required
      - `memberAdded` boolean, required: A value a member added for this business profile (with newValues), not one of its profile's or the fixed list's
      - `audienceType` 'b2b' | 'b2c' | 'prosumer' | 'mixed', nullable: An audience option's buying entity as its profile declares it: b2b (an organization, whose employer facts apply) or b2c (a household, whose occupation applies); null when it declares neither, absent on every other field
    - `age` object[], required
      - `id` string, required
      - `label` string, required
      - `memberAdded` boolean, required: A value a member added for this business profile (with newValues), not one of its profile's or the fixed list's
      - `audienceType` 'b2b' | 'b2c' | 'prosumer' | 'mixed', nullable: An audience option's buying entity as its profile declares it: b2b (an organization, whose employer facts apply) or b2c (a household, whose occupation applies); null when it declares neither, absent on every other field
    - `language` object[], required
      - `id` string, required
      - `label` string, required
      - `memberAdded` boolean, required: A value a member added for this business profile (with newValues), not one of its profile's or the fixed list's
      - `audienceType` 'b2b' | 'b2c' | 'prosumer' | 'mixed', nullable: An audience option's buying entity as its profile declares it: b2b (an organization, whose employer facts apply) or b2c (a household, whose occupation applies); null when it declares neither, absent on every other field
    - `market` object[], required
      - `id` string, required
      - `label` string, required
      - `memberAdded` boolean, required: A value a member added for this business profile (with newValues), not one of its profile's or the fixed list's
      - `audienceType` 'b2b' | 'b2c' | 'prosumer' | 'mixed', nullable: An audience option's buying entity as its profile declares it: b2b (an organization, whose employer facts apply) or b2c (a household, whose occupation applies); null when it declares neither, absent on every other field
    - `areaType` object[], required
      - `id` string, required
      - `label` string, required
      - `memberAdded` boolean, required: A value a member added for this business profile (with newValues), not one of its profile's or the fixed list's
      - `audienceType` 'b2b' | 'b2c' | 'prosumer' | 'mixed', nullable: An audience option's buying entity as its profile declares it: b2b (an organization, whose employer facts apply) or b2c (a household, whose occupation applies); null when it declares neither, absent on every other field
    - `education` object[], required
      - `id` string, required
      - `label` string, required
      - `memberAdded` boolean, required: A value a member added for this business profile (with newValues), not one of its profile's or the fixed list's
      - `audienceType` 'b2b' | 'b2c' | 'prosumer' | 'mixed', nullable: An audience option's buying entity as its profile declares it: b2b (an organization, whose employer facts apply) or b2c (a household, whose occupation applies); null when it declares neither, absent on every other field
    - `lifeStage` object[]
      - `id` string, required
      - `label` string, required
      - `memberAdded` boolean, required: A value a member added for this business profile (with newValues), not one of its profile's or the fixed list's
      - `audienceType` 'b2b' | 'b2c' | 'prosumer' | 'mixed', nullable: An audience option's buying entity as its profile declares it: b2b (an organization, whose employer facts apply) or b2c (a household, whose occupation applies); null when it declares neither, absent on every other field
    - `householdIncome` object[]
      - `id` string, required
      - `label` string, required
      - `memberAdded` boolean, required: A value a member added for this business profile (with newValues), not one of its profile's or the fixed list's
      - `audienceType` 'b2b' | 'b2c' | 'prosumer' | 'mixed', nullable: An audience option's buying entity as its profile declares it: b2b (an organization, whose employer facts apply) or b2c (a household, whose occupation applies); null when it declares neither, absent on every other field
    - `occupation` object[]
      - `id` string, required
      - `label` string, required
      - `memberAdded` boolean, required: A value a member added for this business profile (with newValues), not one of its profile's or the fixed list's
      - `audienceType` 'b2b' | 'b2c' | 'prosumer' | 'mixed', nullable: An audience option's buying entity as its profile declares it: b2b (an organization, whose employer facts apply) or b2c (a household, whose occupation applies); null when it declares neither, absent on every other field
    - `seniority` object[]
      - `id` string, required
      - `label` string, required
      - `memberAdded` boolean, required: A value a member added for this business profile (with newValues), not one of its profile's or the fixed list's
      - `audienceType` 'b2b' | 'b2c' | 'prosumer' | 'mixed', nullable: An audience option's buying entity as its profile declares it: b2b (an organization, whose employer facts apply) or b2c (a household, whose occupation applies); null when it declares neither, absent on every other field
    - `companySize` object[]
      - `id` string, required
      - `label` string, required
      - `memberAdded` boolean, required: A value a member added for this business profile (with newValues), not one of its profile's or the fixed list's
      - `audienceType` 'b2b' | 'b2c' | 'prosumer' | 'mixed', nullable: An audience option's buying entity as its profile declares it: b2b (an organization, whose employer facts apply) or b2c (a household, whose occupation applies); null when it declares neither, absent on every other field
    - `audience` object[], required
      - `id` string, required
      - `label` string, required
      - `memberAdded` boolean, required: A value a member added for this business profile (with newValues), not one of its profile's or the fixed list's
      - `audienceType` 'b2b' | 'b2c' | 'prosumer' | 'mixed', nullable: An audience option's buying entity as its profile declares it: b2b (an organization, whose employer facts apply) or b2c (a household, whose occupation applies); null when it declares neither, absent on every other field
    - `product` object[], required
      - `id` string, required
      - `label` string, required
      - `memberAdded` boolean, required: A value a member added for this business profile (with newValues), not one of its profile's or the fixed list's
      - `audienceType` 'b2b' | 'b2c' | 'prosumer' | 'mixed', nullable: An audience option's buying entity as its profile declares it: b2b (an organization, whose employer facts apply) or b2c (a household, whose occupation applies); null when it declares neither, absent on every other field
    - `channel` object[], required
      - `id` string, required
      - `label` string, required
      - `memberAdded` boolean, required: A value a member added for this business profile (with newValues), not one of its profile's or the fixed list's
      - `audienceType` 'b2b' | 'b2c' | 'prosumer' | 'mixed', nullable: An audience option's buying entity as its profile declares it: b2b (an organization, whose employer facts apply) or b2c (a household, whose occupation applies); null when it declares neither, absent on every other field
    - `buyerRole` object[], required
      - `id` string, required
      - `label` string, required
      - `memberAdded` boolean, required: A value a member added for this business profile (with newValues), not one of its profile's or the fixed list's
      - `audienceType` 'b2b' | 'b2c' | 'prosumer' | 'mixed', nullable: An audience option's buying entity as its profile declares it: b2b (an organization, whose employer facts apply) or b2c (a household, whose occupation applies); null when it declares neither, absent on every other field
    - `intentStage` object[], required
      - `id` string, required
      - `label` string, required
      - `memberAdded` boolean, required: A value a member added for this business profile (with newValues), not one of its profile's or the fixed list's
      - `audienceType` 'b2b' | 'b2c' | 'prosumer' | 'mixed', nullable: An audience option's buying entity as its profile declares it: b2b (an organization, whose employer facts apply) or b2c (a household, whose occupation applies); null when it declares neither, absent on every other field
    - `job` object[], required
      - `id` string, required
      - `label` string, required
      - `memberAdded` boolean, required: A value a member added for this business profile (with newValues), not one of its profile's or the fixed list's
      - `audienceType` 'b2b' | 'b2c' | 'prosumer' | 'mixed', nullable: An audience option's buying entity as its profile declares it: b2b (an organization, whose employer facts apply) or b2c (a household, whose occupation applies); null when it declares neither, absent on every other field
    - `triggerType` object[], required
      - `id` string, required
      - `label` string, required
      - `memberAdded` boolean, required: A value a member added for this business profile (with newValues), not one of its profile's or the fixed list's
      - `audienceType` 'b2b' | 'b2c' | 'prosumer' | 'mixed', nullable: An audience option's buying entity as its profile declares it: b2b (an organization, whose employer facts apply) or b2c (a household, whose occupation applies); null when it declares neither, absent on every other field

## Other responses

- `400`: The input, query, or Idempotency-Key is invalid.
- `401`: The bearer is missing, expired, or not accepted.
- `403`: The credential lacks the operation's scope or role, or the operation needs a different door.
- `404`: The resource or organization does not exist for this caller.
- `405`: This path takes another HTTP method, named in `Allow`.
- `409`: The request conflicts with current state or with prior use of its Idempotency-Key.
- `413`: The request, or the answer it asks for, is too large; narrow it.
- `429`: The credential's rate budget is spent; retry after `Retry-After` seconds.
- `500`: An unexpected server failure; retry later. Only `request_id` identifies it.
- `503`: A dependency is temporarily unavailable; retry after `Retry-After` seconds.
- `default`: Another status a product answers for its own refusal (for example `415` for an unsupported attachment); branch on `code`.

---

[API](https://skmtc.dev/point11/apis/point11-api.md) · [All operations](https://skmtc.dev/point11/apis/point11-api/llms.txt) · [OpenAPI document](https://skmtc.dev/point11/apis/point11-api/revisions/36a84c7aca11?raw)