---
title: "What this account already bought for a target"
method: GET
path: "/v1/campaigns"
tags: ["Planning"]
---

# What this account already bought for a target

`GET /v1/campaigns`

## Request

- Base URL: `https://api.placementapi.com`
- URL: `https://api.placementapi.com/v1/campaigns`
- Auth: HTTP bearer

Campaign memory from the buyer's own orders, grouped as `exact` (the URL; null when only a domain was given) and `domain` (every order pointing anywhere on the host). Each view: orders, links, spend_credits, pending, delivered, failed, cancelled, links_last_30d, first/last_order_at, domains_used[], placement_types, anchor_mix, anchors[]. anchor_mix comes from anchor_plan where given, else from classifying anchor text. `outcomes` is an observed summary, not attribution.

## Query parameters

- `target_url` string, required

## Response `200`

OK

- object
  - `target_url` string, nullable
  - `target_domain` string
  - `outcomes` unknown
  - `exact` object, nullable
  - `domain` object
  - `note` string

## Other responses

- `400`: Malformed request. `error` is `bad_request` (with a zod `detail`), `invalid_json`, or `unknown_parameter` / `unknown_field` (with `unknown[]` and `accepted[]`).
- `401`: Missing, malformed or revoked Bearer credential: `{ error: "unauthorized" }`.
- `403`: `insufficient_scope` when the key lacks the `order` scope; `customer_key_required` when the operator token is used where a customer must be attributable.
- `503`: `server_misconfigured` when the store is not configured; `upstream_unfunded` when the measurement provider's prepaid balance is exhausted (fresh profiles, gap maps and SERPs pause; cached results and catalogue are unaffected); `upstream_unavailable` on a provider error; `payments_unavailable` when card payments are not configured.

---

[API](https://skmtc.dev/placementapi/apis/placement-api.md) · [All operations](https://skmtc.dev/placementapi/apis/placement-api/llms.txt) · [OpenAPI document](https://skmtc.dev/placementapi/apis/placement-api/revisions/fc4e7866eaf7?raw)