AAMP component · reference implementation

seller-agent

seller-agent is an AAMP reference implementation repository from IAB Tech Lab. Supply-side reference implementation: media kit, avails, quotes, negotiation, deals, order lifecycle.

Source: IABTechLab/seller-agent

seller-agent on 12 August 2026: version, kind, substance grade and hub listing. Substance is an editorial grade rather than a measurement, on the ranking test.
PropertyValue
Versionv2.4.1
Commit 2bb7ebce
Kindreference implementation
Substancesubstantial
Listed in the hub READMEYes

What this repository defines

87 operations across 74 paths. The largest machine-readable surface in the corpus: an OpenAPI 3.1 document with 74 paths carrying 87 operations, 91 component schemas, a changelog, and tags through v2.4.1. Its prose guides contradict the OpenAPI and each other.

Operations a caller can invoke

seller-agent — 87 operations across 74 paths. The Required column counts top-level required fields on the request, and does not recurse into nested objects.
Operation Required Summary
GET / 0 Root
GET /health 0 Health
GET /events 0 List Events
GET /events/{event_id} 0 Get Event
GET /auth/api-keys 0 List Api Keys
POST /auth/api-keys 0 Create Api Key
GET /auth/api-keys/{key_id} 0 Get Api Key Details
DELETE /auth/api-keys/{key_id} 0 Revoke Api Key
GET /api/v1/supply-chain 0 Get Supply Chain
GET /api/v1/rate-card 0 Get Rate Card
PUT /api/v1/rate-card 0 Update Rate Card
GET /api/v1/inventory-sync/status 0 Get Inventory Sync Status
POST /api/v1/inventory-sync/trigger 0 Trigger Inventory Sync
GET /api/v1/inventory-sync/watermark 0 Get Sync Watermark
GET /gam/orders 0 Gam List Orders
GET /gam/report 0 Gam Delivery Report
GET /products 0 List Products
POST /products/avails 0 Check Avails
GET /products/{product_id} 0 Get Product
POST /pricing 1 Get Pricing
POST /discovery 1 Discovery Query
POST /api/v1/products/{product_id}/inventory-type 2 Override Inventory Type
GET /api/v1/products/{product_id}/inventory-type 0 Get Inventory Type Override
DELETE /api/v1/products/{product_id}/inventory-type 0 Delete Inventory Type Override
POST /proposals 6 Submit Proposal
POST /proposals/{proposal_id}/counter 1 Counter Proposal
GET /proposals/{proposal_id}/negotiation 0 Get Negotiation Status
POST /api/v1/negotiations/messages 2 Post Negotiation Message
POST /deals 1 Generate Deal
POST /api/v1/deals 2 Book Deal
POST /agentic-audience/match 1 Agentic Audience Match
GET /api/v1/deals/export 0 Export Deals
GET /api/v1/deals/{deal_id} 0 Get Deal By Id
POST /api/v1/deals/from-template 2 Create Deal From Template
GET /api/v1/deals/{deal_id}/performance 0 Get Deal Performance
POST /api/v1/deals/bulk 1 Bulk Deal Operations
POST /api/v1/deals/push 2 Push Deal To Buyers
GET /api/v1/deals/{deal_id}/buyer-status 0 Get Deal Buyer Status
POST /api/v1/deals/distribute 1 Distribute Deal Via Ssp
GET /api/v1/deals/{deal_id}/ssp-troubleshoot 0 Troubleshoot Deal Via Ssp
GET /api/v1/curators 0 List Curators
POST /api/v1/curators 3 Register Curator
GET /api/v1/curators/{curator_id} 0 Get Curator
POST /api/v1/deals/curated 1 Create Curated Deal
POST /api/v1/deals/{deal_id}/migrate 1 Migrate Deal
POST /api/v1/deals/{deal_id}/deprecate 1 Deprecate Deal
GET /api/v1/deals/{deal_id}/lineage 0 Get Deal Lineage
GET /approvals 0 List Pending Approvals
GET /approvals/{approval_id} 0 Get Approval
POST /approvals/{approval_id}/decide 1 Decide Approval
POST /approvals/{approval_id}/resume 0 Resume Flow
POST /sessions 0 Create Session
GET /sessions 0 List Sessions
GET /sessions/{session_id} 0 Get Session
POST /sessions/{session_id}/messages 1 Send Session Message
POST /sessions/{session_id}/close 0 Close Session Endpoint
GET /media-kit 0 Media Kit Overview
GET /media-kit/packages 0 List Media Kit Packages
GET /media-kit/packages/{package_id} 0 Get Media Kit Package
POST /media-kit/search 1 Search Media Kit
GET /packages 0 List Packages
POST /packages 3 Create Package
GET /packages/{package_id} 0 Get Package
PUT /packages/{package_id} 0 Update Package
DELETE /packages/{package_id} 0 Delete Package
POST /packages/assemble 2 Assemble Package
POST /packages/sync 0 Sync Packages
GET /.well-known/agent.json 0 Agent Card
GET /registry/agents 0 List Registered Agents
GET /registry/agents/{agent_id} 0 Get Registered Agent
DELETE /registry/agents/{agent_id} 0 Remove Registered Agent
POST /registry/agents/discover 1 Discover Agent
PUT /registry/agents/{agent_id}/trust 1 Update Agent Trust
POST /api/v1/quotes 3 Create Quote
GET /api/v1/quotes/{quote_id} 0 Get Quote
POST /api/v1/orders 0 Create Order
GET /api/v1/orders 0 List Orders
GET /api/v1/orders/report 0 Get Orders Report
GET /api/v1/orders/{order_id} 0 Get Order
GET /api/v1/orders/{order_id}/history 0 Get Order History
POST /api/v1/orders/{order_id}/transition 1 Transition Order
GET /api/v1/orders/{order_id}/audit 0 Get Order Audit
POST /api/v1/change-requests 2 Create Change Request
GET /api/v1/change-requests 0 List Change Requests
GET /api/v1/change-requests/{cr_id} 0 Get Change Request
POST /api/v1/change-requests/{cr_id}/review 1 Review Change Request
POST /api/v1/change-requests/{cr_id}/apply 0 Apply Change Request

Related