--- title: "Changes to Get bid floors" method: POST path: "/ad_accounts/{ad_account_id}/bid_floor" --- # Changes to Get bid floors `POST /ad_accounts/{ad_account_id}/bid_floor` > Every recorded change to this operation, newest first. ## Timeline Changed in 15 of 29 revisions. - **2026-06-04** (v5) `b698c180678a`: 60 breaking, 16 warning, 8 info - **2025-12-10** (v5) `6768e3ca1ffa`: 2 info - **2025-10-16** (v5) `14c297539b64`: 3 info - **2025-08-12** (v5) `8fb7ab040159`: 1 info - **2025-07-16** (v5) `43134ca41f18`: 2 breaking - **2025-04-04** (v5) `10f9eba4ad97`: 2 warning, 3 info - **2024-08-14** (v5) `89c27ed39cfd`: 3 info - **2024-04-23** (v5) `f9321315766f`: 1 warning, 1 info - **2023-08-17** (v5) `0ff12596bafd`: 1 info - **2023-07-14** (v5) `52586a274771`: 7 breaking, 1 warning, 32 info - **2023-05-12** (v5) `689b4b267639`: 1 breaking, 1 info - **2023-02-14** (v5) `be19b77aa78a`: 4 info - **2022-11-14** (v5) `e041d7b0cef0`: 1 breaking - **2022-09-07** (v5) `bd20b6eb152f`: 4 breaking, 1 warning, 1 info - **2022-07-11** (v5) `0d5998752011`: 1 info ## Changes - **2026-06-04** (v5) `b698c180678a`: 60 breaking, 16 warning, 8 info - added `#/components/schemas/ActionType` to the `bid_floor_specs/items/billable_event` request property `allOf` list - added `#/components/schemas/BidFloorObjectiveType` to the `bid_floor_specs/items/objective_type` request property `allOf` list - added `#/components/schemas/CreativeType` to the `bid_floor_specs/items/creative_type` request property `allOf` list - added `#/components/schemas/Currency` to the `bid_floor_specs/items/currency` request property `allOf` list - added `#/components/schemas/OptimizationGoalMetadata` to the `bid_floor_specs/items/optimization_goal_metadata` request property `allOf` list - added `#/components/schemas/TargetingSpecOptimal` to the `targeting_spec` request property `allOf` list - removed the enum value `ARS` of the request property `bid_floor_specs/items/currency` - removed the enum value `AUD` of the request property `bid_floor_specs/items/currency` - removed the enum value `AWARENESS` of the request property `bid_floor_specs/items/objective_type` - removed the enum value `BRL` of the request property `bid_floor_specs/items/currency` - removed the enum value `CAD` of the request property `bid_floor_specs/items/currency` - removed the enum value `CAROUSEL` of the request property `bid_floor_specs/items/creative_type` - removed the enum value `CATALOG_SALES` of the request property `bid_floor_specs/items/objective_type` - removed the enum value `CHF` of the request property `bid_floor_specs/items/currency` - removed the enum value `CLICKTHROUGH` of the request property `bid_floor_specs/items/billable_event` - removed the enum value `CLP` of the request property `bid_floor_specs/items/currency` - removed the enum value `COLLAGE` of the request property `bid_floor_specs/items/creative_type` - removed the enum value `COLLECTION` of the request property `bid_floor_specs/items/creative_type` - removed the enum value `CONSIDERATION` of the request property `bid_floor_specs/items/objective_type` - removed the enum value `COP` of the request property `bid_floor_specs/items/currency` - removed the enum value `CZK` of the request property `bid_floor_specs/items/currency` - removed the enum value `DKK` of the request property `bid_floor_specs/items/currency` - removed the enum value `EUR` of the request property `bid_floor_specs/items/currency` - removed the enum value `GBP` of the request property `bid_floor_specs/items/currency` - removed the enum value `HKD` of the request property `bid_floor_specs/items/currency` - removed the enum value `HUF` of the request property `bid_floor_specs/items/currency` - removed the enum value `IDEA` of the request property `bid_floor_specs/items/creative_type` - removed the enum value `ILS` of the request property `bid_floor_specs/items/currency` - removed the enum value `IMPRESSION` of the request property `bid_floor_specs/items/billable_event` - removed the enum value `INR` of the request property `bid_floor_specs/items/currency` - removed the enum value `JPY` of the request property `bid_floor_specs/items/currency` - removed the enum value `KRW` of the request property `bid_floor_specs/items/currency` - removed the enum value `MAX_VIDEO` of the request property `bid_floor_specs/items/creative_type` - removed the enum value `MAX_WIDTH_REGULAR_COLLECTION` of the request property `bid_floor_specs/items/creative_type` - removed the enum value `MAX_WIDTH_VIDEO_COLLECTION` of the request property `bid_floor_specs/items/creative_type` - removed the enum value `MXN` of the request property `bid_floor_specs/items/currency` - removed the enum value `NOK` of the request property `bid_floor_specs/items/currency` - removed the enum value `NZD` of the request property `bid_floor_specs/items/currency` - removed the enum value `PLN` of the request property `bid_floor_specs/items/currency` - removed the enum value `QUIZ` of the request property `bid_floor_specs/items/creative_type` - …44 more - **2025-12-10** (v5) `6768e3ca1ffa`: 2 info - added the new optional request property `targeting_spec/MAXIMUM_AGE` - added the new optional request property `targeting_spec/MINIMUM_AGE` - **2025-10-16** (v5) `14c297539b64`: 3 info - added the new `COLLAGE` enum value to the request property `bid_floor_specs/items/creative_type` - added the new `MAX_WIDTH_REGULAR_COLLECTION` enum value to the request property `bid_floor_specs/items/creative_type` - added the new `MAX_WIDTH_VIDEO_COLLECTION` enum value to the request property `bid_floor_specs/items/creative_type` - **2025-08-12** (v5) `8fb7ab040159`: 1 info - added the new optional request property `bid_floor_specs/items/optimization_goal_metadata/conversion_tag_v3_goal_metadata/reporting_event` - **2025-07-16** (v5) `43134ca41f18`: 2 breaking - removed the enum value `VIDEO_VIEW` of the request property `bid_floor_specs/items/objective_type` - removed the enum value `WEB_SESSIONS` of the request property `bid_floor_specs/items/objective_type` - **2025-04-04** (v5) `10f9eba4ad97`: 2 warning, 3 info - the `bid_floor_specs/items/optimization_goal_metadata/frequency_goal_metadata/frequency` request property's max was set to `20.00` - the `bid_floor_specs/items/optimization_goal_metadata/frequency_goal_metadata/frequency` request property's min was set to `2.00` - the endpoint scheme security `client_credentials` was added to the API - added the new `19+` enum value to the request property `targeting_spec/AGE_BUCKET/items/` - added the new `20+` enum value to the request property `targeting_spec/AGE_BUCKET/items/` - **2024-08-14** (v5) `89c27ed39cfd`: 3 info - added the new `INR` enum value to the request property `bid_floor_specs/items/currency` - added the new `TRY` enum value to the request property `bid_floor_specs/items/currency` - added the new `VIDEO_COMPLETION` enum value to the request property `bid_floor_specs/items/objective_type` - **2024-04-23** (v5) `f9321315766f`: 1 warning, 1 info - removed the request property `targeting_spec/AUDIENCE_INCLUDE'` - added the new optional request property `targeting_spec/AUDIENCE_INCLUDE` - **2023-08-17** (v5) `0ff12596bafd`: 1 info - added the new `TWENTY_FOUR_HOUR` enum value to the request property `bid_floor_specs/items/optimization_goal_metadata/frequency_goal_metadata/timerange` - **2023-07-14** (v5) `52586a274771`: 7 breaking, 1 warning, 32 info - request property `targeting_spec/AGE_BUCKET/items/` was restricted to a list of enum values - request property `targeting_spec/APPTYPE/items/` was restricted to a list of enum values - request property `targeting_spec/GENDER/items/` was restricted to a list of enum values - request property `targeting_spec/TARGETING_STRATEGY/items/` was restricted to a list of enum values - the `targeting_spec/AUDIENCE_EXCLUDE/items/` request property's minItems was increased to `100` - added the pattern `^\d+$` to the request property `targeting_spec/AUDIENCE_EXCLUDE/items/` - the `targeting_spec/TARGETING_STRATEGY/items/` request property type changed from `string` to no type - removed the request property `targeting_spec/AUDIENCE_INCLUDE` - added the new optional request property `targeting_spec/AUDIENCE_INCLUDE'` - the request property `targeting_spec/AGE_BUCKET` became nullable - the request property `targeting_spec/APPTYPE` became nullable - the request property `targeting_spec/AUDIENCE_EXCLUDE` became nullable - the request property `targeting_spec/GENDER` became nullable - the request property `targeting_spec/GEO` became nullable - the request property `targeting_spec/LOCALE` became nullable - the request property `targeting_spec/LOCATION` became nullable - the request property `targeting_spec/SHOPPING_RETARGETING` became nullable - the request property `targeting_spec/TARGETING_STRATEGY` became nullable - added the new `18-24` enum value to the request property `targeting_spec/AGE_BUCKET/items/` - added the new `21+` enum value to the request property `targeting_spec/AGE_BUCKET/items/` - added the new `25-34` enum value to the request property `targeting_spec/AGE_BUCKET/items/` - added the new `35-44` enum value to the request property `targeting_spec/AGE_BUCKET/items/` - added the new `45-49` enum value to the request property `targeting_spec/AGE_BUCKET/items/` - added the new `50-54` enum value to the request property `targeting_spec/AGE_BUCKET/items/` - added the new `55-64` enum value to the request property `targeting_spec/AGE_BUCKET/items/` - added the new `65+` enum value to the request property `targeting_spec/AGE_BUCKET/items/` - added the new `CHOOSE_YOUR_OWN` enum value to the request property `targeting_spec/TARGETING_STRATEGY/items/` - added the new `COLLECTION` enum value to the request property `bid_floor_specs/items/creative_type` - added the new `FIND_NEW_CUSTOMERS` enum value to the request property `targeting_spec/TARGETING_STRATEGY/items/` - added the new `RECONNECT_WITH_USERS` enum value to the request property `targeting_spec/TARGETING_STRATEGY/items/` - added the new `SHOWCASE` enum value to the request property `bid_floor_specs/items/creative_type` - added the new `android_mobile` enum value to the request property `targeting_spec/APPTYPE/items/` - added the new `android_tablet` enum value to the request property `targeting_spec/APPTYPE/items/` - added the new `female` enum value to the request property `targeting_spec/GENDER/items/` - added the new `ipad` enum value to the request property `targeting_spec/APPTYPE/items/` - added the new `iphone` enum value to the request property `targeting_spec/APPTYPE/items/` - added the new `male` enum value to the request property `targeting_spec/GENDER/items/` - added the new `unknown` enum value to the request property `targeting_spec/GENDER/items/` - added the new `web` enum value to the request property `targeting_spec/APPTYPE/items/` - added the new `web_mobile` enum value to the request property `targeting_spec/APPTYPE/items/` - **2023-05-12** (v5) `689b4b267639`: 1 breaking, 1 info - removed the enum value `BILLABLE_ENGAGEMENT` of the request property `bid_floor_specs/items/billable_event` - added the new `QUIZ` enum value to the request property `bid_floor_specs/items/creative_type` - **2023-02-14** (v5) `be19b77aa78a`: 4 info - added the new optional request property `bid_floor_specs/items/optimization_goal_metadata/conversion_tag_v3_goal_metadata` - added the new optional request property `bid_floor_specs/items/optimization_goal_metadata/frequency_goal_metadata` - added the new optional request property `bid_floor_specs/items/optimization_goal_metadata/scrollup_goal_metadata` - added the new `CN` enum value to the request property `bid_floor_specs/items/countries/items/` - **2022-11-14** (v5) `e041d7b0cef0`: 1 breaking - for the `path` request parameter `ad_account_id`, the maxLength was decreased from `19` to `18` - **2022-09-07** (v5) `bd20b6eb152f`: 4 breaking, 1 warning, 1 info - the request property `bid_floor_specs/items/currency` became required - removed the enum value `AWARENESS_RESERVED` of the request property `bid_floor_specs/items/objective_type` - removed the enum value `ENGAGEMENT` of the request property `bid_floor_specs/items/objective_type` - removed the enum value `STORY` of the request property `bid_floor_specs/items/creative_type` - for the `path` request parameter `ad_account_id`, the maxLength was set to `19` - added the new `IDEA` enum value to the request property `bid_floor_specs/items/creative_type` - **2022-07-11** (v5) `0d5998752011`: 1 info - endpoint added --- [Operation](https://skmtc.dev/pinterest/apis/pinterest-rest-api/docs/ad_accounts/:ad_account_id/bid_floor/post.md) - [API](https://skmtc.dev/pinterest/apis/pinterest-rest-api.md) - [Page](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/ad_accounts/:ad_account_id/bid_floor/post)