How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
IAB Tech Lab

IAB Tech Lab Deal Booking API

Quote-to-deal booking (IAB Deals API v1.0)

Documentation Provider Profile APIs.io OpenAPI GitHub

IAB Tech Lab Deal Booking API is one of 43 APIs that IAB Tech Lab publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 16 JSON Schema definitions.

Tagged areas include Deal Booking. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a changelog, and 16 JSON Schemas.

This API exposes 11 operations across 11 paths, and defines 30 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against the base URL https://api.iabtechlab.com.

11 operations 11 paths 30 schemas 5 GET6 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://api.iabtechlab.com
Contact
IAB Tech Lab
License
Apache 2.0
Resource Areas
1

Paths & Operations 11

Across 11 paths, the API surfaces 11 operations — 5 GET, 6 POST. Each is listed below with its method, path, parameters, and response codes.

Deal Booking 11

Quote-to-deal booking (IAB Deals API v1.0)

POST
/api/v1/deals
Book Deal
book_deal_api_v1_deals_post 2 params body → 200422
GET
/api/v1/deals/export
Export Deals
export_deals_api_v1_deals_export_get 2 params → 200422
GET
/api/v1/deals/{deal_id}
Get Deal By Id
get_deal_by_id_api_v1_deals__deal_id__get 1 param → 200422
POST
/api/v1/deals/from-template
Create Deal From Template
create_deal_from_template_api_v1_deals_from_template_post 2 params body → 201422
POST
/api/v1/deals/push
Push Deal To Buyers
push_deal_to_buyers_api_v1_deals_push_post body → 200422
GET
/api/v1/deals/{deal_id}/buyer-status
Get Deal Buyer Status
get_deal_buyer_status_api_v1_deals__deal_id__buyer_status_get 2 params → 200422
POST
/api/v1/deals/distribute
Distribute Deal Via Ssp
distribute_deal_via_ssp_api_v1_deals_distribute_post body → 200422
GET
/api/v1/deals/{deal_id}/ssp-troubleshoot
Troubleshoot Deal Via Ssp
troubleshoot_deal_via_ssp_api_v1_deals__deal_id__ssp_troubleshoot_get 2 params → 200422
POST
/api/v1/deals/{deal_id}/migrate
Migrate Deal
migrate_deal_api_v1_deals__deal_id__migrate_post 3 params body → 201422
POST
/api/v1/deals/{deal_id}/deprecate
Deprecate Deal
deprecate_deal_api_v1_deals__deal_id__deprecate_post 1 param body → 200422
GET
/api/v1/deals/{deal_id}/lineage
Get Deal Lineage
get_deal_lineage_api_v1_deals__deal_id__lineage_get 1 param → 200422

Schemas 30

The contract defines 30 schemas that model the data the API accepts and returns. The most detailed are Deal (18 properties), LinearTVQuoteDetails (13 properties), DealFromTemplateResponse (13 properties), SSPDealDistributeRequest (11 properties). Each schema is shown below with its type and property counts.

