{"components":{"callbacks":{},"examples":{},"headers":{},"links":{},"parameters":{"AccountIdHeaderOptional":{"description":"The identifier of an Amazon Ads Advertiser Account.","in":"header","name":"Amazon-Ads-AccountId","schema":{"type":"string"}},"ClientIdHeader":{"description":"The identifier of a client associated with a \u0027Login with Amazon\u0027 account.","in":"header","name":"Amazon-Ads-ClientId","required":true,"schema":{"type":"string"}},"ManagerAccountIdHeaderOptional":{"description":"The identifier of an Amazon Ads Manager Account.","in":"header","name":"Amazon-Ads-Manager-AccountId","schema":{"type":"string"}}},"requestBodies":{},"responses":{},"schemas":{"AdProduct":{"description":"**AdProduct Enum:**\n\n| AdProduct | Description |\n|------|------|\n| `AMAZON_DSP` | Amazon Demand-Side Platform ad product. |\n","enum":["AMAZON_DSP"],"type":"string"},"AmazonMediaExtension":{"description":"Amazon Media specific proposal attributes.","type":"object"},"AmazonPublisherCloudExtension":{"description":"Target based on Amazon Publisher Service proposal attributes.","type":"object"},"AmazonPublisherDirectExtension":{"description":"Target based on Amazon Publisher Service proposal attributes.","type":"object"},"BadGatewayResponseContent":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"BadRequestResponseContent":{"properties":{"code":{"$ref":"#/components/schemas/ErrorCode"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"ContentTooLargeResponseContent":{"properties":{"code":{"$ref":"#/components/schemas/ErrorCode"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"CountryCode":{"enum":["AD","AE","AF","AG","AI","AU","BR","CA","DE","ES","FR","GB","IT","JP","KR","MX","US"],"type":"string"},"CreateAmazonMediaExtension":{"description":"Amazon Media specific proposal attributes.","type":"object"},"CreateAmazonPublisherCloudExtension":{"description":"Target based on Amazon Publisher Service proposal attributes.","type":"object"},"CreateAmazonPublisherDirectExtension":{"description":"Target based on Amazon Publisher Service proposal attributes.","type":"object"},"CreateNotes":{"description":"Notes for an object with origin information.","properties":{"note":{"description":"The note content.","type":"string"},"origin":{"$ref":"#/components/schemas/NoteOrigin"}},"required":["note","origin"],"type":"object"},"CreateState":{"description":"The user defined state for the resource. For ADSP, campaign and ad group resources can only be created in the PAUSED state and must be updated to ENABLED to activate for delivery\n**CreateState Enum:**\n| CreateState | Description |\n| --- | --- |\n| `DRAFT` | The resource is in draft status and has not yet been proposed or enabled. |\n| `PROPOSED` | Indicates an entity staged for review and adoption by advertisers. |","enum":["DRAFT","PROPOSED"],"type":"string"},"CreateSupplierProposalExtension":{"oneOf":[{"properties":{"amazonMediaExtension":{"$ref":"#/components/schemas/CreateAmazonMediaExtension"}},"required":["amazonMediaExtension"],"title":"amazonMediaExtension","type":"object"},{"properties":{"amazonPublisherCloudExtension":{"$ref":"#/components/schemas/CreateAmazonPublisherCloudExtension"}},"required":["amazonPublisherCloudExtension"],"title":"amazonPublisherCloudExtension","type":"object"},{"properties":{"amazonPublisherDirectExtension":{"$ref":"#/components/schemas/CreateAmazonPublisherDirectExtension"}},"required":["amazonPublisherDirectExtension"],"title":"amazonPublisherDirectExtension","type":"object"}]},"CreateSupplierProposalRequest":{"properties":{"supplierProposals":{"items":{"$ref":"#/components/schemas/SupplierProposalCreate"},"maxItems":10,"minItems":1,"type":"array"}},"required":["supplierProposals"],"type":"object"},"CreateSupplierStateReason":{"description":"Additional context for a resource\u0027s lifecycle state.","properties":{"archiveReason":{"$ref":"#/components/schemas/SupplierArchiveReason"},"description":{"description":"A free text description providing context for the state.","type":"string"}},"type":"object"},"Error":{"properties":{"code":{"$ref":"#/components/schemas/ErrorCode"},"fieldLocation":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"ErrorCode":{"description":"**ErrorCode Enum:**\n\n| ErrorCode | Description |\n|------|------|\n| `BAD_REQUEST` | The request is not valid considering the documented schema. |\n| `FORBIDDEN` | The caller is not authorized to make the given request. |\n| `INTERNAL_ERROR` | The server encountered an unexpected condition that prevented it from fulfilling the request. |\n| `NOT_FOUND` | The requested resource does not exist. |\n| `TOO_MANY_REQUESTS` | There have been too many requests, please slow down your call rate. |\n| `UNAUTHORIZED` | The request lacks the necessary credentials. |\n","enum":["BAD_REQUEST","FORBIDDEN","INTERNAL_ERROR","NOT_FOUND","TOO_MANY_REQUESTS","UNAUTHORIZED"],"type":"string"},"ErrorsIndex":{"properties":{"errors":{"items":{"$ref":"#/components/schemas/Error"},"maxItems":20,"minItems":1,"type":"array"},"index":{"format":"int32","maximum":14,"minimum":0,"type":"integer"}},"required":["errors","index"],"type":"object"},"ForbiddenResponseContent":{"properties":{"code":{"$ref":"#/components/schemas/ErrorCode"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"GatewayTimeoutResponseContent":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"InternalServerErrorResponseContent":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"NotFoundResponseContent":{"properties":{"code":{"$ref":"#/components/schemas/ErrorCode"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"NoteOrigin":{"enum":["BUYER","SUPPLIER"],"type":"string"},"Notes":{"description":"Notes for an object with origin information.","properties":{"note":{"description":"The note content.","type":"string"},"origin":{"$ref":"#/components/schemas/NoteOrigin"}},"required":["note","origin"],"type":"object"},"QuerySupplierProposalRequest":{"properties":{"adProductFilter":{"$ref":"#/components/schemas/SupplierProposalAdProductFilter"},"advertiserAccountIdFilter":{"$ref":"#/components/schemas/SupplierProposalAdvertiserAccountIdFilter"},"countriesFilter":{"$ref":"#/components/schemas/SupplierProposalCountryCodeFilter"},"endDateTimeFilter":{"$ref":"#/components/schemas/SupplierProposalEndDateTimeFilter"},"maxResults":{"default":10,"format":"int32","maximum":1000,"minimum":1,"type":"integer"},"nameFilter":{"$ref":"#/components/schemas/SupplierProposalSupplierNameFilter"},"nextToken":{"type":"string"},"sort":{"items":{"$ref":"#/components/schemas/SupplierProposalSortOption"},"maxItems":7,"minItems":0,"type":"array"},"startDateTimeFilter":{"$ref":"#/components/schemas/SupplierProposalStartDateTimeFilter"},"statusFilter":{"$ref":"#/components/schemas/SupplierProposalSupplierProposalStatusFilter"},"supplierProposalDestinationIdFilter":{"$ref":"#/components/schemas/SupplierProposalSupplierProposalDestinationIdFilter"},"supplierProposalIdFilter":{"$ref":"#/components/schemas/SupplierProposalSupplierProposalIdFilter"}},"required":["adProductFilter"],"type":"object"},"ServiceUnavailableErrorResponseContent":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"SortDirection":{"description":"**SortDirection Enum:**\n| SortDirection | Description |\n| --- | --- |\n| `ASCENDING` | Sort in ascending order |\n| `DESCENDING` | Sort in descending order |","enum":["ASCENDING","DESCENDING"],"type":"string"},"State":{"description":"The user defined state for the resource. For ADSP, campaign and ad group resources can only be created in the PAUSED state and must be updated to ENABLED to activate for delivery\n**State Enum:**\n\n| State | Description |\n|------|------|\n| `ARCHIVED` | The object is permanently stopped and cannot be reactivated. Terminal end state. |\n| `DRAFT` | The resource is in draft status and has not yet been proposed or enabled. |\n| `PROPOSED` | Indicates an entity staged for review and adoption by advertisers. |\n","enum":["ARCHIVED","DRAFT","PROPOSED"],"type":"string"},"SupplierArchiveReason":{"enum":["CREATED_ACCIDENTALLY","CREATED_FOR_TESTING","DUPLICATE","NEGOTIATIONS_TERMINATED","NOT_DELIVERING","PROLONGED_PAUSE","UNDERDELIVERING"],"type":"string"},"SupplierProposal":{"properties":{"adProduct":{"$ref":"#/components/schemas/AdProduct"},"advertiserAccountId":{"description":"The ADSP advertiserId for this proposal. If advertiserId is null, then we treat it as manager account level proposal.","type":"string"},"countries":{"description":"The country this proposal is located.","items":{"$ref":"#/components/schemas/CountryCode"},"maxItems":49,"minItems":0,"type":"array"},"creationDateTime":{"description":"The date time that the proposal was created.","format":"date-time","type":"string"},"endDateTime":{"description":"The proposal end date.","format":"date-time","type":"string"},"externalProposalId":{"description":"The external proposal identifier from the supplier system.","type":"string"},"lastUpdatedDateTime":{"description":"The date time that the proposal was last updated.","format":"date-time","type":"string"},"name":{"description":"The user provided proposal name.","pattern":"^[ -:\u003c-z|]+$","type":"string"},"notes":{"description":"User provided notes for this proposal.","items":{"$ref":"#/components/schemas/Notes"},"maxItems":49,"minItems":0,"type":"array"},"startDateTime":{"description":"The proposal start date.","format":"date-time","type":"string"},"state":{"$ref":"#/components/schemas/State"},"stateReason":{"$ref":"#/components/schemas/SupplierStateReason"},"status":{"$ref":"#/components/schemas/SupplierProposalStatus"},"supplierProposalDestinationId":{"description":"The supplier proposal destination identifier.","type":"string"},"supplierProposalExtension":{"$ref":"#/components/schemas/SupplierProposalExtension"},"supplierProposalId":{"description":"The unique identifier for the proposal.","type":"string"},"supplierProposalType":{"$ref":"#/components/schemas/SupplierProposalType"},"supplierProposedDealIds":{"description":"The proposed deals associated with this proposal.","items":{"type":"string"},"maxItems":15,"minItems":0,"type":"array"},"version":{"description":"The version number of the proposal.","format":"int32","type":"integer"}},"required":["creationDateTime","lastUpdatedDateTime","name","status","supplierProposalId","version"],"type":"object"},"SupplierProposalAdProductFilter":{"properties":{"include":{"description":"**AdProduct Enum:**\n| AdProduct | Description |\n| --- | --- |\n| `AMAZON_DSP` | Amazon Demand-Side Platform ad product. |","items":{"$ref":"#/components/schemas/AdProduct"},"maxItems":1,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"SupplierProposalAdvertiserAccountIdFilter":{"properties":{"include":{"items":{"type":"string"},"maxItems":50,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"SupplierProposalCountryCodeFilter":{"properties":{"include":{"items":{"$ref":"#/components/schemas/CountryCode"},"maxItems":50,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"SupplierProposalCreate":{"properties":{"adProduct":{"$ref":"#/components/schemas/AdProduct"},"advertiserAccountId":{"description":"The ADSP advertiserId for this proposal. If advertiserId is null, then we treat it as manager account level proposal.","type":"string"},"countries":{"description":"The country this proposal is located.","items":{"$ref":"#/components/schemas/CountryCode"},"maxItems":49,"minItems":0,"type":"array"},"externalProposalId":{"description":"The external proposal identifier from the supplier system.","type":"string"},"name":{"description":"The user provided proposal name.","pattern":"^[ -:\u003c-z|]+$","type":"string"},"notes":{"description":"User provided notes for this proposal.","items":{"$ref":"#/components/schemas/CreateNotes"},"maxItems":49,"minItems":0,"type":"array"},"state":{"$ref":"#/components/schemas/CreateState"},"stateReason":{"$ref":"#/components/schemas/CreateSupplierStateReason"},"supplierProposalDestinationId":{"description":"The supplier proposal destination identifier.","type":"string"},"supplierProposalExtension":{"$ref":"#/components/schemas/CreateSupplierProposalExtension"},"supplierProposalType":{"$ref":"#/components/schemas/SupplierProposalType"}},"required":["name"],"type":"object"},"SupplierProposalEndDateTimeFilter":{"properties":{"include":{"items":{"format":"date-time","type":"string"},"maxItems":2,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"SupplierProposalExtension":{"oneOf":[{"properties":{"amazonMediaExtension":{"$ref":"#/components/schemas/AmazonMediaExtension"}},"required":["amazonMediaExtension"],"title":"amazonMediaExtension","type":"object"},{"properties":{"amazonPublisherCloudExtension":{"$ref":"#/components/schemas/AmazonPublisherCloudExtension"}},"required":["amazonPublisherCloudExtension"],"title":"amazonPublisherCloudExtension","type":"object"},{"properties":{"amazonPublisherDirectExtension":{"$ref":"#/components/schemas/AmazonPublisherDirectExtension"}},"required":["amazonPublisherDirectExtension"],"title":"amazonPublisherDirectExtension","type":"object"}]},"SupplierProposalMultiStatusResponse":{"properties":{"error":{"items":{"$ref":"#/components/schemas/ErrorsIndex"},"maxItems":10,"minItems":0,"type":"array"},"success":{"items":{"$ref":"#/components/schemas/SupplierProposalMultiStatusSuccess"},"maxItems":10,"minItems":0,"type":"array"}},"type":"object"},"SupplierProposalMultiStatusSuccess":{"properties":{"index":{"format":"int32","maximum":9,"minimum":0,"type":"integer"},"supplierProposal":{"$ref":"#/components/schemas/SupplierProposal"}},"required":["index","supplierProposal"],"type":"object"},"SupplierProposalSortOption":{"properties":{"by":{"$ref":"#/components/schemas/SupplierProposalSortOptionsFields"},"direction":{"$ref":"#/components/schemas/SortDirection"}},"required":["by"],"type":"object"},"SupplierProposalSortOptionsFields":{"description":"Specify which field to order by.\n| Field Name | Supported Ordering |\n| --- | --- |\n| countries | ASCENDING,DESCENDING |\n| endDateTime | ASCENDING,DESCENDING |\n| lastUpdatedDateTime | ASCENDING,DESCENDING |\n| name | ASCENDING,DESCENDING |\n| startDateTime | ASCENDING,DESCENDING |\n| status | ASCENDING,DESCENDING |\n| supplierProposalId | ASCENDING,DESCENDING |","enum":["countries","endDateTime","lastUpdatedDateTime","name","startDateTime","status","supplierProposalId"],"type":"string"},"SupplierProposalStartDateTimeFilter":{"properties":{"include":{"items":{"format":"date-time","type":"string"},"maxItems":2,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"SupplierProposalStatus":{"description":"**SupplierProposalStatus Enum:**\n\n| SupplierProposalStatus | Description |\n|------|------|\n| `CANCELLED` | A proposal that was previously submitted to a supplier, but was marked as canceled by the buyer before it was approved. |\n| `COUNTER_DRAFT` | A proposal that is undergoing negotiation with a supplier, a proposal that includes proposed deals has been received from the supplier, and the buyer has begun draft changes to the received proposal but has not yet submitted them to the supplier. |\n| `DRAFT` | A proposal that is in draft status, meaning that it may include changes that have not been submitted to a supplier. |\n| `PENDING` | The buyer has submitted a proposal to a supplier and is waiting for the supplier to take action. |\n| `REJECTED` | A proposal has been rejected by the supplier and negotiation has ended. No further changes may be done to a proposal nor may it be submitted again. |\n| `REVIEWED_PARTIAL` | Implies that some proposed deals in this proposal have been approved, while some proposed deals are in PENDING status. |\n| `REVIEWED` | A proposal in REVIEWED status implies that all proposed deals related to this proposal have been reviewed and further action by the buyer is required. The proposed deals associated with this proposal may individually be either approved or rejcted. |\n| `SUPPLIER_REVIEWED` | The supplier has reviewed the proposals and are awaiting buyer action. |\n","enum":["CANCELLED","COUNTER_DRAFT","DRAFT","PENDING","REJECTED","REVIEWED","REVIEWED_PARTIAL","SUPPLIER_REVIEWED"],"type":"string"},"SupplierProposalSuccessResponse":{"properties":{"nextToken":{"type":"string"},"supplierProposals":{"items":{"$ref":"#/components/schemas/SupplierProposal"},"maxItems":1000,"minItems":0,"type":"array"},"totalResults":{"format":"int32","type":"integer"}},"type":"object"},"SupplierProposalSupplierNameFilter":{"properties":{"include":{"items":{"type":"string"},"maxItems":50,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"SupplierProposalSupplierProposalDestinationIdFilter":{"properties":{"include":{"items":{"type":"string"},"maxItems":50,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"SupplierProposalSupplierProposalIdFilter":{"properties":{"include":{"items":{"type":"string"},"maxItems":50,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"SupplierProposalSupplierProposalStatusFilter":{"properties":{"include":{"description":"**Status Enum:**\n| Status | Description |\n| --- | --- |\n| `CANCELLED` | A proposal that was previously submitted to a supplier, but was marked as canceled by the buyer before it was approved. |\n| `DRAFT` | A proposal that is in draft status, meaning that it may include changes that have not been submitted to a supplier. |\n| `COUNTER_DRAFT` | A proposal that is undergoing negotiation with a supplier, a proposal that includes proposed deals has been received from the supplier, and the buyer has begun draft changes to the received proposal but has not yet submitted them to the supplier. |\n| `PENDING` | The buyer has submitted a proposal to a supplier and is waiting for the supplier to take action. |\n| `REJECTED` | A proposal has been rejected by the supplier and negotiation has ended. No further changes may be done to a proposal nor may it be submitted again. |\n| `REVIEWED` | A proposal in REVIEWED status implies that all proposed deals related to this proposal have been reviewed and further action by the buyer is required. The proposed deals associated with this proposal may individually be either approved or rejcted. |\n| `REVIEWED_PARTIAL` | Implies that some proposed deals in this proposal have been approved, while some proposed deals are in PENDING status. |\n| `SUPPLIER_REVIEWED` | The supplier has reviewed the proposals and are awaiting buyer action. |","items":{"$ref":"#/components/schemas/SupplierProposalStatus"},"maxItems":50,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"SupplierProposalType":{"enum":["AMAZON_MEDIA","AMAZON_PUBLISHER_CLOUD","AMAZON_PUBLISHER_DIRECT"],"type":"string"},"SupplierProposalUpdate":{"properties":{"adProduct":{"$ref":"#/components/schemas/AdProduct"},"name":{"description":"The user provided proposal name.","pattern":"^[ -:\u003c-z|]+$","type":"string"},"notes":{"description":"User provided notes for this proposal.","items":{"$ref":"#/components/schemas/CreateNotes"},"maxItems":49,"minItems":0,"type":"array"},"state":{"$ref":"#/components/schemas/UpdateState"},"stateReason":{"$ref":"#/components/schemas/UpdateSupplierStateReason"},"supplierProposalDestinationId":{"description":"The supplier proposal destination identifier.","type":"string"},"supplierProposalExtension":{"$ref":"#/components/schemas/UpdateSupplierProposalExtension"},"supplierProposalId":{"description":"The unique identifier for the proposal.","type":"string"}},"required":["supplierProposalId"],"type":"object"},"SupplierStateReason":{"description":"Additional context for a resource\u0027s lifecycle state.","properties":{"archiveReason":{"$ref":"#/components/schemas/SupplierArchiveReason"},"description":{"description":"A free text description providing context for the state.","type":"string"}},"type":"object"},"TooManyRequestsResponseContent":{"properties":{"code":{"$ref":"#/components/schemas/ErrorCode"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"UnauthorizedResponseContent":{"properties":{"code":{"$ref":"#/components/schemas/ErrorCode"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"UpdateAmazonMediaExtension":{"description":"Amazon Media specific proposal attributes.","type":"object"},"UpdateAmazonPublisherCloudExtension":{"description":"Target based on Amazon Publisher Service proposal attributes.","type":"object"},"UpdateAmazonPublisherDirectExtension":{"description":"Target based on Amazon Publisher Service proposal attributes.","type":"object"},"UpdateState":{"description":"The user defined state for the resource. For ADSP, campaign and ad group resources can only be created in the PAUSED state and must be updated to ENABLED to activate for delivery\n**UpdateState Enum:**\n| UpdateState | Description |\n| --- | --- |\n| `DRAFT` | The resource is in draft status and has not yet been proposed or enabled. |\n| `PROPOSED` | Indicates an entity staged for review and adoption by advertisers. |","enum":["DRAFT","PROPOSED"],"type":"string"},"UpdateSupplierProposalExtension":{"oneOf":[{"properties":{"amazonMediaExtension":{"$ref":"#/components/schemas/UpdateAmazonMediaExtension"}},"required":["amazonMediaExtension"],"title":"amazonMediaExtension","type":"object"},{"properties":{"amazonPublisherCloudExtension":{"$ref":"#/components/schemas/UpdateAmazonPublisherCloudExtension"}},"required":["amazonPublisherCloudExtension"],"title":"amazonPublisherCloudExtension","type":"object"},{"properties":{"amazonPublisherDirectExtension":{"$ref":"#/components/schemas/UpdateAmazonPublisherDirectExtension"}},"required":["amazonPublisherDirectExtension"],"title":"amazonPublisherDirectExtension","type":"object"}]},"UpdateSupplierProposalRequest":{"properties":{"supplierProposals":{"items":{"$ref":"#/components/schemas/SupplierProposalUpdate"},"maxItems":10,"minItems":1,"type":"array"}},"required":["supplierProposals"],"type":"object"},"UpdateSupplierStateReason":{"description":"Additional context for a resource\u0027s lifecycle state.","properties":{"archiveReason":{"$ref":"#/components/schemas/SupplierArchiveReason"},"description":{"description":"A free text description providing context for the state.","type":"string"}},"type":"object"}},"securitySchemes":{"OAuth2":{"flows":{"authorizationCode":{"authorizationUrl":"https://www.amazon.com/ap/oa","scopes":{"advertising::audiences":"Grants access to data provider APIs","advertising::campaign_management":"Grants write access to campaign management.","advertising::test:create_account":"Grants write access to create test accounts functionality","cpc_advertising:campaign_management":"Grants write access to campaign management. Legacy name (no difference from advertising::campaign_management)"},"tokenUrl":"https://api.amazon.com/auth/o2/token"}},"type":"oauth2"}}},"info":{"description":"Amazon Ads API v1 is a reimagined approach to our Ads API, built to provide a seamless experience across all Amazon advertising products through a common model. [Learn more about Ads API v1.](https://advertising.amazon.com/API/docs/en-us/reference/amazon-ads/overview) To learn about prerequisites and header values, see [Getting started with Amazon Ads API v1](https://advertising.amazon.com/API/docs/en-us/reference/amazon-ads/getting-started).\n\n**Download Amazon Ads API V1 OpenAPI Spec** ([All Products](https://d1y2lf8k3vrkfu.cloudfront.net/openapi/en-us/dest/AmazonAdsAPIALLMerged_prod_3p.json) | [SP](https://d1y2lf8k3vrkfu.cloudfront.net/openapi/en-us/dest/AmazonAdsAPISPMerged_prod_3p.json) | [SP Global](https://d1y2lf8k3vrkfu.cloudfront.net/openapi/en-us/dest/AmazonAdsAPISPGLOBALMerged_prod_3p.json) | [SB](https://d1y2lf8k3vrkfu.cloudfront.net/openapi/en-us/dest/AmazonAdsAPISBMerged_prod_3p.json) | [DSP](https://d1y2lf8k3vrkfu.cloudfront.net/openapi/en-us/dest/AmazonAdsAPIDSPMerged_prod_3p.json) | [ST](https://d1y2lf8k3vrkfu.cloudfront.net/openapi/en-us/dest/AmazonAdsAPISTMerged_prod_3p.json) | [SD](https://d1y2lf8k3vrkfu.cloudfront.net/openapi/en-us/dest/AmazonAdsAPISDMerged_prod_3p.json))","title":"SupplierProposals API","version":"3.0"},"openapi":"3.0.1","paths":{"/adsApi/v1/create/supplierProposals":{"post":{"description":"Create supplier proposal\n\n**Requires one of these permissions**:\n[\"inventory_edit\"]","operationId":"CreateSupplierProposal","parameters":[{"$ref":"#/components/parameters/AccountIdHeaderOptional"},{"$ref":"#/components/parameters/ClientIdHeader"},{"$ref":"#/components/parameters/ManagerAccountIdHeaderOptional"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSupplierProposalRequest"}}},"required":true},"responses":{"207":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierProposalMultiStatusResponse"}}},"description":"CreateSupplierProposal 207 response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestResponseContent"}}},"description":"BadRequest 400 response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedResponseContent"}}},"description":"Unauthorized 401 response"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenResponseContent"}}},"description":"Forbidden 403 response"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundResponseContent"}}},"description":"NotFound 404 response"},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentTooLargeResponseContent"}}},"description":"ContentTooLarge 413 response"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequestsResponseContent"}}},"description":"TooManyRequests 429 response"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorResponseContent"}}},"description":"InternalServerError 500 response"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadGatewayResponseContent"}}},"description":"BadGateway 502 response"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailableErrorResponseContent"}}},"description":"ServiceUnavailableError 503 response"},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayTimeoutResponseContent"}}},"description":"GatewayTimeout 504 response"}},"security":[{"OAuth2":["advertising::campaign_management"]}],"tags":["SupplierProposals"]}},"/adsApi/v1/query/supplierProposals":{"post":{"description":"Query supplier proposal\n\n**Requires one of these permissions**:\n[\"inventory_view\"]","operationId":"QuerySupplierProposal","parameters":[{"$ref":"#/components/parameters/AccountIdHeaderOptional"},{"$ref":"#/components/parameters/ClientIdHeader"},{"$ref":"#/components/parameters/ManagerAccountIdHeaderOptional"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuerySupplierProposalRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierProposalSuccessResponse"}}},"description":"QuerySupplierProposal 200 response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestResponseContent"}}},"description":"BadRequest 400 response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedResponseContent"}}},"description":"Unauthorized 401 response"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenResponseContent"}}},"description":"Forbidden 403 response"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundResponseContent"}}},"description":"NotFound 404 response"},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentTooLargeResponseContent"}}},"description":"ContentTooLarge 413 response"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequestsResponseContent"}}},"description":"TooManyRequests 429 response"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorResponseContent"}}},"description":"InternalServerError 500 response"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadGatewayResponseContent"}}},"description":"BadGateway 502 response"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailableErrorResponseContent"}}},"description":"ServiceUnavailableError 503 response"},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayTimeoutResponseContent"}}},"description":"GatewayTimeout 504 response"}},"security":[{"OAuth2":["advertising::campaign_management"]}],"tags":["SupplierProposals"]}},"/adsApi/v1/update/supplierProposals":{"post":{"description":"Update supplier proposal\n\n**Requires one of these permissions**:\n[\"inventory_edit\"]","operationId":"UpdateSupplierProposal","parameters":[{"$ref":"#/components/parameters/AccountIdHeaderOptional"},{"$ref":"#/components/parameters/ClientIdHeader"},{"$ref":"#/components/parameters/ManagerAccountIdHeaderOptional"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateSupplierProposalRequest"}}},"required":true},"responses":{"207":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierProposalMultiStatusResponse"}}},"description":"UpdateSupplierProposal 207 response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestResponseContent"}}},"description":"BadRequest 400 response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedResponseContent"}}},"description":"Unauthorized 401 response"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenResponseContent"}}},"description":"Forbidden 403 response"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundResponseContent"}}},"description":"NotFound 404 response"},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentTooLargeResponseContent"}}},"description":"ContentTooLarge 413 response"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequestsResponseContent"}}},"description":"TooManyRequests 429 response"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorResponseContent"}}},"description":"InternalServerError 500 response"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadGatewayResponseContent"}}},"description":"BadGateway 502 response"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailableErrorResponseContent"}}},"description":"ServiceUnavailableError 503 response"},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayTimeoutResponseContent"}}},"description":"GatewayTimeout 504 response"}},"security":[{"OAuth2":["advertising::campaign_management"]}],"tags":["SupplierProposals"]}}},"servers":[{"description":"Production server for NA","url":"https://advertising-api.amazon.com"},{"description":"Production server for EU","url":"https://advertising-api-eu.amazon.com"},{"description":"Production server for FE","url":"https://advertising-api-fe.amazon.com"}]}