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

# Get store profiles (v2)

`GET /api/v1/business/store-profiles-v2/{id}`

## Request

- Base URL: `https://point11.ai`
- URL: `https://point11.ai/api/v1/business/store-profiles-v2/{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 store's profile by its location key (id) under a brand business profile (profileKey: the brand's id or profile key, or the store's own place profile's): the store's own researched content and its place among the brand's stores. A store is a place profile of its own (placeProfileId), whose newest version this reads and which business_profiles_refresh re-researches; a store known only by research from before stores were profiles of their own answers that research, read-only, with placeProfileId null, and business_profiles_generate's place gives it a profile. Competitors keep the research's order, and a value the research left empty is null. A physical-locations campaign's setup researches one per verified premises; list them in the brand's business_profiles_get_v2 locations tab.

## Path parameters

- `id` string, required: The store's location key

## Query parameters

- `profileKey` string, required: The brand business profile's id or profile key, or the store's own place profile's
- `tab` 'revenue' | 'audiences' | 'channels' | 'locations' | 'competitors' | 'about'

## Headers

- `Point11-Organization` string, uuid

## Response `200`

Success.

- BusinessStoreProfilesGetV2Response
  - `businessProfileId` string, uuid, required
  - `profileKey` string, required
  - `locationKey` string, required
  - `placeProfileId` string, uuid, nullable, required
  - `storeLabel` string, required
  - `brandName` string, required
  - `profile` BusinessProfile4, required
    - `id` string, required
    - `name` string, required
    - `hostname` string, required
    - `recordStatus` 'active' | 'archived' | 'deleted', required
    - `forecastRecordStatus` 'active' | 'archived' | 'deleted', nullable, required
    - `profileArtifactAvailable` boolean, required
    - `profileLatestAttemptState` 'running' | 'succeeded' | 'failed' | 'cancelled' | 'partial', nullable, required
    - `profileGenerationProgress` object, nullable, required
      - `state` string, required
      - `label` string, required
      - `takingLonger` boolean, required
      - `executionStatus` 'waiting' | 'running', required
    - `forecastArtifactAvailable` boolean, required
    - `forecastLatestAttemptState` 'running' | 'succeeded' | 'failed' | 'cancelled' | 'partial', nullable, required
    - `forecastGenerationProgress` object, nullable, required
      - `state` string, required
      - `label` string, required
      - `takingLonger` boolean, required
      - `executionStatus` 'waiting' | 'running', required
    - `updatedAt` string, date-time, required
    - `providerCount` integer, nullable, required
    - `profileQuality` 'complete' | 'limited_evidence', required
    - `generatedByRunId` string, nullable, required
    - `forecastGeneratedByRunId` string, nullable, required
    - `detail` object, nullable, required
      - `hero` object, required
        - `about` string, required
        - `mission` string, required
        - `tags` string[], required
      - `facts` object[], required
        - `label` string, required
        - `value` string, required
        - `citations` string[], required
      - `revenue` BusinessRevenue, required
        - `descriptor` string, required
        - `mix` object[], required
          - `id` string, required
          - `label` string, required
          - `percent` number, required
          - `revenue` string, nullable
          - `subs` string, nullable, required
        - `headline` object, required
          - `value` string, required
          - `period` string, required
          - `growth` string, nullable, required
        - `annualRevenue` string, nullable
        - `growthEngine` object[], required
          - `editPath` string
          - `leadEditPath` string
          - `lead` string, required
          - `body` string, required
        - `citations` object, required
          - `title` string[], required
          - `mix` string[], required
          - `growthEngine` string[], required
      - `overview` object[]
        - `editPath` string
        - `leadEditPath` string
        - `lead` string, required
        - `body` string, required
      - `operations` object
        - `operatingModel` object[], required
          - `editPath` string
          - `leadEditPath` string
          - `lead` string, required
          - `body` string, required
        - `costStructure` object[], required
          - `editPath` string
          - `leadEditPath` string
          - `lead` string, required
          - `body` string, required
        - `citations` object, required
          - `operatingModel` string[], required
          - `costStructure` string[], required
      - `assets` object
        - `assetBase` object[], required
          - `editPath` string
          - `leadEditPath` string
          - `lead` string, required
          - `body` string, required
        - `citations` object, required
          - `assetBase` string[], required
      - `leaders` object[]
        - `bioEditPath` string
        - `title` string
        - `tenureStart` number, nullable
        - `editPath` string
        - `initials` string, required
        - `name` string, required
        - `role` string, required
        - `bio` string, required
      - `ownership` BusinessOwnership
        - `type` string, required
        - `note` string, nullable, required
        - `parentCompany` string, nullable, required
        - `publicTicker` string, nullable, required
        - `holderFinding` object, required
          - `status` 'material_holders_identified' | 'widely_held_no_controlling_holder' | 'none_identified_after_research' | 'unavailable', required
          - `statement` string, required
          - `citations` string[], required
        - `owners` object[], required
          - `editPath` string
          - `name` string, required
          - `type` string, required
          - `description` string, nullable, required
          - `estimatedOwnership` string, nullable, required
          - `estimatedOwnershipBasis` string, nullable, required
        - `history` object[], required
          - `editPath` string
          - `year` string, required
          - `label` string, required
          - `transition` string, required
        - `citations` object, required
          - `structure` string[], required
          - `owners` string[], required
          - `holder` string[], required
          - `history` string[], required
      - `financials` object
        - `actuals` object[], required
          - `label` string, required
          - `value` string, required
          - `unit` string, nullable, required
          - `citations` string[], required
          - `meta` string[]
        - `citations` object, required
          - `actuals` string[], required
      - `audiences` BusinessAudiences
        - `descriptor` string, required
        - `rows` object[], required
          - `id` string
          - `name` string, required
          - `audienceType` string, nullable
          - `revenue` string, nullable, required
          - `share` string, required
        - `total` object, required
          - `revenue` string, nullable, required
          - `share` string, required
        - `kpis` object[], required
          - `label` string, required
          - `value` string, required
          - `unit` string, nullable, required
          - `delta` object, nullable, required
            - `text` string, required
            - `direction` 'up' | 'down' | 'neutral', required
          - `citations` string[], required
        - `valueProposition` object[], required
          - `editPath` string
          - `leadEditPath` string
          - `lead` string, required
          - `body` string, required
        - `drivers` object[], required
          - `editPath` string
          - `leadEditPath` string
          - `lead` string, required
          - `body` string, required
        - `citations` object, required
          - `audiences` string[], required
          - `valueProposition` string[], required
      - `history` object[]
        - `editPaths` object
          - `marker` string, required
          - `body` string, required
        - `marker` string, required
        - `body` string, required
        - `major` boolean, required
        - `citations` string[], required
      - `geography` BusinessGeography
        - `descriptor` string, required
        - `projection` object, required
          - `status` 'complete' | 'partial' | 'unmappable', required
          - `rows` object[], required
            - `id` string, required
            - `name` string, required
            - `weightPct` number, required
            - `classification` string, nullable, required
            - `marketSize` string, required
            - `revenueWeightBasis` string, nullable, required
            - `evidence` string, nullable, required
            - `projection` object, required
              - …
          - `scopes` object[], required
            - `id` string, required
            - `label` string, required
            - `level` 'country' | 'admin1' | 'postal', required
            - `countryCode` string
            - `admin1Code` string
            - `data` object[], required
              - …
            - `groups` object[], required
              - …
          - `defaultScopeId` string, nullable, required
          - `mappedRowCount` integer, required
          - `mappedWeightPct` number, required
          - `unmappedRowCount` integer, required
          - `unmappedWeightPct` number, required
        - `revenue` object, required
          - `byLocationId` object, required
          - `total` object, required
            - `revenue` string, nullable, required
            - `share` string, required
        - `siteCampaign` object, nullable, required
          - `name` string, required
          - `href` string, required
        - `storeProfiles` object[], required
          - `locationKey` string, required
          - `label` string, required
          - `locality` string, nullable, required
          - `latitude` number, nullable, required
          - `longitude` number, nullable, required
          - `customerCount` integer, required
          - `href` string, required
        - `kpis` object[], required
          - `label` string, required
          - `value` string, required
          - `unit` string, nullable, required
          - `delta` object, nullable, required
            - `text` string, required
            - `direction` 'up' | 'down' | 'neutral', required
          - `citations` string[], required
        - `citations` object, required
          - `descriptor` string[], required
      - `channelMix` BusinessChannelMix
        - `descriptor` string, required
        - `rows` object[], required
          - `id` string
          - `name` string, required
          - `revenue` string, nullable, required
          - `share` string, required
          - `depth` union, required
            - 0
            - 1
        - `total` object, required
          - `revenue` string, nullable, required
          - `share` string, required
        - `volume` object, required
          - `value` string, required
          - `period` string, required
        - `kpis` object[], required
          - `label` string, required
          - `value` string, required
          - `unit` string, nullable, required
          - `delta` object, nullable, required
            - `text` string, required
            - `direction` 'up' | 'down' | 'neutral', required
          - `citations` string[], required
        - `drivers` object[], required
          - `editPath` string
          - `leadEditPath` string
          - `lead` string, required
          - `body` string, required
        - `citations` object, required
          - `descriptor` string[], required
      - `competitors` object
        - `descriptor` string, required
        - `rows` object[], required
          - `editPaths` object
            - `name` string, required
            - `note` string
            - `overlap` string[], required
            - `intensity` string
            - `trend` string
          - `name` string, required
          - `note` string, nullable, required
          - `intensityPct` number, nullable, required
          - `intensity` string, nullable, required
          - `overlap` string, nullable, required
          - `trendDirection` 'rising' | 'stable' | 'declining', nullable, required
          - `trendDeltaPct` number, nullable, required
        - `kpis` object[], required
          - `label` string, required
          - `value` string, required
          - `unit` string, nullable, required
          - `delta` object, nullable, required
            - `text` string, required
            - `direction` 'up' | 'down' | 'neutral', required
          - `citations` string[], required
        - `battlegrounds` object[], required
          - `editPath` string
          - `leadEditPath` string
          - `lead` string, required
          - `body` string, required
          - `competitors` string[], required
        - `citations` object, required
          - `descriptor` string[], required
      - `environment` BusinessEnvironment
        - `descriptor` string, required
        - `regulatory` object[], required
          - `editPath` string
          - `leadEditPath` string
          - `lead` string, required
          - `body` string, required
        - `moats` object[], required
          - `score` string, required
          - `weak` boolean, required
          - `name` string, required
          - `note` string, required
        - `kpis` object[], required
          - `label` string, required
          - `value` string, required
          - `unit` string, nullable, required
          - `delta` object, nullable, required
            - `text` string, required
            - `direction` 'up' | 'down' | 'neutral', required
          - `citations` string[], required
        - `drivers` object[], required
          - `editPath` string
          - `leadEditPath` string
          - `lead` string, required
          - `body` string, required
        - `citations` object, required
          - `regulatory` string[], required
          - `defensibility` string[], required
      - `recentEvents` object[]
        - `editPaths` object
          - `marker` string, required
          - `body` string, required
        - `marker` string, required
        - `body` string, required
        - `major` boolean, required
        - `citations` string[], required
      - `outlook` object
        - `descriptor` string, required
        - `tailwinds` object[], required
          - `weight` string, required
          - `text` string, required
        - `headwinds` object[], required
          - `weight` string, required
          - `text` string, required
        - `citations` object, required
          - `descriptor` string[], required
      - `sources` object
        - `items` object[], required
          - `number` string, required
          - `metric` string, required
          - `title` string, required
          - `meta` string, required
        - `footer` string, required
      - `forecast` object[]
        - `id` string, required
        - `shortName` string, required
        - `description` string, required
        - `audienceName` string, required
        - `audienceIsNew` boolean, required
        - `demandGrowth` string, required
        - `direction` 'tailwind' | 'headwind' | 'mixed', required
        - `impactWhen` string, required
        - `category` string, required
        - `persistence` string, required
        - `existingLineRel` string, required
        - `readiness` string, required
        - `businessImpact` string, required
        - `readinessRationale` string, required
        - `evidence` string, required
        - `customerPhrasings` string[], required
      - `forecastSummary` object
        - `descriptor` string, required
  - `navigation` object, nullable, required
    - `position` integer, required
    - `total` integer, required
    - `previous` object, nullable, required
      - `locationKey` string, required
      - `label` string, required
    - `next` object, nullable, required
      - `locationKey` string, required
      - `label` string, required

## 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)