---
title: "Get profile distributions"
method: POST
path: "/v1/commands/get_profile_distributions"
tags: ["Reports and exports"]
---

# Get profile distributions

`POST /v1/commands/get_profile_distributions`

## Request

- Base URL: `https://app.agentlinkops.com`
- URL: `https://app.agentlinkops.com/v1/commands/get_profile_distributions`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Shared command transport. All logical arguments in JSON; no query or Idempotency-Key header. See canonical operation reference.

## Headers

- `X-Workspace-ID` string

## Request body

- GetProfileDistributionsInput
  - `projectId` string, required: project ID from create/list.
  - `status` 'all' | 'active' | 'paused': Lifecycle status, separate from observed state.
  - `limit` integer: Page/report row cap; see bounds.
  - `comparison` object
    - `setId` string, required
    - `revision` integer, required
    - `inventoryIds` string[], required
  - `indexSourceKey` string

## Response `200`

Command result, including queued admission.

- GetProfileDistributionsOutput
  - `monitored` object, required
    - `schema_version` 1, required
    - `workspace_id` string, required: Workspace that owns this record.
    - `project_id` string, required: Project that owns this record.
    - `generated_at` string, required
    - `status_filter` 'all' | 'active' | 'paused', required
    - `coverage` object, required: Dataset scope and completeness, including limits on what these results establish.
      - `basis` 'latest_retained_attempt_per_watch', required
      - `whole_web_coverage` false, required: False: these results do not measure the whole web.
      - `total_watches` integer, required
      - `scanned_watches` integer, required
      - `eligible_present_watches` integer, required
      - `included_present_watches` integer, required
      - `excluded_evidence_watches` integer, required
      - `occurrences` integer, required
      - `scanned_bytes` integer, required
      - `partial` boolean, required
      - `limitations` string[], required
      - `overlapping_watches_deduplicated` false, required
    - `distributions` object, required
    - `notes` string[], required
  - `comparison` object, nullable, required
    - `set_id` string, required
    - `revision` integer, required: Optimistic concurrency revision; supply it as expectedRevision on the next write.
    - `whole_web_coverage` false, required: False: these results do not measure the whole web.
    - `absence_claim` 'not_supported', required: not_supported: missing dataset rows cannot prove link absence.
    - `pooled` false, required
    - `datasets` object[], required
      - `inventory_id` string, required
      - `member_id` string, required
      - `member_target` string, required
      - `provider` string, required
      - `data_mode` string, required
      - `captured_at` string, required
      - `member_role` 'customer' | 'competitor', required
      - `retrieved_from` string, nullable, required
      - `retrieved_to` string, nullable, required
      - `coverage` string, required: Dataset scope and completeness, including limits on what these results establish.
      - `row_count` integer, required
      - `basis` 'frozen_inventory_rows', required
      - `distributions` object, required
    - `notes` string[], required
  - `index` object, nullable, required
    - `source_key` string, required
    - `basis` 'latest_retained_receipt_per_watch_for_source', required
    - `total_watches` integer, required
    - `scanned_watches` integer, required
    - `partial` boolean, required
    - `expired_watches` integer, required
    - `missing_watches` integer, required
    - `distribution` object, required
      - `unit` 'watches' | 'occurrences' | 'anchor_terms' | 'inventory_rows', required
      - `denominator` integer, required
      - `known_count` integer, required
      - `unknown_count` integer, required
      - `unknown_share` number, nullable, required
      - `items` object[], required: Records in this bounded page.
        - `value` string, nullable, required
        - `count` integer, required
        - `share` number, required
      - `other_count` integer, required
      - `truncated` boolean, required
    - `notes` string[], required

## Other responses

- `429`: Request-rate or usage refusal. Inspect error.code and recovery details before retrying.
- `default`: Error envelope. Non-configuration 5xx messages are masked and details omitted; allowlisted configuration errors retain static operator recovery.

---

[API](https://skmtc.dev/agentlinkops/apis/agentlinkops-http-api.md) · [All operations](https://skmtc.dev/agentlinkops/apis/agentlinkops-http-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentlinkops/apis/agentlinkops-http-api/revisions/1bf30c2912b2?raw)