---
title: "Get outreach discovery status"
method: POST
path: "/outreach/discoveries/{discovery_session_id}/status"
---

# Get outreach discovery status

`POST /outreach/discoveries/{discovery_session_id}/status`

## Request

- Base URL: `https://api.bamf.ai/v1`
- URL: `https://api.bamf.ai/v1/outreach/discoveries/{discovery_session_id}/status`
- Auth: HTTP bearer

Reads a tenant- and principal-scoped discovery state without provider mutation.

## Path parameters

- `discovery_session_id` string, uuid, required

## Request body

- OutreachDiscoveryScopeRequest
  - `workspace_id` string, uuid, required
  - `session_id` string, uuid, required
  - `principal_context_ref_id` string, uuid, required
  - `gateway_run_id` string, uuid, required
  - `provider` string, required
  - `provider_account_id` string, required
  - `capability_receipt_ref` string, required

## Response `200`

Discovery state; providerMutation is false

## Other responses

- `404`: Scoped session not found

---

[API](https://skmtc.dev/bamf/apis/bamf-developer-platform-api.md) · [All operations](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/revisions/a390dd3294bd?raw)