DealPushRequest
object
Request to push a deal to buyer(s).
10 properties 2 required
PricingType
string
How a price signal should be interpreted. - fixed: price is set by the seller, use as-is - floor: minimum price; negotiation expected above this level - onrequ…
OpenRTBParams
object
OpenRTB (Open Real-Time Bidding) deal parameters for DSP (demand-side platform) activation.
5 properties 2 required
DealStatus
string
ONE deal status vocabulary, unioned from the four competing sets. Sources: buyer DealResponse.status (proposed/active/rejected/ expired/completed), seller Deal…
ValidationError
object
5 properties 3 required
Money
object
Exact money amount in integer micros (flagged decision FD-11). 1000000 micros = 1 currency unit — the ad-industry convention (Google Ad Manager, among others,…
2 properties 1 required
DealMigrationRequest
object
Request to migrate (replace) an existing deal.
10 properties 1 required
CancellationTerms
object
Structured cancellation window for linear TV deals.
4 properties 2 required
QuoteBuyerIdentityModel
object
Buyer identity in a quote request.
4 properties
PricingModel
string
Unit of pricing. Union of the buyer's RateType and the seller's PricingModel plus the linear TV additions. - cpm: cost per mille (thousand impressions) - cpmv:…
DealBookingRequest
object
Request body for POST /api/v1/deals (money-mutating: FD-12). This is the commit point — the referenced quote becomes bound. The seller mints dealid in the resp…
6 properties 2 required
DealFromTemplateRequest
object
Request model for POST /api/v1/deals/from-template.
9 properties 2 required
DealDeprecationRequest
object
Request to deprecate a deal.
2 properties 1 required
DealFromTemplateResponse
object
Response for template-based deal creation.
13 properties 10 required
HTTPValidationError
object
1 property
QuoteTerms
object
Volume, flight, and guarantee terms on a quote or deal.
7 properties
BuyerIdentity
object
Buyer identity revealed progressively to unlock better pricing. Superset of the buyer repo's BuyerIdentity and the seller repo's BuyerIdentity/QuoteBuyerIdenti…
11 properties
ProductRef
object
Lightweight product summary embedded in quotes and deals.
3 properties 2 required
Deal
object
A confirmed deal booked from a quote (Deals API v1.0 book phase). ID minting: dealid is seller-issued.
18 properties 5 required
SSPDealDistributeRequest
object
Request to distribute a deal through configured SSPs.
11 properties 1 required
DiligenceStatus
string
Status of counterparty privacy diligence (IAB Diligence Platform).
ConsentContext
object
Privacy consent signals that travel with a deal (flagged decision FD-10). Full build-out (EP-10.4) of the EP-1.2 placeholder: the three interoperable consent-s…
8 properties
SupplyChain
object
OpenRTB SupplyChain object (schain): the ordered node path. complete is the OpenRTB 0/1 flag: 1 means every node from the initial impression to the final bidde…
4 properties
DealType
string
Programmatic deal types. The short wire encoding is canonical. - PG = Programmatic Guaranteed: fixed price, guaranteed impressions - PD = Preferred Deal: fixed…
QuotePricing
object
Pricing breakdown on a quote or deal. basecpm/finalcpm are optional to support pricingtype=onrequest — when the seller has not provided pricing, these fields a…
9 properties
MediaType
string
Media type discriminator carried on quotes and deals. Sellers that do not support lineartv MUST return a structured rejection rather than silently mispricing (…
SupplyChainNode
object
One hop in the OpenRTB supply chain (schain node). Field names are the OpenRTB SupplyChainNode names verbatim. asi is the advertising system identifier (the ca…
7 properties 2 required
DealBookingResponse
object
Success envelope for the deal endpoints: wraps the Deal primitive.
3 properties 1 required
LinearTVQuoteDetails
object
Linear-TV-specific quote details (seller-populated). Nested under Quote.lineartv when mediatype == "lineartv".
13 properties 10 required
AccessTier
string
Access tier for tiered pricing, derived from revealed buyer identity. - public: no identity — price ranges only - seat: authenticated DSP (demand-side platform…

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

iab-tech-lab-deal-booking-api-openapi.yml Raw ↑

Other APIs IAB Tech Lab publishes across the network.

OpenRTB 2.x Protocol
AE Profile APIs.io
AdCOM Protobuf
AE Profile APIs.io
Agentic RTB Framework gRPC
AE Profile APIs.io
VAST and VMAP Schemas
AE Profile APIs.io
Supply Chain API
AE Profile APIs.io
IAB Tech Lab A2a API
AE Profile APIs.io
IAB Tech Lab Accounts API
AE Profile APIs.io
IAB Tech Lab Agent Registry API
AE Profile APIs.io
IAB Tech Lab Approvals API
AE Profile APIs.io
IAB Tech Lab Assignments API
AE Profile APIs.io
IAB Tech Lab Audience API
AE Profile APIs.io
IAB Tech Lab Audit API
AE Profile APIs.io
#Deal Booking
← Back to I APIs
API Details
ID
iab-tech-lab:iab-tech-lab-deal-booking-api
Base URL
https://api.iabtechlab.com
Docs
https://iabtechlab.com/standards/opendirect/
Provider
IAB Tech Lab
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=iab-tech-lab-deal-booking-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/iab-tech-lab-deal-booking-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of IAB Tech Lab Deal Booking API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.