The Billing And Cost Management Anomaly Subscription API from Amazon Billing And Cost Management — 3 operation(s) for billing and cost management anomaly subscription.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/amazon-billing-and-cost-management:amazon-billing-and-cost-management-anomaly-subscription-api"curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: AWS Cost Explorer Service Anomaly Subscription API
version: '2017-10-25'
description: Generated from AWS's published Smithy model for AWS Cost Explorer Service. 3 operation(s).
contact:
name: Amazon Web Services
url: https://aws.amazon.com/contact-us/
license:
name: Apache 2.0
identifier: Apache-2.0
url: https://github.com/aws/api-models-aws/blob/main/LICENSE
servers:
- url: https://ce.{region}.amazonaws.com
variables:
region:
default: us-east-1
security:
- sigv4: []
tags:
- name: Anomaly Subscription
paths:
/#DeleteAnomalySubscription:
post:
operationId: DeleteAnomalySubscription
summary: Delete Anomaly Subscription
description: Deletes a cost anomaly subscription.
responses:
'200':
description: Success
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/DeleteAnomalySubscriptionResponse'
'400':
description: LimitExceededException
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/LimitExceededException'
'404':
description: UnknownSubscriptionException
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/UnknownSubscriptionException'
parameters:
- name: X-Amz-Target
in: header
required: true
schema:
type: string
enum:
- AWSInsightsIndexService.DeleteAnomalySubscription
requestBody:
required: true
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/DeleteAnomalySubscriptionRequest'
tags:
- Anomaly Subscription
/#GetAnomalySubscriptions:
post:
operationId: GetAnomalySubscriptions
summary: Get Anomaly Subscriptions
description: Retrieves the cost anomaly subscription objects for your account. You can filter using a list of cost anomaly monitor Amazon Resource Names (ARNs).
responses:
'200':
description: Success
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/GetAnomalySubscriptionsResponse'
'400':
description: InvalidNextTokenException; LimitExceededException
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/InvalidNextTokenException'
'404':
description: UnknownSubscriptionException
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/UnknownSubscriptionException'
parameters:
- name: X-Amz-Target
in: header
required: true
schema:
type: string
enum:
- AWSInsightsIndexService.GetAnomalySubscriptions
requestBody:
required: true
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/GetAnomalySubscriptionsRequest'
tags:
- Anomaly Subscription
/#UpdateAnomalySubscription:
post:
operationId: UpdateAnomalySubscription
summary: Update Anomaly Subscription
description: Updates an existing cost anomaly subscription. Specify the fields that you want to update. Omitted fields are unchanged. The JSON below describes the generic construct for each type. See Request Parameters for possible values as they apply to AnomalySubscription.
responses:
'200':
description: Success
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/UpdateAnomalySubscriptionResponse'
'400':
description: LimitExceededException
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/LimitExceededException'
'404':
description: UnknownMonitorException; UnknownSubscriptionException
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/UnknownMonitorException'
parameters:
- name: X-Amz-Target
in: header
required: true
schema:
type: string
enum:
- AWSInsightsIndexService.UpdateAnomalySubscription
requestBody:
required: true
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/UpdateAnomalySubscriptionRequest'
tags:
- Anomaly Subscription
components:
schemas:
DimensionValues:
type: object
properties:
Key:
type: string
enum:
- AZ
- INSTANCE_TYPE
- LINKED_ACCOUNT
- PAYER_ACCOUNT
- LINKED_ACCOUNT_NAME
- OPERATION
- PURCHASE_TYPE
- REGION
- SERVICE
- SERVICE_CODE
- USAGE_TYPE
- USAGE_TYPE_GROUP
- RECORD_TYPE
- OPERATING_SYSTEM
- TENANCY
- SCOPE
- PLATFORM
- SUBSCRIPTION_ID
- LEGAL_ENTITY_NAME
- DEPLOYMENT_OPTION
- DATABASE_ENGINE
- CACHE_ENGINE
- INSTANCE_TYPE_FAMILY
- BILLING_ENTITY
- RESERVATION_ID
- RESOURCE_ID
- RIGHTSIZING_TYPE
- SAVINGS_PLANS_TYPE
- SAVINGS_PLAN_ARN
- PAYMENT_OPTION
- AGREEMENT_END_DATE_TIME_AFTER
- AGREEMENT_END_DATE_TIME_BEFORE
- INVOICING_ENTITY
- ANOMALY_TOTAL_IMPACT_ABSOLUTE
- ANOMALY_TOTAL_IMPACT_PERCENTAGE
- PRODUCT_ATTRIBUTE
description: The names of the metadata types that you can use to filter and group your results. For example, AZ returns a list of Availability Zones. Not all dimensions are supported in each API. Refer to the documentation for each specific API to see what is supported. LINKED_ACCOUNT_NAME and SERVICE_CODE can only be used in CostCategoryRule. ANOMALY_TOTAL_IMPACT_ABSOLUTE and ANOMALY_TOTAL_IMPACT_PERCENTAGE can only be used in AnomalySubscriptions. Use PRODUCT_ATTRIBUTE only as the Dimension in GetDimensionValues. To filter or group by product attributes, use the ProductAttributes field of Expression or t
Values:
type: array
items:
type: string
description: The metadata values that you can use to filter and group your results. You can use GetDimensionValues to find specific values.
MatchOptions:
type: array
items:
type: string
enum:
- EQUALS
- ABSENT
- STARTS_WITH
- ENDS_WITH
- CONTAINS
- CASE_SENSITIVE
- CASE_INSENSITIVE
- GREATER_THAN_OR_EQUAL
description: The match options that you can use to filter your results. MatchOptions is only applicable for actions related to cost category and Anomaly Subscriptions. Refer to the documentation for each specific API to see what is supported. The default values for MatchOptions are EQUALS and CASE_SENSITIVE.
DeleteAnomalySubscriptionResponse:
type: object
properties: {}
UpdateAnomalySubscriptionRequest:
type: object
properties:
SubscriptionArn:
type: string
description: A cost anomaly subscription Amazon Resource Name (ARN).
Threshold:
type: number
description: (deprecated) The update to the threshold value for receiving notifications. This field has been deprecated. To update a threshold, use ThresholdExpression. Continued use of Threshold will be treated as shorthand syntax for a ThresholdExpression. You can specify either Threshold or ThresholdExpression, but not both.
Frequency:
type: string
enum:
- DAILY
- IMMEDIATE
- WEEKLY
description: The update to the frequency value that subscribers receive notifications.
MonitorArnList:
type: array
items:
type: string
description: A list of cost anomaly monitor ARNs.
Subscribers:
type: array
items:
$ref: '#/components/schemas/Subscriber'
description: The update to the subscriber list.
SubscriptionName:
type: string
description: The new name of the subscription.
ThresholdExpression:
$ref: '#/components/schemas/Expression'
required:
- SubscriptionArn
GetAnomalySubscriptionsResponse:
type: object
properties:
AnomalySubscriptions:
type: array
items:
$ref: '#/components/schemas/AnomalySubscription'
description: A list of cost anomaly subscriptions that includes the detailed metadata for each one.
NextPageToken:
type: string
description: The token to retrieve the next set of results. Amazon Web Services provides the token when the response from a previous call has more results than the maximum page size.
required:
- AnomalySubscriptions
UnknownSubscriptionException:
type: object
properties:
Message:
type: string
TagValues:
type: object
properties:
Key:
type: string
description: The key for the tag.
Values:
type: array
items:
type: string
description: The specific value of the tag.
MatchOptions:
type: array
items:
type: string
enum:
- EQUALS
- ABSENT
- STARTS_WITH
- ENDS_WITH
- CONTAINS
- CASE_SENSITIVE
- CASE_INSENSITIVE
- GREATER_THAN_OR_EQUAL
description: The match options that you can use to filter your results. MatchOptions is only applicable for actions related to cost category. The default values for MatchOptions are EQUALS and CASE_SENSITIVE.
ProductAttributeValues:
type: object
properties:
Key:
type: string
description: 'The name of the product attribute, such as model. The keys that are available depend on the service. For the keys of each supported service, see ProductAttributeValues . Keys are case-sensitive. A key that doesn''t exist doesn''t return an error: EQUALS matches no costs, and ABSENT matches all costs of supported services.'
Values:
type: array
items:
type: string
description: The specific values of the product attribute, such as Claude Sonnet 5 for the model key. Values are matched exactly, including case. To list the values of a key, use GetDimensionValues with Dimension set to PRODUCT_ATTRIBUTE and DimensionKey set to the key. To match costs that have no value for the key, set MatchOptions to ABSENT and omit Values. Otherwise, Values is required.
MatchOptions:
type: array
items:
type: string
enum:
- EQUALS
- ABSENT
- STARTS_WITH
- ENDS_WITH
- CONTAINS
- CASE_SENSITIVE
- CASE_INSENSITIVE
- GREATER_THAN_OR_EQUAL
description: 'The match options that you can use to filter your results. Valid values: EQUALS - Matches the values that you specify. ABSENT - Matches costs that have no value for the key. Omit Values. CASE_SENSITIVE - Use only with EQUALS. Values are always matched case-sensitively. Default values are EQUALS and CASE_SENSITIVE.'
required:
- Key
UnknownMonitorException:
type: object
properties:
Message:
type: string
Expression:
type: object
properties:
Or:
type: array
items:
$ref: '#/components/schemas/Expression'
description: Return results that match either Dimension object.
And:
type: array
items:
$ref: '#/components/schemas/Expression'
description: Return results that match both Dimension objects.
Not:
$ref: '#/components/schemas/Expression'
Dimensions:
$ref: '#/components/schemas/DimensionValues'
Tags:
$ref: '#/components/schemas/TagValues'
CostCategories:
$ref: '#/components/schemas/CostCategoryValues'
ProductAttributes:
$ref: '#/components/schemas/ProductAttributeValues'
DeleteAnomalySubscriptionRequest:
type: object
properties:
SubscriptionArn:
type: string
description: The unique identifier of the cost anomaly subscription that you want to delete.
required:
- SubscriptionArn
UpdateAnomalySubscriptionResponse:
type: object
properties:
SubscriptionArn:
type: string
description: A cost anomaly subscription ARN.
required:
- SubscriptionArn
Subscriber:
type: object
properties:
Address:
type: string
description: The email address or SNS Amazon Resource Name (ARN). This depends on the Type.
Type:
type: string
enum:
- EMAIL
- SNS
description: The notification delivery channel.
Status:
type: string
enum:
- CONFIRMED
- DECLINED
description: Indicates if the subscriber accepts the notifications.
AnomalySubscription:
type: object
properties:
SubscriptionArn:
type: string
description: The AnomalySubscription Amazon Resource Name (ARN).
AccountId:
type: string
description: Your unique account identifier.
MonitorArnList:
type: array
items:
type: string
description: A list of cost anomaly monitors.
Subscribers:
type: array
items:
$ref: '#/components/schemas/Subscriber'
description: A list of subscribers to notify.
Threshold:
type: number
description: (deprecated) An absolute dollar value that must be exceeded by the anomaly's total impact (see Impact for more details) for an anomaly notification to be generated. This field has been deprecated. To specify a threshold, use ThresholdExpression. Continued use of Threshold will be treated as shorthand syntax for a ThresholdExpression. One of Threshold or ThresholdExpression is required for this resource. You cannot specify both.
Frequency:
type: string
enum:
- DAILY
- IMMEDIATE
- WEEKLY
description: The frequency that anomaly notifications are sent. Notifications are sent either over email (for DAILY and WEEKLY frequencies) or SNS (for IMMEDIATE frequency). For more information, see Creating an Amazon SNS topic for anomaly notifications.
SubscriptionName:
type: string
description: The name for the subscription.
ThresholdExpression:
$ref: '#/components/schemas/Expression'
required:
- MonitorArnList
- Subscribers
- Frequency
- SubscriptionName
CostCategoryValues:
type: object
properties:
Key:
type: string
Values:
type: array
items:
type: string
description: The specific value of the cost category.
MatchOptions:
type: array
items:
type: string
enum:
- EQUALS
- ABSENT
- STARTS_WITH
- ENDS_WITH
- CONTAINS
- CASE_SENSITIVE
- CASE_INSENSITIVE
- GREATER_THAN_OR_EQUAL
description: The match options that you can use to filter your results. MatchOptions is only applicable for actions related to cost category. The default values for MatchOptions is EQUALS and CASE_SENSITIVE.
GetAnomalySubscriptionsRequest:
type: object
properties:
SubscriptionArnList:
type: array
items:
type: string
description: A list of cost anomaly subscription ARNs.
MonitorArn:
type: string
description: Cost anomaly monitor ARNs.
NextPageToken:
type: string
description: The token to retrieve the next set of results. Amazon Web Services provides the token when the response from a previous call has more results than the maximum page size.
MaxResults:
type: integer
description: The number of entries a paginated response contains.
LimitExceededException:
type: object
properties:
Message:
type: string
InvalidNextTokenException:
type: object
properties:
Message:
type: string
securitySchemes:
sigv4:
type: apiKey
in: header
name: Authorization
description: AWS Signature Version 4. The Authorization header carries an AWS4-HMAC-SHA256 signature over the canonical request, with X-Amz-Date (and X-Amz-Security-Token for temporary credentials). Not a bearer token.
x-aws-sigv4:
signingName: ce
x-provenance:
method: harvested
publisher: Amazon Web Services
source: https://raw.githubusercontent.com/aws/api-models-aws/582e55931c45b944739742a2c1620b6026dd2d13/models/cost-explorer/service/2017-10-25/cost-explorer-2017-10-25.json
note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)