{"components":{"callbacks":{},"examples":{},"headers":{},"links":{},"parameters":{"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"}}},"requestBodies":{},"responses":{},"schemas":{"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","AL","AM","AO","AQ","AR","AS","AT","AU","AW","AX","AZ","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BL","BM","BN","BO","BQ","BR","BS","BT","BV","BW","BY","BZ","CA","CC","CD","CF","CG","CH","CI","CK","CL","CM","CN","CO","CR","CU","CV","CW","CX","CY","CZ","DE","DJ","DK","DM","DO","DZ","EC","EE","EG","EH","ER","ES","ET","FI","FJ","FK","FM","FO","FR","GA","GB","GD","GE","GF","GG","GH","GI","GL","GM","GN","GP","GQ","GR","GS","GT","GU","GW","GY","HK","HM","HN","HR","HT","HU","ID","IE","IL","IM","IN","IO","IQ","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","MA","MC","MD","ME","MF","MG","MH","MK","ML","MM","MN","MO","MP","MQ","MR","MS","MT","MU","MV","MW","MX","MY","MZ","NA","NC","NE","NF","NG","NI","NL","NO","NP","NR","NU","NZ","OM","PA","PE","PF","PG","PH","PK","PL","PM","PN","PR","PS","PT","PW","PY","QA","RE","RO","RS","RU","RW","SA","SB","SC","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","SZ","TC","TD","TF","TG","TH","TJ","TK","TL","TM","TN","TO","TR","TT","TV","TW","TZ","UA","UG","UM","US","UY","UZ","VA","VC","VE","VG","VI","VN","VU","WF","WS","YE","YT","ZA","ZM","ZW"],"type":"string"},"ErrorCode":{"description":"**ErrorCode Enum:**\n| ErrorCode | Description |\n| --- | --- |\n| `INTERNAL_ERROR` | The server encountered an unexpected condition that prevented it from fulfilling the request. |\n| `UNAUTHORIZED` | The request lacks the necessary credentials. |\n| `FORBIDDEN` | The caller is not authorized to make the given request. |\n| `TOO_MANY_REQUESTS` | There have been too many requests, please slow down your call rate. |\n| `CONTENT_TOO_LARGE` | The request is too large. Consider splitting it into multiple requests. |\n| `NOT_FOUND` | The requested resource does not exist. |\n| `BAD_REQUEST` | The request is not valid considering the documented schema. |\n| `ACCESS_DENIED_FOR_MANAGER_ACCOUNT` | The request does not have access to the manager account provided in the registration request. |\n| `ADDRESS_BUSINESS_NAME_TOO_LONG` | Business name provided is too long. |\n| `ACCOUNT_ALREADY_EXISTS_FOR_SELLING_ACCOUNT` | An advertiser account already exists for this selling account. |\n| `ACCOUNT_ALREADY_EXISTS_FOR_VENDOR` | An advertiser account already exists for the selected vendor. |\n| `ACCOUNT_ALREADY_EXISTS_FOR_ACCOUNT_NAME` | An advertiser account already exists with this display name. |\n| `MISSING_COUNTRY_CODE` | Country is missing in business address. |\n| `MISSING_BUSINESS_NAME` | Business name is missing from business detail. |\n| `MISSING_ADDRESS_LINE_ONE` | Address line 1 is missing in business address. |\n| `MISSING_CITY` | City is missing in business address. |\n| `MISSING_ZIP_CODE` | Zip code is missing in business address. |\n| `MISSING_PHONE_NUMBER` | Phone number is missing from business detail. |\n| `MISSING_STATE` | State is missing in business address. |\n| `MISSING_WEBSITE_URL` | Website url is missing from business detail. |\n| `ADDRESS_INVALID_STATE` | The state provided in business address is invalid. |\n| `INVALID_STATE_OR_REGION` | The state provided in business address is invalid. |\n| `INVALID_ZIP_CODE` | The zip code provided in business address is invalid. |\n| `INVALID_WEBSITE_URL` | The website url provided in business detail is invalid |\n| `INVALID_INPUT` | The request has invalid input parameters. |","enum":["ACCESS_DENIED_FOR_MANAGER_ACCOUNT","ACCOUNT_ALREADY_EXISTS_FOR_ACCOUNT_NAME","ACCOUNT_ALREADY_EXISTS_FOR_SELLING_ACCOUNT","ACCOUNT_ALREADY_EXISTS_FOR_VENDOR","ADDRESS_BUSINESS_NAME_TOO_LONG","ADDRESS_INVALID_STATE","BAD_REQUEST","CONTENT_TOO_LARGE","FORBIDDEN","INTERNAL_ERROR","INVALID_INPUT","INVALID_STATE_OR_REGION","INVALID_WEBSITE_URL","INVALID_ZIP_CODE","MISSING_ADDRESS_LINE_ONE","MISSING_BUSINESS_NAME","MISSING_CITY","MISSING_COUNTRY_CODE","MISSING_PHONE_NUMBER","MISSING_STATE","MISSING_WEBSITE_URL","MISSING_ZIP_CODE","NOT_FOUND","TOO_MANY_REQUESTS","UNAUTHORIZED"],"type":"string"},"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"},"Portal":{"enum":["AUTHOR_CENTRAL","GROCERY_CENTRAL","KDP_CENTRAL","MERCH","SELLER_CENTRAL","VENDOR_CENTRAL"],"type":"string"},"QuerySellingAccountRequest":{"properties":{"maxResults":{"default":100,"format":"int32","maximum":100,"minimum":10,"type":"integer"},"nextToken":{"type":"string"},"sellingAccountLinkTokenFilter":{"$ref":"#/components/schemas/SellingAccountSellingAccountLinkTokenFilter"},"sellingProgramFilter":{"$ref":"#/components/schemas/SellingAccountSellingProgramFilter"}},"type":"object"},"SellingAccount":{"properties":{"business":{"$ref":"#/components/schemas/SellingAccountBusiness"},"countryCodes":{"description":"The countries of the selling account user can advertise in.","items":{"$ref":"#/components/schemas/CountryCode"},"maxItems":30,"minItems":0,"type":"array"},"displayName":{"description":"Display name for the selling account.","type":"string"},"portals":{"description":"The portal(s) used to access the selling account.","items":{"$ref":"#/components/schemas/Portal"},"maxItems":6,"minItems":1,"type":"array"},"sellingAccountLinkToken":{"description":"The token to locate a selling account.","type":"string"},"sellingProgram":{"$ref":"#/components/schemas/SellingProgram"}},"required":["portals","sellingAccountLinkToken","sellingProgram"],"type":"object"},"SellingAccountAddress":{"description":"The business address of selling account.","format":"password","properties":{"addressLine1":{"description":"The address details - 1 of business.","format":"password","type":"string"},"addressLine2":{"description":"The address details - 2 of business.","format":"password","type":"string"},"addressToken":{"description":"The token to locate a business address.","format":"password","type":"string"},"businessName":{"description":"The name of business.","format":"password","type":"string"},"city":{"description":"The city where business is located.","format":"password","type":"string"},"countryCode":{"description":"The country where business is located.","format":"password","type":"string"},"phoneNumber":{"description":"The phone number of business.","format":"password","type":"string"},"state":{"description":"The city where business is located.","format":"password","type":"string"},"zipCode":{"description":"The zipCode where business is located.","format":"password","type":"string"}},"required":["addressLine1","addressToken","businessName","city","countryCode","state","zipCode"],"type":"object"},"SellingAccountBusiness":{"description":"The business details of selling account.","properties":{"addresses":{"description":"A list of business address the selling account has.","items":{"$ref":"#/components/schemas/SellingAccountAddress"},"maxItems":10,"minItems":0,"type":"array"},"website":{"description":"The website of the business.","format":"password","type":"string"}},"type":"object"},"SellingAccountSellingAccountLinkTokenFilter":{"properties":{"include":{"items":{"type":"string"},"maxItems":1,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"SellingAccountSellingProgramFilter":{"properties":{"include":{"items":{"$ref":"#/components/schemas/SellingProgram"},"maxItems":1,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"SellingAccountSuccessResponse":{"properties":{"nextToken":{"type":"string"},"sellingAccounts":{"items":{"$ref":"#/components/schemas/SellingAccount"},"maxItems":100,"minItems":0,"type":"array"}},"type":"object"},"SellingProgram":{"enum":["AMAZON_AUTHOR","AMAZON_SELLER","AMAZON_VENDOR"],"type":"string"},"ServiceUnavailableErrorResponseContent":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"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"}},"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":"SellingAccounts API","version":"3.0"},"openapi":"3.0.1","paths":{"/adsApi/v1/query/sellingAccounts":{"post":{"description":"List selling accounts\n\n**Requires one of these permissions**:\n[]","operationId":"QuerySellingAccount","parameters":[{"$ref":"#/components/parameters/ClientIdHeader"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuerySellingAccountRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SellingAccountSuccessResponse"}}},"description":"QuerySellingAccount 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":["SellingAccounts"]}}},"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"}]}