---
title: "GET /me/delivery"
method: GET
path: "/me/delivery"
---

# GET /me/delivery

`GET /me/delivery`

## Request

- Base URL: `https://api.caveman.so/api/v1`
- URL: `https://api.caveman.so/api/v1/me/delivery`
- Auth: one of:
  - OAuth 2
    - Authorization code: `/api/v1/oauth/authorize`
    - Token URL: `/api/v1/oauth/token` scopes: `org:read`
  - HTTP bearer
  - API key in cookie `cave_access`
  - API key in cookie `__Secure-cave_identity.session_token`

GET /api/v1/me/delivery on the Caveman Cloud control plane. Requires the org:read scope. Exposed to autonomous agents as the my_delivery action of the caveman_people tool (read access). Org members, seats, and per-person spend and delivery attribution. Read-only — an agent never creates or changes an identity.

## Query parameters

- `from` string, date-time
- `sample_data` boolean
- `to` string, date-time
- `window` string

## Response `200`

Window-scoped delivery evidence. Costs exclude ambiguous joins and incomplete pricing; contribution details disclose truncation.

- DeliveryReport
  - `window` string, required
  - `scope` 'organization' | 'self', required
  - `connected` boolean, required
  - `repos` string[], required
  - `basis` 'branch_tag', required
  - `totals` DeliveryTotals, required
    - `merged_prs` integer, required
    - `attributed_prs` integer, required
    - `unlanded_branches` integer, required
    - `unlanded_sessions` integer, required
    - `in_flight_branches` integer, required
    - `in_flight_sessions` integer, required
    - `session_linked_requests` integer, required
    - `branch_tagged_requests` integer, required
    - `cost_to_merge_usd` number, required
    - `unlanded_cost_usd` number, required
    - `in_flight_cost_usd` number, required
    - `branch_tagged_cost_usd` number, required
    - `untagged_cost_usd` number, required
    - `unresolved_cost_usd` number, required
    - `coverage` number, required
    - `median_cost_usd` number, nullable, required
    - `p90_cost_usd` number, nullable, required
    - `median_sessions` number, nullable, required
  - `by_work_type` DeliveryWorkType[], required
    - `key` string, required
    - `label` string, required
    - `merged_prs` integer, required
    - `attributed_prs` integer, required
    - `total_cost_usd` number, required
    - `median_cost_usd` number, nullable, required
    - `median_changed_files` number, nullable, required
  - `by_repo` DeliveryRepo[], required
    - `repo` string, required
    - `merged_prs` integer, required
    - `attributed_prs` integer, required
    - `total_cost_usd` number, required
    - `median_cost_usd` number, nullable, required
  - `prs` DeliveryPR[], required
    - `project_id` string, required
    - `repo` string, required
    - `title` string, required
    - `branch` string, required
    - `base_branch` string
    - `author_login` string, required
    - `work_type` string, required
    - `merged_at` string, required
    - `opened_at` string
    - `number` integer, required
    - `additions` integer, required
    - `deletions` integer, required
    - `changed_files` integer, required
    - `sessions` integer, required
    - `requests` integer, required
    - `head_sha` string
    - `base_sha` string
    - `merge_commit_sha` string
    - `commit_count` integer
    - `attributed` boolean, required
    - `cost_usd` number, required
    - `optimizers` string[], required
    - `classification` WorkClassification, required
      - `key` 'feat' | 'fix' | 'refactor' | 'perf' | 'test' | 'docs' | 'chore' | 'build' | 'other', required
      - `source` 'unknown' | 'conflict' | 'branch' | 'title' | 'branch_and_title', required
      - `version` 'work-v2', required
      - `branch_type` string, required
      - `title_type` string, required
    - `attribution_status` 'linked' | 'missing_context' | 'reused_branch' | 'traffic_after_merge' | 'incomplete_pricing' | 'report_truncated', required
    - `evidence` DeliveryContribution[], required
      - `member_user_id` string, required
      - `name` string, required
      - `email` string, required
      - `agent_slug` string, required
      - `model` string, required
      - `requests` integer, required
      - `priced_requests` integer, required
      - `cost_usd` number, required
    - `evidence_truncated` boolean, required
  - `unlanded` DeliveryUnlanded[], required
    - `project_id` string, required
    - `repo` string, required
    - `branch` string, required
    - `last_seen` string, required
    - `sessions` integer, required
    - `requests` integer, required
    - `cost_usd` number, required
  - `optimizer_effects` DeliveryOptimizerEffect[], required
    - `optimizer_id` string, required
    - `with_prs` integer, required
    - `without_prs` integer, required
    - `mixed_prs` integer, required
    - `with_median_usd` number, nullable, required
    - `without_median_usd` number, nullable, required
    - `comparable` boolean, required
  - `truncated` boolean, required
  - `basis_notes` object, required
    - `join` string, required
    - `cost` string, required
    - `optimizer` string, required
    - `attribution` string, required

## Other responses

- `4XX`: Structured failure. `error.code` is stable; `error.request_id` is echoed in the x-cave-request-id header.
- `5XX`: Structured failure. `error.code` is stable; `error.request_id` is echoed in the x-cave-request-id header.

---

[API](https://skmtc.dev/caveman/apis/caveman-cloud-api.md) - [All operations](https://skmtc.dev/caveman/apis/caveman-cloud-api/llms.txt) - [OpenAPI document](https://skmtc.dev/caveman/apis/caveman-cloud-api/revisions/508312d01cfc?raw)