Orders APIOrders

Get Placement

Authentication

x-api-keystring

Server-to-server API key. Never embed in a browser or mobile client.

Path parameters

orderIdstringRequired
placementIdstringRequired

Response

OK
placement_idstring
statusenum

Current placement status. One of: DRAFT, ORDERED, PENDING_APPROVAL, REJECTED, IN_PROGRESS, APPROVED, LIVE, REFUNDED.

requested_urlstring
requested_anchorstring
quality_tierenum

Minimum domain-authority band for the placement. DR_20 = Starter (DR 20+), DR_30 = Standard (DR 30+), DR_40 = Authority (DR 40+), DR_50 = Power (DR 50+), DR_60 = Elite (DR 60+).

pricelong

Placement price in integer USD cents (1 credit = 1 cent).

rejected_countinteger
How many proposed domains the client has rejected for this placement.
rejection_limitinteger

Rejection budget. On the (rejection_limit)-th reject the placement auto-refunds.

price_breakdownlist of objects
numberstringOptional

Human-facing sequential placement number. Assigned at launch - omitted while the order is a draft.

publisher_urlstringOptional
URL where the link was actually published. Omitted until the placement is live.
content_guidelinesstringOptional
domain_specificationsstringOptional
domain_ratingintegerOptional
Domain Rating of the proposed publisher domain. Omitted until a domain is proposed.
domain_trafficlongOptional
Monthly organic traffic of the proposed publisher domain. Omitted until a domain is proposed.
approved_atstringOptional

When the proposed domain was approved (RFC 3339 UTC). Omitted until approved.

concern_statusenumOptional

Overlay status of an open concern on this placement (RAISED / IN_REVIEW). Omitted when no concern is active.