---
title: "Retrieve an allowlisted governance-discovery placement and short-lived attribution token."
method: GET
path: "/v1/public/discovery/placements/{placement_id}"
---

# Retrieve an allowlisted governance-discovery placement and short-lived attribution token.

`GET /v1/public/discovery/placements/{placement_id}`

## Request

- Base URL: `https://api.getmarrow.ai`
- URL: `https://api.getmarrow.ai/v1/public/discovery/placements/{placement_id}`
- Auth: none required

Records the opaque placement, a bounded retrieval identifier, the retrieval kind, a timestamp, and an expiry. The discovery service at beacon.getmarrow.ai also records one of four fixed automation classes derived from bot-verification signals or the User-Agent header. Raw prompts, source code, credentials, personal data, network addresses, and User-Agent text are not stored in discovery metrics. A salted hash of the caller network address is kept temporarily in a separate rate-limit counter.

## Path parameters

- `placement_id` string, required

## Query parameters

- `retrieval_id` string

## Response `200`

Successful tenant-scoped response.

- object

## Other responses

- `404`: Invalid request.
- `429`: Capacity or fairness limit reached; follow Retry-After when present.

---

[API](https://skmtc.dev/getmarrow/apis/marrow-agent-governance-api.md) · [All operations](https://skmtc.dev/getmarrow/apis/marrow-agent-governance-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getmarrow/apis/marrow-agent-governance-api/revisions/3b29084f6cc5?raw)