# Buyer Agent API

**Canonical:** https://apis.io/apis/iab-tech-lab/buyer-agent-api/  
**Provider:** IAB Tech Lab — https://apis.io/providers/iab-tech-lab/  
**Documentation:** https://iabtechlab.github.io/buyer-agent/

Buyer Agent API is one of 9 APIs that [IAB Tech Lab](https://apis.io/providers/iab-tech-lab/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Agentic Advertising, Media Buying, and Deals. The published artifact set on APIs.io includes API documentation and an OpenAPI specification.

IAB Tech Lab's reference buyer agent for DSPs, agencies and advertisers: an OpenAPI 3.1 REST surface (14 operations — orders and audit trails, booking jobs and approvals, product search, events, reports and campaign metadata) that drives MCP, A2A and REST clients against seller agents to browse media kits, negotiate and book OpenDirect 2.1 deals. Self-hosted; no IAB Tech Lab-hosted instance.

## Operations (14)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/buyer/orders` | List Buyer Orders |
| GET | `/api/v1/buyer/orders/{order_id}/audit` | Get Order Audit |
| GET | `/health` | Health Check |
| POST | `/bookings` | Create Booking |
| GET | `/bookings` | List Bookings |
| GET | `/bookings/{job_id}` | Get Booking Status |
| POST | `/bookings/{job_id}/approve` | Approve Recommendations |
| POST | `/bookings/{job_id}/approve-all` | Approve All Recommendations |
| POST | `/products/search` | Search Products |
| GET | `/events` | List Events |
| GET | `/events/{event_id}` | Get Event |
| GET | `/reports/{job_id}` | Get Campaign Report |
| GET | `/meta/campaigns` | Meta List Campaigns |
| GET | `/meta/report` | Meta Direct Report |

## Machine-readable artifacts (4)

- **Documentation** — https://iabtechlab.github.io/buyer-agent/
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/iab-tech-lab/refs/heads/main/openapi/iab-tech-lab-buyer-agent-openapi.json
- **SourceCode** — https://github.com/IABTechLab/buyer-agent
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/iab-tech-lab/refs/heads/main/overlays/iab-tech-lab-buyer-agent-overlay.yaml

## Other IAB Tech Lab APIs (8)

- [OpenDirect API](https://apis.io/apis/iab-tech-lab/opendirect-api/)
- [IAB Agentic Advertising API](https://apis.io/apis/iab-tech-lab/agentic-advertising-api/)
- [Seller Agent API](https://apis.io/apis/iab-tech-lab/seller-agent-api/)
- [OpenRTB 2.x Protocol](https://apis.io/apis/iab-tech-lab/openrtb/)
- [AdCOM Protobuf](https://apis.io/apis/iab-tech-lab/adcom/)
- [Agentic RTB Framework gRPC](https://apis.io/apis/iab-tech-lab/agentic-rtb-framework/)
- [VAST and VMAP Schemas](https://apis.io/apis/iab-tech-lab/vast/)
- [Supply Chain API](https://apis.io/apis/iab-tech-lab/supply-chain-api/)

## Tags

Agentic Advertising, Media Buying, Deals

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/iab-tech-lab/buyer-agent-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/iab-tech-lab/.
