ad_accounts14

ad_groups13

ads10

advanced_auction2

audience_insights2

audience_sharing7

audiences4

billing11

boards11

bulk3

business_access_assets12

business_access_invite6

business_access_relationships9

campaigns8

catalog_feeds8

catalog_items3

catalog_product_groups10

catalog_reports3

catalog_supplemental7

catalogs3

conversion_deletion_requests4

conversion_eqs1

conversion_events1

conversion_tags5

conversions4

customer_list_uploads3

customer_lists4

customer_segment3

integrations7

keywords5

labels5

lead_ads4

lead_forms5

leads_export2

media3

msot_events1

notification1

oauth3

order_lines2

pins8

product_group_promotions5

product_tags3

promotions5

resources6

schedules3

search3

targeting_template3

terms2

terms_of_service1

trends4

user_account14

ad_groups

Get bid floors

Changed on Jun 4, 2026

List bid floors for your campaign configuration. Bid floors are given in microcurrency values based on the currency in the bid floor specification.

Microcurrency is used to track very small transactions, based on the currency set in the advertiser's profile.

A microcurrency unit is 10^(-6) of the standard unit of currency selected in the advertiser's profile.

Equivalency equations, using dollars as an example currency:

$1 = 1,000,000 microdollars
1 microdollar = $0.000001

To convert between currency and microcurrency, using dollars as an example currency:

To convert dollars to microdollars, mutiply dollars by 1,000,000
To convert microdollars to dollars, divide microdollars by 1,000,000

For more on bid floors see Set your bid.

post/ad_accounts/{ad_account_id}/bid_floor

Request

Base URL
https://api.pinterest.com/v5
Auth
- OAuth 2
  Authorization codehttps://www.pinterest.com/oauth/
  Token URLhttps://api.pinterest.com/v5/oauth/token
  Scopesads:read
- or OAuth 2
  Client credentials
  Token URLhttps://api.pinterest.com/v3/oauth/access_token/
  Scopesads:read
TypeScript
https://skmtc.dev/pinterest/apis/pinterest-rest-api/docs/ad_accounts/:ad_account_id/bid_floor/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

ad_account_idstring required

Unique identifier of an ad account.

Request body

Example request

{
  "bid_floor_specs": [
    {
      "billable_event": "CLICKTHROUGH",
      "objective_type": "AWARENESS"
    }
  ],
  "targeting_spec": {
    "SHOPPING_RETARGETING": [
      {
        "lookback_window": 30,
        "exclusion_window": 14,
        "tag_types": [
          0,
          6
        ]
      }
    ]
  }
}

Response

The request has succeeded.

bid_floorsinteger[]

A list of bid floors in micro currency. For example, [100000, 200000]

typestring

Always the string 'bidfloor'.

Example response

{
  "bid_floors": [
    100000,
    200000
  ],
  "type": "bidfloor"
}

Changes

Jun 4, 2026v5b698c180678a Revision changes
- breaking
  added to the // request property allOf list
- breaking
  added to the // request property allOf list
- breaking
  added to the // request property allOf list
- breaking
  added to the // request property allOf list
- breaking
  added to the // request property allOf list
- breaking
  added to the request property allOf list
- breaking
  removed the enum value ARS of the request property //
- breaking
  removed the enum value AUD of the request property //
- breaking
  removed the enum value AWARENESS of the request property //
- breaking
  removed the enum value BRL of the request property //
- breaking
  removed the enum value CAD of the request property //
- breaking
  removed the enum value CAROUSEL of the request property //
- breaking
  removed the enum value CATALOG_SALES of the request property //
- breaking
  removed the enum value CHF of the request property //
- breaking
  removed the enum value CLICKTHROUGH of the request property //
- breaking
  removed the enum value CLP of the request property //
- breaking
  removed the enum value COLLAGE of the request property //
- breaking
  removed the enum value COLLECTION of the request property //
- breaking
  removed the enum value CONSIDERATION of the request property //
- breaking
  removed the enum value COP of the request property //
- breaking
  removed the enum value CZK of the request property //
- breaking
  removed the enum value DKK of the request property //
- breaking
  removed the enum value EUR of the request property //
- breaking
  removed the enum value GBP of the request property //
- breaking
  removed the enum value HKD of the request property //
- breaking
  removed the enum value HUF of the request property //
- breaking
  removed the enum value IDEA of the request property //
- breaking
  removed the enum value ILS of the request property //
- breaking
  removed the enum value IMPRESSION of the request property //
- breaking
  removed the enum value INR of the request property //
- breaking
  removed the enum value JPY of the request property //
- breaking
  removed the enum value KRW of the request property //
- breaking
  removed the enum value MAX_VIDEO of the request property //
- breaking
  removed the enum value MAX_WIDTH_REGULAR_COLLECTION of the request property //
- breaking
  removed the enum value MAX_WIDTH_VIDEO_COLLECTION of the request property //
- breaking
  removed the enum value MXN of the request property //
- breaking
  removed the enum value NOK of the request property //
- breaking
  removed the enum value NZD of the request property //
- breaking
  removed the enum value PLN of the request property //
- breaking
  removed the enum value QUIZ of the request property //
- breaking
  removed the enum value REGULAR of the request property //
- breaking
  removed the enum value RON of the request property //
- breaking
  removed the enum value SEK of the request property //
- breaking
  removed the enum value SGD of the request property //
- breaking
  removed the enum value SHOPPING of the request property //
- breaking
  removed the enum value SHOP_THE_PIN of the request property //
- breaking
  removed the enum value SHOWCASE of the request property //
- breaking
  removed the enum value TRY of the request property //
- breaking
  removed the enum value UNK of the request property //
- breaking
  removed the enum value USD of the request property //
- breaking
  removed the enum value VIDEO of the request property //
- breaking
  removed the enum value VIDEO_COMPLETION of the request property //
- breaking
  removed the enum value VIDEO_V_50_MRC of the request property //
- breaking
  removed the enum value WEB_CONVERSION of the request property //
- breaking
  the // request property type changed from string to no type
- breaking
  the // request property type changed from string to no type
- breaking
  the // request property type changed from string to no type
- breaking
  the // request property type changed from string to no type
- breaking
  the // request property type changed from object to no type
- breaking
  the request property type changed from object to no type
- warning
  removed the request property ///
- warning
  removed the request property ///
- warning
  removed the request property ///
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  the response optional property became read-only for the status
- info
  the response optional property became read-only for the status
- info
  added the success response with the status
Dec 10, 2025v56768e3ca1ffa Revision changes
- info
  added the new optional request property /
- info
  added the new optional request property /

Operation history (15 revisions)