Jump to Content
Home
Guides
API Reference
Changelog
v0.5
v2.0
Beeswax Home
Guides
API Reference
Changelog
API Reference
Beeswax Home
Guides
API Reference
Changelog
v2.0
Home
Guides
API Reference
Changelog
Get a deal by ID
JUMP TO
Core API Resources
Alerts
List account alerts
get
Create an account alert
post
Retrieve an account alert
get
Update an account alert
put
Partially update an account alert
patch
Delete an account alert
del
List alerts
get
Create an alert
post
Dismiss all alerts
post
Retrieve an alert
get
Update an alert
put
Partially update an alert
patch
Delete an alert
del
Dismiss an alert
post
Account Groups
List account groups
get
Create an account group
post
Bulk create account groups
post
Bulk update account groups
patch
Bulk delete account groups
del
Retrieve an account group
get
Update an account group
put
Partially update an account group
patch
Delete an account group
del
Accounts
List accounts
get
Create an account
post
Bulk create accounts
post
Bulk update accounts
patch
Retrieve an account
get
Update an account
put
Partially update an account
patch
Retrieve account settings
get
Replace account settings
put
Partially update account settings
patch
Advertisers
List advertisers
get
Create an advertiser
post
Bulk create advertisers
post
Bulk update advertisers
patch
Bulk delete advertisers
del
Bulk validate advertisers
patch
Get an advertiser by ID
get
Update an advertiser by ID
put
Partially update an advertiser by ID
patch
Delete an advertiser by ID
del
Authentication
Authenticate a user session
post
Change the current user's password
post
Logout current user session
get
Logout current user session
post
Bid Modifiers
List bid modifiers
get
Create a new bid modifier
post
Get list of soft-deleted Bid Modifiers
get
Get soft-deleted Bid Modifier by ID
get
Get a bid modifier by ID
get
Update a bid modifier
put
Partially update a bid modifier
patch
Delete a bid modifier by ID
del
List campaigns associated with a bid modifier
get
List line items associated with a bid modifier
get
List versions of a bid modifier
get
List campaigns associated with a bid modifier
get
List line items associated with a bid modifier
get
Bulk File Upload
Retrieve errors from a bulk upload
get
Campaigns
List campaigns
get
Create a campaign
post
Bulk create campaigns
post
Bulk update campaigns
patch
Bulk delete campaigns
del
Bulk validate campaigns
patch
Retrieve a campaign by ID
get
Update a campaign by ID
put
Partially update a campaign by ID
patch
Delete a campaign
del
Duplicate a campaign
get
Duplicate a campaign
post
Metrics
Get a campaign's metrics
get
Get line item metrics
get
/conversion-tag-assignments
get
get
post
post
/conversion-tag-assignments/{id}
get
get
delete
del
/conversion-tags
get
get
post
post
/conversion-tags/bulk-tag
get
get
/conversion-tags/{id}
get
get
put
put
patch
patch
delete
del
Lists
Duplicate an event
get
Duplicate an event
post
List custom lists
get
Create a new custom list
post
Get IDs of lists currently in use
get
Get IDs of lists in use by bid model versions
get
Get a custom list by ID
get
Update a custom list by ID
put
Partially update a custom list by ID
patch
Delete a custom list by ID
del
Duplicate a custom list
get
Duplicate a custom list
post
/conversion-tags/{id}/tag
get
get
Deals
List curated deals
get
Get curated deal by ID
get
Update a curated deal
put
Partially update a curated deal
patch
List deals
get
Create a deal
post
Bulk create deals
post
Bulk update deals
patch
Bulk delete deals
del
Get a deal by ID
get
Update a deal
put
Partially update a deal
patch
Delete a deal
del
Custom List Item
List custom list items
get
Create a new custom list item
post
Acknowledge custom list items
post
Bulk upload custom list items
post
Get debug data for custom list items
get
Delete custom list items by ID
del
Get latitude/longitude list items
get
Get queued custom list items
get
Get updated custom list items since last push
get
Get a custom list item by ID
get
Update a custom list item by ID
put
Partially update a custom list item by ID
patch
Delete a custom list item by ID
del
Delivery Modifiers
List delivery modifiers
get
Create a new delivery modifier
post
Get a delivery modifier by ID
get
Update a delivery modifier
put
Partially update a delivery modifier
patch
Delete a delivery modifier
del
List versions of a delivery modifier
get
Warning
Get a list of dismissed warnings
get
Dismiss multiple warnings
post
Re-enable dismissed warnings
del
Line Items
List line items
get
Create a line item
post
Bulk update line items
patch
Validate multiple line items
patch
Export Line Items
get
Bulk Import Line Items
post
Line Item Bulk Import Template
get
Retrieve line item
get
Update a line item
put
Partially update a line item
patch
Soft-delete a line item
del
Duplicate a line item
get
Duplicate a line item
post
Get line item notifications
get
List creative associations
get
Create a creative association
post
Bulk create or update creative associations
put
Delete creative associations
del
Validate a bulk creative associations request
put
Get a creative association by ID
get
Partially update a creative association
patch
Targeting
Bulk update targeting expressions
post
Convert targeting template to expression
get
List targeting templates or expressions in boolean format
get
Retrieve targeting template or expression in boolean format
get
List a targeting expression
get
Create a targeting expression
post
Retrieve a targeting expression
get
Update a targeting expression
put
Delete a targeting expression
del
/models
get
get
post
post
Bid Models
List all bid model versions
get
Retrieve a specific bid model version
get
List all versions for a specific bid model
get
List all versions for a specific bid model
post
/models/{id}
get
get
put
put
patch
patch
/models/{id}/reset-current-version
patch
patch
Preset
List presets
get
Create a new preset
post
Get a preset by ID
get
Update a preset by ID
put
Partially update a preset by ID
patch
Delete a preset by ID
del
Role
Role management
get
Create a new role
post
Bulk create roles
post
Bulk update roles
patch
Bulk delete roles
del
Retrieve a role
get
Update a role
put
Partially update a role
patch
Delete a role
del
Users
List users
get
Create a user
post
Bulk user operations
post
Bulk user operations
patch
Bulk user operations
del
Retrieve a user
get
Update a user
put
Partially update a user
patch
Delete a user
del
/{object_type}/{object_id}/seat
get
get
Creative API Resources
/creative-approval
get
get
/creative-approval-queue-history
get
get
/creative-approval/{creative_approval_id}
get
get
/creative_asset/upload/{id}
post
post
/creative_assets
get
get
post
post
/creative_assets/{creative_asset_id}
get
get
/creatives
get
get
post
post
/creatives/tag-preview
post
post
/creatives/{id}
get
get
put
put
patch
patch
delete
del
/creatives/{id}/duplicate
get
get
post
post
Marketplace Resources
/marketplace/deals
get
get
post
post
/marketplace/deals/{id}
get
get
put
put
patch
patch
delete
del
/marketplace/deals/{id}/order
post
post
/marketplace/freewheel/ref/advertiser-industries/{id}
get
get
/marketplace/freewheel/ref/dmas
get
get
/marketplace/freewheel/ref/industries
get
get
/marketplace/freewheel/ref/standard-attributes
get
get
Reference Resources
/ref/ad-positions
get
get
/ref/ads-txts
get
get
/ref/advertiser-categories
get
get
/ref/advertiser-indexes
get
get
/ref/advertiser-sensitive-categories
get
get
/ref/audio-content-genres
get
get
/ref/bandwidths
get
get
/ref/bid-models
get
get
/ref/bid-modifier-targeting-keys
get
get
/ref/bid-modifier-targeting-keys/{key}
get
get
/ref/bidding-strategies
get
get
/ref/bidding-strategies/{id}
get
get
/ref/browser-versions
get
get
/ref/browsers
get
get
/ref/budget-types
get
get
/ref/carriers
get
get
/ref/cities
get
get
/ref/content-categories
get
get
/ref/content-genres
get
get
/ref/content-ratings
get
get
/ref/continents
get
get
/ref/conversion-attribution-methods
get
get
/ref/countries
get
get
/ref/creative-approval-vendors
get
get
/ref/creative-sizes
get
get
/ref/currencies
get
get
/ref/custom-bidding-strategies
get
get
/ref/custom-bidding-strategies/{id}
get
get
/ref/custom-list-types
get
get
/ref/dashboards
get
get
/ref/deals
get
get
/ref/deliveries
get
get
/ref/delivery-modifier-targeting-keys
get
get
/ref/delivery-modifier-targeting-keys/{key}
get
get
/ref/device-makes
get
get
/ref/device-models
get
get
/ref/device-screen-sizes
get
get
/ref/devices
get
get
/ref/environment-types
get
get
/ref/event-tag-types
get
get
/ref/event-types
get
get
/ref/experiment-id-types
get
get
/ref/feeds
get
get
/ref/frequency-cap-id-types
get
get
/ref/inventory-sources
get
get
/ref/languages
get
get
/ref/line-item-types
get
get
/ref/lists
get
get
/ref/lists/{id}
get
get
/ref/lists/{id}/items
get
get
/ref/metros
get
get
/ref/native-layouts
get
get
/ref/object-types
get
get
/ref/operating-system-versions
get
get
/ref/operating-systems
get
get
/ref/regions
get
get
/ref/report-field-groups
get
get
/ref/revenue-types
get
get
/ref/second-level-domains
get
get
/ref/segment-search
get
get
/ref/segment-tree
get
get
/ref/system-alerts
get
get
/ref/system-fee-types
get
get
/ref/targeting-keys
get
get
/ref/targeting-keys/{key}
get
get
/ref/timezones
get
get
/ref/vendor-fee-types
get
get
/ref/vendors
get
get
/ref/video-apis
get
get
/ref/video-autoplay-types
get
get
/ref/video-encoding-profiles
get
get
/ref/video-encoding-statuses
get
get
/ref/video-placement-types
get
get
/ref/video-playback-methods
get
get
/ref/video-player-sizes
get
get
/ref/video-protocols
get
get
/ref/video-start-delays
get
get
/ref/warning-codes
get
get
/third-party/data-providers
get
get
/third-party/segment-search
get
get
/third-party/segment-tree
get
get
Identity Network Resources
/id-mapping/overview
get
get
/id-mapping/status
get
get
/id-mapping/status/export
get
get
/id-permissions
get
get
/id-permissions/download
get
get
/id-permissions/id-usage
get
get
Reporting Resources
/reporting/async-results/{id}
get
get
/reporting/folders
get
get
/reporting/report-schedules
get
get
post
post
/reporting/report-schedules/run-once
post
post
/reporting/report-schedules/{id}
get
get
put
put
delete
del
/reporting/report-schedules/{id}/run-once
post
post
/reporting/reports
get
get
/reporting/reports/{report_name}
get
get
/reporting/run-query
post
post
/reporting/run-saved-report
post
post
/reporting/saved-reports
get
get
post
post
/reporting/saved-reports/{id}
get
get
put
put
delete
del
Powered by
Get a deal by ID
get
https://{buzz_key}.api.beeswax.com/rest/v2/deals/
{id}
Retrieve a deal by its ID.
Language
Shell
Node
Ruby
JavaScript
Python
Credentials
Basic
:
URL
Base URL
https://
stingersbx
.api.beeswax.com/rest/v2
/deals/{id}
