{"components":{"callbacks":{},"examples":{},"headers":{},"links":{},"parameters":{},"requestBodies":{},"responses":{},"schemas":{"AccessDeniedErrorCode":{"enum":["ACCESS_DENIED"],"type":"string"},"AccessDeniedExceptionResponseContent":{"description":"AccessDeniedException 403 response.","properties":{"code":{"$ref":"#/components/schemas/AccessDeniedErrorCode"},"details":{"description":"Error details.","type":"string"},"errors":{"items":{"$ref":"#/components/schemas/SubError"},"maxItems":100,"minItems":0,"type":"array"},"message":{"description":"Human readable error message.","type":"string"},"requestId":{"description":"Request Id.","type":"string"}},"required":["code","message","requestId"],"type":"object"},"CreateHistoricalReachCurveRequestContent":{"description":"Request to generate a historical reach curve.","properties":{"endDate":{"description":"The end date for the curve data. This is in the ISO 8601 format. For example 2023-01-31.","example":"2023-01-31","format":"date","type":"string"},"startDate":{"description":"The start date for the curve data. This is in the ISO 8601 format. For example 2023-01-01.","example":"2023-01-01","format":"date","type":"string"},"targeting":{"description":"A list of dimensions that build the targeting expression that is used for generating a reach curve.","items":{"$ref":"#/components/schemas/TargetingDimension"},"maxItems":1000,"minItems":0,"type":"array"}},"required":["endDate","startDate","targeting"],"type":"object"},"CreateHistoricalReachCurveResponseContent":{"description":"Success response for generating a historical reach curve.","properties":{"message":{"description":"A message regarding the response.","type":"string"},"reportId":{"description":"The report ID.","type":"string"},"status":{"description":"The status of the report.\nThe status values are [`PENDING`, `PROCESSING`, `COMPLETED`, `FAILED`].","type":"string"}},"type":"object"},"DimensionType":{"enum":["GROUP","MULTIPLE","SINGLE"],"type":"string"},"ErrorType":{"description":"Error Type.","enum":["UNAUTHORIZED"],"type":"string"},"FrequencyThresholdReach":{"properties":{"frequencyThreshold":{"type":"integer"},"reach":{"type":"integer"}},"type":"object"},"GetHistoricalReachCurveResponseContent":{"description":"Success response for getting the generated historical reach curve.","properties":{"dataPoints":{"description":"List of historical reach curve data points.","items":{"$ref":"#/components/schemas/HistoricalReachCurveDataPointV2"},"maxItems":1000,"minItems":0,"type":"array"},"nextToken":{"description":"The token to retrieve the next set of data points. This will be `null` if there are no data points left to retrieve.","type":"string"},"totalResults":{"description":"The total number of data points.","type":"integer"}},"type":"object"},"GetHistoricalReachCurveStatusResponseContent":{"description":"Success response for getting the status of the generation of a historical reach curve.","properties":{"message":{"description":"A message regarding the response.","type":"string"},"reportId":{"description":"The report ID.","type":"string"},"status":{"description":"The status of the report.\nThe status values are [`PENDING`, `PROCESSING`, `COMPLETED`, `FAILED`].","type":"string"}},"type":"object"},"HistoricalReachCurveDataPoint":{"description":"A data point in the Reach Curve for Historical data.","properties":{"channel":{"description":"Supply package for which the reach curve has been generated.","type":"string"},"demographic":{"description":"The demographic segment applied to the reach curve.","type":"string"},"endDate":{"description":"The end of the time window the reach curve is based on.","format":"date-time","type":"string"},"geography":{"$ref":"#/components/schemas/Marketplace"},"impressions":{"description":"The number of ads that were delivered.","type":"integer"},"reach":{"$ref":"#/components/schemas/ReachFrequency"},"reachType":{"description":"The type of reach, for example INDIVIDUALS or HOUSEHOLDS.","type":"string"},"startDate":{"description":"The beginning of the time window the reach curve is based on.","format":"date-time","type":"string"}},"type":"object"},"HistoricalReachCurveDataPointV2":{"properties":{"demographic":{"type":"string"},"endDate":{"description":"The format of the date is YYYY-MM-DD.","example":"2023-01-31","format":"date","type":"string"},"frequencyThresholdReach":{"items":{"$ref":"#/components/schemas/FrequencyThresholdReach"},"maxItems":1000,"minItems":0,"type":"array"},"geography":{"$ref":"#/components/schemas/Marketplace"},"impressions":{"type":"integer"},"reachType":{"type":"string"},"startDate":{"description":"The format of the date is YYYY-MM-DD.","example":"2023-01-01","format":"date","type":"string"},"supplyPackage":{"type":"string"}},"type":"object"},"HistoricalReachCurvesMetadata":{"properties":{"channels":{"description":"List of channels that were used for showing the ads.","items":{"type":"string"},"type":"array"},"demographics":{"description":"List of demographics of the audience that are represented in the data.","items":{"type":"string"},"type":"array"},"geography":{"description":"Name of the locale/geography that the metadata belongs to.","type":"string"},"reachTypes":{"description":"List of the different reach types available to request.","items":{"type":"string"},"type":"array"}},"type":"object"},"InternalErrorErrorCode":{"enum":["INTERNAL_ERROR"],"type":"string"},"InternalServerExceptionResponseContent":{"description":"InternalServerException 500 response.","properties":{"code":{"$ref":"#/components/schemas/InternalErrorErrorCode"},"details":{"description":"Error details.","type":"string"},"errors":{"items":{"$ref":"#/components/schemas/SubError"},"maxItems":100,"minItems":0,"type":"array"},"message":{"description":"Human readable error message.","type":"string"},"requestId":{"description":"Request Id.","type":"string"}},"required":["code","message","requestId"],"type":"object"},"InvalidArgumentErrorCode":{"enum":["INVALID_ARGUMENT"],"type":"string"},"ListHistoricalReachCurvesMetadataRequestContent":{"properties":{"geography":{"description":"The locales/geographies that the metadata belongs to.","type":"string"},"month":{"description":"The month that the metadata belongs to in the format MM/YYYY.","pattern":"^(\\d){1,2}\\/(\\d){4}$","type":"string"}},"type":"object"},"ListHistoricalReachCurvesMetadataResponseContent":{"description":"Historical Reach Curves Metadata - 200 Response.","properties":{"metadata":{"description":"List of Historical Reach Curves metadata separated by geography.","items":{"$ref":"#/components/schemas/HistoricalReachCurvesMetadata"},"type":"array"},"month":{"description":"The month that this data belongs to.","type":"string"}},"type":"object"},"ListHistoricalReachCurvesRequestContent":{"properties":{"maxResults":{"default":"1000","description":"Number of records to include in the paginated response. Defaults to 1000.","maximum":1000,"minimum":1,"type":"integer"},"month":{"description":"The month of data that will be returned. Defaults to the most recent month of data that is available for the given geography.","pattern":"^(\\d){1,2}\\/(\\d){4}$","type":"string"},"nextToken":{"description":"Token to retrieve the next set/page of data points.","type":"string"},"targeting":{"$ref":"#/components/schemas/Targeting"}},"required":["targeting"],"type":"object"},"ListHistoricalReachCurvesResponseContent":{"description":"Historical Reach Curves 200 response.","properties":{"historicalReachCurves":{"description":"List of data points for a curve that shows historical reach. The default list size is 1000 data points.","items":{"$ref":"#/components/schemas/HistoricalReachCurveDataPoint"},"maxItems":1000,"minItems":0,"type":"array"},"nextToken":{"description":"The token to retrieve the next set/page of data points.","type":"string"},"totalResults":{"description":"Total available data points for the requested resource.","type":"integer"}},"type":"object"},"LogicalOperator":{"enum":["AND","OR"],"type":"string"},"Marketplace":{"enum":["AE","AT","AU","BR","CA","DE","EG","ES","FR","GB","IN","IT","JP","MX","NL","PL","SA","SE","SG","TR","US"],"type":"string"},"NotFoundErrorCode":{"enum":["NOT_FOUND"],"type":"string"},"ReachFrequency":{"description":"The frequency of exposures to households or individuals.","properties":{"fivePlus":{"description":"Number of ads viewed at least five times.","type":"integer"},"fourPlus":{"description":"Number of ads viewed at least four times.","type":"integer"},"onePlus":{"description":"Number of ads viewed at least once.","type":"integer"},"sixPlus":{"description":"Number of ads viewed at least six times.","type":"integer"},"threePlus":{"description":"Number of ads viewed at least thrice.","type":"integer"},"twoPlus":{"description":"Number of ads viewed at least twice.","type":"integer"}},"type":"object"},"ResourceNotFoundExceptionResponseContent":{"description":"Resource Not Found. 404 Response.","properties":{"code":{"$ref":"#/components/schemas/NotFoundErrorCode"},"details":{"description":"Error details.","type":"string"},"errors":{"items":{"$ref":"#/components/schemas/SubError"},"maxItems":100,"minItems":0,"type":"array"},"message":{"description":"Human readable error message.","type":"string"},"requestId":{"description":"Request Id.","type":"string"}},"required":["code","message","requestId"],"type":"object"},"SchemaValidationExceptionResponseContent":{"description":"SchemaValidationException 400 response.","properties":{"code":{"$ref":"#/components/schemas/InvalidArgumentErrorCode"},"details":{"description":"Error details.","type":"string"},"errors":{"items":{"$ref":"#/components/schemas/SubError"},"maxItems":100,"minItems":0,"type":"array"},"message":{"description":"Human readable error message.","type":"string"},"requestId":{"description":"Request Id.","type":"string"}},"required":["code","message","requestId"],"type":"object"},"SubError":{"properties":{"errorCode":{"type":"integer"},"errorMessage":{"description":"Human readable error message.","type":"string"},"errorType":{"$ref":"#/components/schemas/ErrorType"}},"type":"object"},"Targeting":{"properties":{"channels":{"description":"The mode that ads were delivered. For example \"STV\" and \"Prime_Video\".","items":{"type":"string"},"type":"array"},"demographics":{"description":"The demographic segments of the users included in the reach curve.","items":{"type":"string"},"type":"array"},"geography":{"description":"The geography of the users included in the reach curve.","type":"string"},"reachType":{"description":"The type of reach recorded for the data. Possible values are \"INDIVIDUALS\" and \"HOUSEHOLDS\".","type":"string"}},"required":["geography"],"type":"object"},"TargetingDimension":{"properties":{"dimensionGroups":{"description":"A list of targeting dimensions that allows you to have nested targeting dimensions. Typically, you will only\nuse this for the `audienceId` dimension.","items":{"$ref":"#/components/schemas/TargetingDimension"},"maxItems":1000,"minItems":0,"type":"array"},"dimensionName":{"description":"The name of the dimension you are targeting.\n\nThe available dimension names are:\n| Dimension Name | Allowed Dimension Types |\n|----------------|-------------------------|\n| `supplyPackage` | `SINGLE` |\n| `demographic` | `SINGLE` |\n| `reachType` | `SINGLE` |\n| `geography` | `SINGLE` |\n| `frequencyThreshold` | `SINGLE` |\n| `audienceId` | `SINGLE`, `MULTIPLE`, `GROUP` |\n\nThe following table contains certain dimensions and their corresponding possible values.\n| Dimension Name | Description | Available Dimension Values |\n|----------------|-------------|----------------------------|\n| supplyPackage | The supply source of the data that will generate the reach curve. | \u0027STV\u0027 |\n| reachType | Whether the targeted audience are individuals or households. | \u0027INDIVIDUALS\u0027, \u0027HOUSEHOLDS\u0027 |\n| geography | The location for which to generate a reach curve. | \u0027US\u0027 |\n| frequencyThreshold | The minimum number of times an ad was shown. | \u00271\u0027, \u00272\u0027, \u00273\u0027, \u00274\u0027, \u00275\u0027, \u00276\u0027 |\n| audienceId | The ID of an audience that is targeted to generate the reach curve. | |\n| demographic | The demographic that is targeted to generate the reach curve. | |.","type":"string"},"dimensionType":{"$ref":"#/components/schemas/DimensionType"},"dimensionValue":{"description":"The value of the dimension you are targeting.","type":"string"},"dimensionValues":{"description":"A list of values of the dimension you are targeting.\nThe max limit varies on the dimension name.","items":{"type":"string"},"maxItems":1000,"minItems":0,"type":"array"},"interOperator":{"$ref":"#/components/schemas/LogicalOperator"},"intraOperator":{"$ref":"#/components/schemas/LogicalOperator"},"isNot":{"description":"Whether to negate this dimension or not.","type":"boolean"}},"type":"object"},"ThrottledErrorCode":{"enum":["THROTTLED"],"type":"string"},"ThrottlingExceptionResponseContent":{"description":"ThrottlingException 429 response.","properties":{"code":{"$ref":"#/components/schemas/ThrottledErrorCode"},"details":{"description":"Error details.","type":"string"},"errors":{"items":{"$ref":"#/components/schemas/SubError"},"maxItems":100,"minItems":0,"type":"array"},"message":{"description":"Human readable error message.","type":"string"},"requestId":{"description":"Request Id.","type":"string"}},"required":["code","message","requestId"],"type":"object"},"UnauthorizedErrorCode":{"enum":["UNAUTHORIZED"],"type":"string"},"UnauthorizedExceptionResponseContent":{"description":"UnauthorizedException 401 response.","properties":{"code":{"$ref":"#/components/schemas/UnauthorizedErrorCode"},"details":{"description":"Error details.","type":"string"},"errors":{"items":{"$ref":"#/components/schemas/SubError"},"maxItems":100,"minItems":0,"type":"array"},"message":{"description":"Human readable error message.","type":"string"},"requestId":{"description":"Request Id.","type":"string"}},"required":["code","message","requestId"],"type":"object"},"UnsupportedMediaTypeErrorCode":{"enum":["UNSUPPORTED_MEDIA_TYPE"],"type":"string"},"UnsupportedMediaTypeExceptionResponseContent":{"description":"UnsupportedMediaTypeException 415 response.","properties":{"code":{"$ref":"#/components/schemas/UnsupportedMediaTypeErrorCode"},"details":{"description":"Error details.","type":"string"},"errors":{"items":{"$ref":"#/components/schemas/SubError"},"maxItems":100,"minItems":0,"type":"array"},"message":{"description":"Human readable error message.","type":"string"},"requestId":{"description":"Request Id.","type":"string"}},"required":["code","message","requestId"],"type":"object"}},"securitySchemes":{}},"info":{"description":"APIs for gaining insights into Amazon\u0027s historical reach.","title":"Media Insights Hub","version":"3.0"},"openapi":"3.0.1","paths":{"/mediaPlan/historicalReachCurves/list":{"post":{"description":"Lists Historical Reach Curves.\n\n**Authorized resource type**:\nDSP Rodeo Entity ID, DSP Advertiser Account ID\n\n**Parameter name**:\nAmazon-Ads-AccountId\n\n**Parameter in**:\nheader\n\n**Requires one of these permissions**:\n[\"campaign_view\"]\n\n**Authorized resource type**:\nGlobal Ad Account ID, Profile ID\n\n**Parameter name**:\nAmazon-Ads-AccountId\n\n**Parameter in**:\nheader\n\n**Requires one of these permissions**:\n[\"campaign_view\"]","operationId":"ListHistoricalReachCurves","parameters":[{"description":"Account identifier you use to access the DSP. This is your Amazon DSP Advertiser ID.","in":"header","name":"Amazon-Ads-AccountId","schema":{"description":"Account identifier you use to access the DSP. This is your Amazon DSP Advertiser ID.","type":"string"}},{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","examples":{"ListHistoricalReachCurves_example1":{"description":".","summary":"Get recent historical reach curves.","value":"amzn1.application-oa2-client.abcdefg1234567890"},"ListHistoricalReachCurves_example2":{"description":".","summary":"Reach curve response when there is no data for the given geography and month combination.","value":"amzn1.application-oa2-client.abcdefg1234567890"}},"in":"header","name":"Amazon-Advertising-API-ClientId","required":true,"schema":{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","type":"string"}},{"description":"The identifier of a profile associated with the advertiser account. Use `GET` method on Profiles\nresource to list profiles associated with the access token passed in the HTTP Authorization\nheader and choose profile id `profileId` from the response to pass it as input.","examples":{"ListHistoricalReachCurves_example1":{"description":".","summary":"Get recent historical reach curves.","value":"2095123454329876"},"ListHistoricalReachCurves_example2":{"description":".","summary":"Reach curve response when there is no data for the given geography and month combination.","value":"2095123454329876"}},"in":"header","name":"Amazon-Advertising-API-Scope","schema":{"description":"The identifier of a profile associated with the advertiser account. Use `GET` method on Profiles\nresource to list profiles associated with the access token passed in the HTTP Authorization\nheader and choose profile id `profileId` from the response to pass it as input.","type":"string"}}],"requestBody":{"content":{"application/vnd.mediaplanhistoricalreachcurves.v1+json":{"examples":{"ListHistoricalReachCurves_example1":{"description":".","summary":"Get recent historical reach curves.","value":{"maxResults":2,"month":"02/2023","nextToken":"%6A%22VI3wDokCxd5UyqYJwFE_%55%5C","targeting":{"channels":["STV"],"demographics":["A18_PLUS","P2_PLUS"],"geography":"US","reachType":"INDIVIDUALS"}}},"ListHistoricalReachCurves_example2":{"description":".","summary":"Reach curve response when there is no data for the given geography and month combination.","value":{"month":"01/2024","targeting":{"geography":"MX"}}}},"schema":{"$ref":"#/components/schemas/ListHistoricalReachCurvesRequestContent"}}},"required":true},"responses":{"200":{"content":{"application/vnd.mediaplanhistoricalreachcurves.v1+json":{"examples":{"ListHistoricalReachCurves_example1":{"description":".","summary":"Get recent historical reach curves.","value":{"historicalReachCurves":[{"channel":"STV","demographic":"A18_PLUS","endDate":"2023-02-28T12:29:08.009Z","impressions":"10","reach":{"fivePlus":"2","fourPlus":"4","onePlus":"10","sixPlus":"0","threePlus":"6","twoPlus":"8"},"reachType":"INDIVIDUALS","startDate":"2023-02-01T12:29:08.009Z"},{"channel":"STV","demographic":"P2_PLUS","endDate":"2023-02-28T12:29:08.009Z","impressions":"100","reach":{"fivePlus":"20","fourPlus":"40","onePlus":"100","sixPlus":"0","threePlus":"60","twoPlus":"80"},"reachType":"INDIVIDUALS","startDate":"2023-02-01T12:29:08.009Z"}],"nextToken":"%6A%22VI3wDokCxd5UyqYJwFE_%55%5C","totalResults":4}},"ListHistoricalReachCurves_example2":{"description":".","summary":"Reach curve response when there is no data for the given geography and month combination.","value":{"historicalReachCurves":[],"totalResults":0}}},"schema":{"$ref":"#/components/schemas/ListHistoricalReachCurvesResponseContent"}}},"description":"ListHistoricalReachCurves 200 response."},"400":{"content":{"application/vnd.error.v1+json":{"schema":{"$ref":"#/components/schemas/SchemaValidationExceptionResponseContent"}}},"description":"SchemaValidationException 400 response."},"401":{"content":{"application/vnd.error.v1+json":{"schema":{"$ref":"#/components/schemas/UnauthorizedExceptionResponseContent"}}},"description":"UnauthorizedException 401 response."},"403":{"content":{"application/vnd.error.v1+json":{"schema":{"$ref":"#/components/schemas/AccessDeniedExceptionResponseContent"}}},"description":"AccessDeniedException 403 response."},"404":{"content":{"application/vnd.error.v1+json":{"schema":{"$ref":"#/components/schemas/ResourceNotFoundExceptionResponseContent"}}},"description":"ResourceNotFoundException 404 response."},"415":{"content":{"application/vnd.error.v1+json":{"schema":{"$ref":"#/components/schemas/UnsupportedMediaTypeExceptionResponseContent"}}},"description":"UnsupportedMediaTypeException 415 response."},"429":{"content":{"application/vnd.error.v1+json":{"schema":{"$ref":"#/components/schemas/ThrottlingExceptionResponseContent"}}},"description":"ThrottlingException 429 response.","headers":{"Retry-After":{"description":"Delay in seconds, before the next re-try attempt to the operation is recommended.","schema":{"description":"Delay in seconds, before the next re-try attempt to the operation is recommended.","type":"integer"}}}},"500":{"content":{"application/vnd.error.v1+json":{"schema":{"$ref":"#/components/schemas/InternalServerExceptionResponseContent"}}},"description":"InternalServerException 500 response."}},"tags":["HistoricalReachCurves"]}},"/mediaPlan/historicalReachCurvesMetadata/list":{"post":{"description":"\n\n**Authorized resource type**:\nDSP Rodeo Entity ID, DSP Advertiser Account ID\n\n**Parameter name**:\nAmazon-Ads-AccountId\n\n**Parameter in**:\nheader\n\n**Requires one of these permissions**:\n[\"campaign_view\"]\n\n**Authorized resource type**:\nGlobal Ad Account ID, Profile ID\n\n**Parameter name**:\nAmazon-Ads-AccountId\n\n**Parameter in**:\nheader\n\n**Requires one of these permissions**:\n[\"campaign_view\"]","operationId":"ListHistoricalReachCurvesMetadata","parameters":[{"description":"Account identifier you use to access the DSP. This is your Amazon DSP Advertiser ID.","in":"header","name":"Amazon-Ads-AccountId","schema":{"description":"Account identifier you use to access the DSP. This is your Amazon DSP Advertiser ID.","type":"string"}},{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","examples":{"ListHistoricalReachCurvesMetadata_example1":{"description":".","summary":"Get reach curve metadata of all available geographies for the specified month.","value":"YOUR_CLIENT_ID"},"ListHistoricalReachCurvesMetadata_example2":{"description":".","summary":"Get reach curve metadata of the specified geography and month.","value":"YOUR_CLIENT_ID"},"ListHistoricalReachCurvesMetadata_example3":{"description":".","summary":"Get reach curve metadata of all the geographies for the most recent month.","value":"YOUR_CLIENT_ID"}},"in":"header","name":"Amazon-Advertising-API-ClientId","required":true,"schema":{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","type":"string"}},{"description":"The identifier of a profile associated with the advertiser account. Use `GET` method on Profiles\nresource to list profiles associated with the access token passed in the HTTP Authorization\nheader and choose profile id `profileId` from the response to pass it as input.","examples":{"ListHistoricalReachCurvesMetadata_example1":{"description":".","summary":"Get reach curve metadata of all available geographies for the specified month.","value":"ADVERTISER_ID"},"ListHistoricalReachCurvesMetadata_example2":{"description":".","summary":"Get reach curve metadata of the specified geography and month.","value":"ADVERTISER_ID"},"ListHistoricalReachCurvesMetadata_example3":{"description":".","summary":"Get reach curve metadata of all the geographies for the most recent month.","value":"ADVERTISER_ID"}},"in":"header","name":"Amazon-Advertising-API-Scope","schema":{"description":"The identifier of a profile associated with the advertiser account. Use `GET` method on Profiles\nresource to list profiles associated with the access token passed in the HTTP Authorization\nheader and choose profile id `profileId` from the response to pass it as input.","type":"string"}}],"requestBody":{"content":{"application/vnd.mediaplanhistoricalreachcurves.v1+json":{"examples":{"ListHistoricalReachCurvesMetadata_example1":{"description":".","summary":"Get reach curve metadata of all available geographies for the specified month.","value":{"month":"02/2023"}},"ListHistoricalReachCurvesMetadata_example2":{"description":".","summary":"Get reach curve metadata of the specified geography and month.","value":{"geography":"GB","month":"02/2023"}},"ListHistoricalReachCurvesMetadata_example3":{"description":".","summary":"Get reach curve metadata of all the geographies for the most recent month."}},"schema":{"$ref":"#/components/schemas/ListHistoricalReachCurvesMetadataRequestContent"}}}},"responses":{"200":{"content":{"application/vnd.mediaplanhistoricalreachcurves.v1+json":{"examples":{"ListHistoricalReachCurvesMetadata_example1":{"description":".","summary":"Get reach curve metadata of all available geographies for the specified month.","value":{"metadata":[{"channels":["STV"],"demographics":["A18_34","A18_PLUS","M18_PLUS"],"geography":"US","reachTypes":["HOUSEHOLDS","INDIVIDUALS"]},{"channels":["STV"],"demographics":["A18_PLUS","A35_PLUS","A50_PLUS","P2_PLUS"],"geography":"GB","reachTypes":["HOUSEHOLDS","INDIVIDUALS"]}],"month":"02/2023"}},"ListHistoricalReachCurvesMetadata_example2":{"description":".","summary":"Get reach curve metadata of the specified geography and month.","value":{"metadata":[{"channels":["STV"],"demographics":["A18_PLUS","A35_PLUS","A50_PLUS","P2_PLUS"],"geography":"GB","reachTypes":["HOUSEHOLDS","INDIVIDUALS"]}],"month":"02/2023"}},"ListHistoricalReachCurvesMetadata_example3":{"description":".","summary":"Get reach curve metadata of all the geographies for the most recent month.","value":{"metadata":[{"channels":["STV"],"demographics":["A18_34","A18_PLUS","M18_PLUS"],"geography":"US","reachTypes":["HOUSEHOLDS","INDIVIDUALS"]},{"channels":["STV"],"demographics":["A18_PLUS","A35_PLUS","A50_PLUS","P2_PLUS"],"geography":"GB","reachTypes":["HOUSEHOLDS","INDIVIDUALS"]}],"month":"06/2023"}}},"schema":{"$ref":"#/components/schemas/ListHistoricalReachCurvesMetadataResponseContent"}}},"description":"ListHistoricalReachCurvesMetadata 200 response."},"400":{"content":{"application/vnd.error.v1+json":{"schema":{"$ref":"#/components/schemas/SchemaValidationExceptionResponseContent"}}},"description":"SchemaValidationException 400 response."},"401":{"content":{"application/vnd.error.v1+json":{"schema":{"$ref":"#/components/schemas/UnauthorizedExceptionResponseContent"}}},"description":"UnauthorizedException 401 response."},"403":{"content":{"application/vnd.error.v1+json":{"schema":{"$ref":"#/components/schemas/AccessDeniedExceptionResponseContent"}}},"description":"AccessDeniedException 403 response."},"404":{"content":{"application/vnd.error.v1+json":{"schema":{"$ref":"#/components/schemas/ResourceNotFoundExceptionResponseContent"}}},"description":"ResourceNotFoundException 404 response."},"415":{"content":{"application/vnd.error.v1+json":{"schema":{"$ref":"#/components/schemas/UnsupportedMediaTypeExceptionResponseContent"}}},"description":"UnsupportedMediaTypeException 415 response."},"429":{"content":{"application/vnd.error.v1+json":{"schema":{"$ref":"#/components/schemas/ThrottlingExceptionResponseContent"}}},"description":"ThrottlingException 429 response.","headers":{"Retry-After":{"description":"Delay in seconds, before the next re-try attempt to the operation is recommended.","schema":{"description":"Delay in seconds, before the next re-try attempt to the operation is recommended.","type":"integer"}}}},"500":{"content":{"application/vnd.error.v1+json":{"schema":{"$ref":"#/components/schemas/InternalServerExceptionResponseContent"}}},"description":"InternalServerException 500 response."}},"tags":["HistoricalReachCurves"]}},"/mediaPlan/v2/historicalReachCurves":{"post":{"description":"Submit a request to generate a Historical Reach Curve.\n\n**Authorized resource type**:\nDSP Rodeo Entity ID, DSP Advertiser Account ID\n\n**Parameter name**:\nAmazon-Ads-AccountId\n\n**Parameter in**:\nheader\n\n**Requires one of these permissions**:\n[\"campaign_view\"]\n\n**Authorized resource type**:\nGlobal Ad Account ID, Profile ID\n\n**Parameter name**:\nAmazon-Ads-AccountId\n\n**Parameter in**:\nheader\n\n**Requires one of these permissions**:\n[\"campaign_view\"]","operationId":"CreateHistoricalReachCurve","parameters":[{"description":"Account identifier you use to access the DSP. This is your Amazon DSP Advertiser ID.","examples":{"CreateHistoricalReachCurve_example1":{"description":".","summary":"Example of generating US historical reach curve using one audience ID and a demographic type.","value":"2095123454329876"},"CreateHistoricalReachCurve_example2":{"description":".","summary":"Example of generating US historical reach curve using multiple audience IDs and one demographic type.","value":"2095123454329876"},"CreateHistoricalReachCurve_example3":{"description":"This example shows you how to use the `dimensionType` of `group`. Notice how, when a single audience ID is to be negated, a dimension type of group is used so you can add\n        multiple dimensions within it. The dimension with type of `group` sets the `intraOperator` to `OR`, which implies that all the dimension groups within the `dimensionGroups` list will be OR\u0027d against each other.\n        The first dimension group is of type `single` so that you can set just that audience ID to be negated. The next group sets the `interOperator` to `OR` so that each audience ID within the list of `dimensionValues` is OR\u0027d against each other.\n.","summary":"Example of generating US historical reach curve using multiple audience segments (with one negated) and one demographic type. This example will show you how to use the `dimensionType` of `group`.","value":"2095123454329876"}},"in":"header","name":"Amazon-Ads-AccountId","schema":{"description":"Account identifier you use to access the DSP. This is your Amazon DSP Advertiser ID.","type":"string"}},{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","examples":{"CreateHistoricalReachCurve_example1":{"description":".","summary":"Example of generating US historical reach curve using one audience ID and a demographic type.","value":"amzn1.application-oa2-client.fakeClient1234567890"},"CreateHistoricalReachCurve_example2":{"description":".","summary":"Example of generating US historical reach curve using multiple audience IDs and one demographic type.","value":"amzn1.application-oa2-client.fakeClient1234567890"},"CreateHistoricalReachCurve_example3":{"description":"This example shows you how to use the `dimensionType` of `group`. Notice how, when a single audience ID is to be negated, a dimension type of group is used so you can add\n        multiple dimensions within it. The dimension with type of `group` sets the `intraOperator` to `OR`, which implies that all the dimension groups within the `dimensionGroups` list will be OR\u0027d against each other.\n        The first dimension group is of type `single` so that you can set just that audience ID to be negated. The next group sets the `interOperator` to `OR` so that each audience ID within the list of `dimensionValues` is OR\u0027d against each other.\n.","summary":"Example of generating US historical reach curve using multiple audience segments (with one negated) and one demographic type. This example will show you how to use the `dimensionType` of `group`.","value":"amzn1.application-oa2-client.fakeClient1234567890"}},"in":"header","name":"Amazon-Advertising-API-ClientId","required":true,"schema":{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","type":"string"}},{"description":"The identifier of a profile associated with the advertiser account. Use `GET` method on Profiles\nresource to list profiles associated with the access token passed in the HTTP Authorization\nheader and choose profile id `profileId` from the response to pass it as input.","examples":{"CreateHistoricalReachCurve_example1":{"description":".","summary":"Example of generating US historical reach curve using one audience ID and a demographic type.","value":"123123123123123"},"CreateHistoricalReachCurve_example2":{"description":".","summary":"Example of generating US historical reach curve using multiple audience IDs and one demographic type.","value":"123123123123123"},"CreateHistoricalReachCurve_example3":{"description":"This example shows you how to use the `dimensionType` of `group`. Notice how, when a single audience ID is to be negated, a dimension type of group is used so you can add\n        multiple dimensions within it. The dimension with type of `group` sets the `intraOperator` to `OR`, which implies that all the dimension groups within the `dimensionGroups` list will be OR\u0027d against each other.\n        The first dimension group is of type `single` so that you can set just that audience ID to be negated. The next group sets the `interOperator` to `OR` so that each audience ID within the list of `dimensionValues` is OR\u0027d against each other.\n.","summary":"Example of generating US historical reach curve using multiple audience segments (with one negated) and one demographic type. This example will show you how to use the `dimensionType` of `group`.","value":"123123123123123"}},"in":"header","name":"Amazon-Advertising-API-Scope","schema":{"description":"The identifier of a profile associated with the advertiser account. Use `GET` method on Profiles\nresource to list profiles associated with the access token passed in the HTTP Authorization\nheader and choose profile id `profileId` from the response to pass it as input.","type":"string"}}],"requestBody":{"content":{"application/json":{"examples":{"CreateHistoricalReachCurve_example1":{"description":".","summary":"Example of generating US historical reach curve using one audience ID and a demographic type.","value":{"endDate":"2023-05-31","startDate":"2023-05-01","targeting":[{"dimensionName":"geography","dimensionType":"SINGLE","dimensionValue":"US"},{"dimensionName":"frequencyThreshold","dimensionType":"SINGLE","dimensionValue":"2"},{"dimensionName":"supplyPackage","dimensionType":"SINGLE","dimensionValue":"STV"},{"dimensionName":"reachType","dimensionType":"SINGLE","dimensionValue":"INDIVIDUALS"},{"dimensionName":"demographic","dimensionType":"SINGLE","dimensionValue":"M18_35"},{"dimensionName":"audienceId","dimensionType":"SINGLE","dimensionValue":"123123123"}]}},"CreateHistoricalReachCurve_example2":{"description":".","summary":"Example of generating US historical reach curve using multiple audience IDs and one demographic type.","value":{"endDate":"2023-02-28","startDate":"2023-02-01","targeting":[{"dimensionName":"geography","dimensionType":"SINGLE","dimensionValue":"US"},{"dimensionName":"frequencyThreshold","dimensionType":"SINGLE","dimensionValue":"2"},{"dimensionName":"supplyPackage","dimensionType":"SINGLE","dimensionValue":"STV"},{"dimensionName":"reachType","dimensionType":"SINGLE","dimensionValue":"INDIVIDUALS"},{"dimensionName":"demographic","dimensionType":"SINGLE","dimensionValue":"M18_35"},{"dimensionName":"audienceId","dimensionType":"MULTIPLE","dimensionValues":["123123123","321321321","789789789"],"interOperator":"OR"}]}},"CreateHistoricalReachCurve_example3":{"description":"This example shows you how to use the `dimensionType` of `group`. Notice how, when a single audience ID is to be negated, a dimension type of group is used so you can add\n        multiple dimensions within it. The dimension with type of `group` sets the `intraOperator` to `OR`, which implies that all the dimension groups within the `dimensionGroups` list will be OR\u0027d against each other.\n        The first dimension group is of type `single` so that you can set just that audience ID to be negated. The next group sets the `interOperator` to `OR` so that each audience ID within the list of `dimensionValues` is OR\u0027d against each other.\n.","summary":"Example of generating US historical reach curve using multiple audience segments (with one negated) and one demographic type. This example will show you how to use the `dimensionType` of `group`.","value":{"endDate":"2023-02-28","startDate":"2023-02-01","targeting":[{"dimensionName":"geography","dimensionType":"SINGLE","dimensionValue":"US"},{"dimensionName":"frequencyThreshold","dimensionType":"SINGLE","dimensionValue":"2"},{"dimensionName":"supplyPackage","dimensionType":"SINGLE","dimensionValue":"STV"},{"dimensionName":"reachType","dimensionType":"SINGLE","dimensionValue":"INDIVIDUALS"},{"dimensionName":"demographic","dimensionType":"SINGLE","dimensionValue":"M18_35"},{"dimensionGroups":[{"dimensionName":"audienceId","dimensionType":"SINGLE","dimensionValue":"123123123","isNot":"true"},{"dimensionName":"audienceId","dimensionType":"MULTIPLE","dimensionValues":["321321321","789789789","987987987"],"interOperator":"OR"}],"dimensionName":"audienceId","dimensionType":"GROUP","intraOperator":"OR"}]}}},"schema":{"$ref":"#/components/schemas/CreateHistoricalReachCurveRequestContent"}}},"required":true},"responses":{"200":{"content":{"application/json":{"examples":{"CreateHistoricalReachCurve_example1":{"description":".","summary":"Example of generating US historical reach curve using one audience ID and a demographic type.","value":{"message":"The report is being generated.","reportId":"c571b6ec-ab2d-41eb-a38c-34b053ee1a1e","status":"PROCESSING"}},"CreateHistoricalReachCurve_example2":{"description":".","summary":"Example of generating US historical reach curve using multiple audience IDs and one demographic type.","value":{"message":"The curve is being generated.","reportId":"c571b6ec-ab2d-41eb-a38c-34b053ee1a1e","status":"PROCESSING"}},"CreateHistoricalReachCurve_example3":{"description":"This example shows you how to use the `dimensionType` of `group`. Notice how, when a single audience ID is to be negated, a dimension type of group is used so you can add\n        multiple dimensions within it. The dimension with type of `group` sets the `intraOperator` to `OR`, which implies that all the dimension groups within the `dimensionGroups` list will be OR\u0027d against each other.\n        The first dimension group is of type `single` so that you can set just that audience ID to be negated. The next group sets the `interOperator` to `OR` so that each audience ID within the list of `dimensionValues` is OR\u0027d against each other.\n.","summary":"Example of generating US historical reach curve using multiple audience segments (with one negated) and one demographic type. This example will show you how to use the `dimensionType` of `group`.","value":{"message":"The curve is being generated.","reportId":"c571b6ec-ab2d-41eb-a38c-34b053ee1a1e","status":"PROCESSING"}}},"schema":{"$ref":"#/components/schemas/CreateHistoricalReachCurveResponseContent"}}},"description":"CreateHistoricalReachCurve 200 response."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SchemaValidationExceptionResponseContent"}}},"description":"SchemaValidationException 400 response."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedExceptionResponseContent"}}},"description":"UnauthorizedException 401 response."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccessDeniedExceptionResponseContent"}}},"description":"AccessDeniedException 403 response."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceNotFoundExceptionResponseContent"}}},"description":"ResourceNotFoundException 404 response."},"415":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnsupportedMediaTypeExceptionResponseContent"}}},"description":"UnsupportedMediaTypeException 415 response."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThrottlingExceptionResponseContent"}}},"description":"ThrottlingException 429 response.","headers":{"Retry-After":{"description":"Delay in seconds, before the next re-try attempt to the operation is recommended.","schema":{"description":"Delay in seconds, before the next re-try attempt to the operation is recommended.","type":"integer"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerExceptionResponseContent"}}},"description":"InternalServerException 500 response."}},"tags":["HistoricalReachCurves"]}},"/mediaPlan/v2/historicalReachCurves/{reportId}":{"get":{"description":"Download the Historical Reach Curve.\n\n**Authorized resource type**:\nDSP Rodeo Entity ID, DSP Advertiser Account ID\n\n**Parameter name**:\nAmazon-Ads-AccountId\n\n**Parameter in**:\nheader\n\n**Requires one of these permissions**:\n[\"campaign_view\"]\n\n**Authorized resource type**:\nGlobal Ad Account ID, Profile ID\n\n**Parameter name**:\nAmazon-Ads-AccountId\n\n**Parameter in**:\nheader\n\n**Requires one of these permissions**:\n[\"campaign_view\"]","operationId":"GetHistoricalReachCurve","parameters":[{"description":"The report ID that you received from the original call to generate a curve.","examples":{"GetHistoricalReachCurve_example1":{"description":".","summary":"Example of a historical reach curve with 1 data point with frequency threshold of 3.","value":"c571b6ec-ab2d-41eb-a38c-34b053ee1a1e"},"GetHistoricalReachCurve_example2":{"description":".","summary":"Example of requesting the second page of a paginated reach curve.","value":"c571b6ec-ab2d-41eb-a38c-34b053ee1a1e"},"GetHistoricalReachCurve_example3":{"description":".","summary":"Example of requesting a reach curve and receiving a `nextToken` value to retrieve the next set of data points.","value":"c571b6ec-ab2d-41eb-a38c-34b053ee1a1e"}},"in":"path","name":"reportId","required":true,"schema":{"description":"The report ID that you received from the original call to generate a curve.","type":"string"}},{"description":"The maximum number of data points to return per request. The default is 1000 data points.","examples":{"GetHistoricalReachCurve_example2":{"description":".","summary":"Example of requesting the second page of a paginated reach curve.","value":"1"},"GetHistoricalReachCurve_example3":{"description":".","summary":"Example of requesting a reach curve and receiving a `nextToken` value to retrieve the next set of data points.","value":"1"}},"in":"query","name":"maxResults","schema":{"description":"The maximum number of data points to return per request. The default is 1000 data points.","maximum":1000,"minimum":1,"type":"integer"}},{"description":"The token to retrieve the next set of data points, if all have not yet been returned.","examples":{"GetHistoricalReachCurve_example2":{"description":".","summary":"Example of requesting the second page of a paginated reach curve.","value":"sample-next-token"}},"in":"query","name":"nextToken","schema":{"description":"The token to retrieve the next set of data points, if all have not yet been returned.","type":"string"}},{"description":"Account identifier you use to access the DSP. This is your Amazon DSP Advertiser ID.","examples":{"GetHistoricalReachCurve_example1":{"description":".","summary":"Example of a historical reach curve with 1 data point with frequency threshold of 3.","value":"2095123454329876"},"GetHistoricalReachCurve_example2":{"description":".","summary":"Example of requesting the second page of a paginated reach curve.","value":"2095123454329876"},"GetHistoricalReachCurve_example3":{"description":".","summary":"Example of requesting a reach curve and receiving a `nextToken` value to retrieve the next set of data points.","value":"2095123454329876"}},"in":"header","name":"Amazon-Ads-AccountId","schema":{"description":"Account identifier you use to access the DSP. This is your Amazon DSP Advertiser ID.","type":"string"}},{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","examples":{"GetHistoricalReachCurve_example1":{"description":".","summary":"Example of a historical reach curve with 1 data point with frequency threshold of 3.","value":"amzn1.application-oa2-client.fakeClient1234567890"},"GetHistoricalReachCurve_example2":{"description":".","summary":"Example of requesting the second page of a paginated reach curve.","value":"amzn1.application-oa2-client.fakeClient1234567890"},"GetHistoricalReachCurve_example3":{"description":".","summary":"Example of requesting a reach curve and receiving a `nextToken` value to retrieve the next set of data points.","value":"amzn1.application-oa2-client.fakeClient1234567890"}},"in":"header","name":"Amazon-Advertising-API-ClientId","required":true,"schema":{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","type":"string"}},{"description":"The identifier of a profile associated with the advertiser account. Use `GET` method on Profiles\nresource to list profiles associated with the access token passed in the HTTP Authorization\nheader and choose profile id `profileId` from the response to pass it as input.","examples":{"GetHistoricalReachCurve_example1":{"description":".","summary":"Example of a historical reach curve with 1 data point with frequency threshold of 3.","value":"123123123123123"},"GetHistoricalReachCurve_example2":{"description":".","summary":"Example of requesting the second page of a paginated reach curve.","value":"123123123123123"},"GetHistoricalReachCurve_example3":{"description":".","summary":"Example of requesting a reach curve and receiving a `nextToken` value to retrieve the next set of data points.","value":"123123123123123"}},"in":"header","name":"Amazon-Advertising-API-Scope","schema":{"description":"The identifier of a profile associated with the advertiser account. Use `GET` method on Profiles\nresource to list profiles associated with the access token passed in the HTTP Authorization\nheader and choose profile id `profileId` from the response to pass it as input.","type":"string"}}],"responses":{"200":{"content":{"application/json":{"examples":{"GetHistoricalReachCurve_example1":{"description":".","summary":"Example of a historical reach curve with 1 data point with frequency threshold of 3.","value":{"dataPoints":[{"demographic":"M18_34","endDate":"2023-05-31","frequencyThresholdReach":[{"frequencyThreshold":"1","reach":"11111"},{"frequencyThreshold":"2","reach":"1112"},{"frequencyThreshold":"3","reach":"113"}],"geography":"US","impressions":"123123","reachType":"HOUSEHOLDS","startDate":"2023-05-01","supplyPackage":"STV"}],"nextToken":"","totalResults":1}},"GetHistoricalReachCurve_example2":{"description":".","summary":"Example of requesting the second page of a paginated reach curve.","value":{"dataPoints":[{"demographic":"M18_34","endDate":"2023-05-31","frequencyThresholdReach":[{"frequencyThreshold":"1","reach":"11111"},{"frequencyThreshold":"2","reach":"1112"},{"frequencyThreshold":"3","reach":"113"}],"geography":"US","impressions":"123123","reachType":"HOUSEHOLDS","startDate":"2023-05-01","supplyPackage":"STV"}],"nextToken":"","totalResults":2}},"GetHistoricalReachCurve_example3":{"description":".","summary":"Example of requesting a reach curve and receiving a `nextToken` value to retrieve the next set of data points.","value":{"dataPoints":[{"demographic":"M18_34","endDate":"2023-05-31","frequencyThresholdReach":[{"frequencyThreshold":"1","reach":"11111"},{"frequencyThreshold":"2","reach":"1112"},{"frequencyThreshold":"3","reach":"113"}],"geography":"US","impressions":"123123","reachType":"HOUSEHOLDS","startDate":"2023-05-01","supplyPackage":"STV"}],"nextToken":"sample-next-token","totalResults":2}}},"schema":{"$ref":"#/components/schemas/GetHistoricalReachCurveResponseContent"}}},"description":"GetHistoricalReachCurve 200 response."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SchemaValidationExceptionResponseContent"}}},"description":"SchemaValidationException 400 response."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedExceptionResponseContent"}}},"description":"UnauthorizedException 401 response."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccessDeniedExceptionResponseContent"}}},"description":"AccessDeniedException 403 response."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceNotFoundExceptionResponseContent"}}},"description":"ResourceNotFoundException 404 response."},"415":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnsupportedMediaTypeExceptionResponseContent"}}},"description":"UnsupportedMediaTypeException 415 response."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThrottlingExceptionResponseContent"}}},"description":"ThrottlingException 429 response.","headers":{"Retry-After":{"description":"Delay in seconds, before the next re-try attempt to the operation is recommended.","schema":{"description":"Delay in seconds, before the next re-try attempt to the operation is recommended.","type":"integer"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerExceptionResponseContent"}}},"description":"InternalServerException 500 response."}},"tags":["HistoricalReachCurves"]}},"/mediaPlan/v2/historicalReachCurves/{reportId}/status":{"get":{"description":"Get the status of the Historical Reach Curve.\n\n**Authorized resource type**:\nDSP Rodeo Entity ID, DSP Advertiser Account ID\n\n**Parameter name**:\nAmazon-Ads-AccountId\n\n**Parameter in**:\nheader\n\n**Requires one of these permissions**:\n[\"campaign_view\"]\n\n**Authorized resource type**:\nGlobal Ad Account ID, Profile ID\n\n**Parameter name**:\nAmazon-Ads-AccountId\n\n**Parameter in**:\nheader\n\n**Requires one of these permissions**:\n[\"campaign_view\"]","operationId":"GetHistoricalReachCurveStatus","parameters":[{"description":"The report ID that you received from the original call to generate a curve.","examples":{"GetHistoricalReachCurveStatus_example1":{"description":".","summary":"Example of getting the status of the generation of a reach curve.","value":"c571b6ec-ab2d-41eb-a38c-34b053ee1a1e"}},"in":"path","name":"reportId","required":true,"schema":{"description":"The report ID that you received from the original call to generate a curve.","type":"string"}},{"description":"Account identifier you use to access the DSP. This is your Amazon DSP Advertiser ID.","examples":{"GetHistoricalReachCurveStatus_example1":{"description":".","summary":"Example of getting the status of the generation of a reach curve.","value":"2095123454329876"}},"in":"header","name":"Amazon-Ads-AccountId","schema":{"description":"Account identifier you use to access the DSP. This is your Amazon DSP Advertiser ID.","type":"string"}},{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","examples":{"GetHistoricalReachCurveStatus_example1":{"description":".","summary":"Example of getting the status of the generation of a reach curve.","value":"amzn1.application-oa2-client.fakeClient1234567890"}},"in":"header","name":"Amazon-Advertising-API-ClientId","required":true,"schema":{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","type":"string"}},{"description":"The identifier of a profile associated with the advertiser account. Use `GET` method on Profiles\nresource to list profiles associated with the access token passed in the HTTP Authorization\nheader and choose profile id `profileId` from the response to pass it as input.","examples":{"GetHistoricalReachCurveStatus_example1":{"description":".","summary":"Example of getting the status of the generation of a reach curve.","value":"123123123123123"}},"in":"header","name":"Amazon-Advertising-API-Scope","schema":{"description":"The identifier of a profile associated with the advertiser account. Use `GET` method on Profiles\nresource to list profiles associated with the access token passed in the HTTP Authorization\nheader and choose profile id `profileId` from the response to pass it as input.","type":"string"}}],"responses":{"200":{"content":{"application/json":{"examples":{"GetHistoricalReachCurveStatus_example1":{"description":".","summary":"Example of getting the status of the generation of a reach curve.","value":{"message":"The curve has been generated.","reportId":"c571b6ec-ab2d-41eb-a38c-34b053ee1a1e","status":"COMPLETED"}}},"schema":{"$ref":"#/components/schemas/GetHistoricalReachCurveStatusResponseContent"}}},"description":"GetHistoricalReachCurveStatus 200 response."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SchemaValidationExceptionResponseContent"}}},"description":"SchemaValidationException 400 response."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedExceptionResponseContent"}}},"description":"UnauthorizedException 401 response."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccessDeniedExceptionResponseContent"}}},"description":"AccessDeniedException 403 response."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceNotFoundExceptionResponseContent"}}},"description":"ResourceNotFoundException 404 response."},"415":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnsupportedMediaTypeExceptionResponseContent"}}},"description":"UnsupportedMediaTypeException 415 response."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThrottlingExceptionResponseContent"}}},"description":"ThrottlingException 429 response.","headers":{"Retry-After":{"description":"Delay in seconds, before the next re-try attempt to the operation is recommended.","schema":{"description":"Delay in seconds, before the next re-try attempt to the operation is recommended.","type":"integer"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerExceptionResponseContent"}}},"description":"InternalServerException 500 response."}},"tags":["HistoricalReachCurves"]}}}}