Amazon Web Services, Inc.

AWS Cost Explorer Service

You can use the Cost Explorer API to programmatically query your cost and usage data. You can query for aggregated data such as total monthly costs or total…

Finance & banking#openapi#cloud

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

You can use the Cost Explorer API to programmatically query your cost and usage data.
You can query for aggregated data such as total monthly costs or total daily usage. You can
also query for granular data. This might include the number of daily write operations for
Amazon DynamoDB database tables in your production environment.
Service Endpoint
The Cost Explorer API provides the following endpoint:

https://ce.us-east-1.amazonaws.com

For information about the costs that are associated with the Cost Explorer API, see
Amazon Web Services Cost
Management Pricing .

Endpoints 47

  • POSTCreate anomaly monitor/#X-Amz-Target=AWSInsightsIndexService.CreateAnomalyMonitorCreates a new cost anomaly detection monitor with the requested type and monitor specification.
  • POSTCreate anomaly subscription/#X-Amz-Target=AWSInsightsIndexService.CreateAnomalySubscriptionAdds an alert subscription to a cost anomaly detection monitor. You can use each subscription to define subscribers with email or SNS notifications. Email…
  • POSTCreate cost category definition/#X-Amz-Target=AWSInsightsIndexService.CreateCostCategoryDefinitionCreates a new cost category with the requested name and rules.
  • POSTDelete anomaly monitor/#X-Amz-Target=AWSInsightsIndexService.DeleteAnomalyMonitorDeletes a cost anomaly monitor.
  • POSTDelete anomaly subscription/#X-Amz-Target=AWSInsightsIndexService.DeleteAnomalySubscriptionDeletes a cost anomaly subscription.
  • POSTDelete cost category definition/#X-Amz-Target=AWSInsightsIndexService.DeleteCostCategoryDefinitionDeletes a cost category. Expenses from this month going forward will no longer be categorized with this cost category.
  • POSTDescribe cost category definition/#X-Amz-Target=AWSInsightsIndexService.DescribeCostCategoryDefinitionReturns the name, Amazon Resource Name (ARN), rules, definition, and effective dates of a cost category that's defined in the account. You have the option to…
  • POSTGet anomalies/#X-Amz-Target=AWSInsightsIndexService.GetAnomaliesRetrieves all of the cost anomalies detected on your account during the time period that's specified by the DateInterval object. Anomalies are available for…
  • POSTGet anomaly monitors/#X-Amz-Target=AWSInsightsIndexService.GetAnomalyMonitorsRetrieves the cost anomaly monitor definitions for your account. You can filter using a list of cost anomaly monitor Amazon Resource Names (ARNs).
  • POSTGet anomaly subscriptions/#X-Amz-Target=AWSInsightsIndexService.GetAnomalySubscriptionsRetrieves the cost anomaly subscription objects for your account. You can filter using a list of cost anomaly monitor Amazon Resource Names (ARNs).
  • POSTGet approximate usage records/#X-Amz-Target=AWSInsightsIndexService.GetApproximateUsageRecordsRetrieves estimated usage records for hourly granularity or resource-level data at daily granularity.
  • POSTGet commitment purchase analysis/#X-Amz-Target=AWSInsightsIndexService.GetCommitmentPurchaseAnalysisRetrieves a commitment purchase analysis result based on the AnalysisId .
  • POSTGet cost and usage/#X-Amz-Target=AWSInsightsIndexService.GetCostAndUsageRetrieves cost and usage metrics for your account. You can specify which cost and usage-related metric that you want the request to return. For example, you…
  • POSTGet cost and usage comparisons/#X-Amz-Target=AWSInsightsIndexService.GetCostAndUsageComparisonsRetrieves cost and usage comparisons for your account between two periods within the last 13 months. If you have enabled multi-year data at monthly…
  • POSTGet cost and usage with resources/#X-Amz-Target=AWSInsightsIndexService.GetCostAndUsageWithResourcesRetrieves cost and usage metrics with resources for your account. You can specify which cost and usage-related metric, such as BlendedCosts or UsageQuantity ,…
  • POSTGet cost categories/#X-Amz-Target=AWSInsightsIndexService.GetCostCategoriesRetrieves an array of cost category names and values incurred cost. If some cost category names and values are not associated with any cost, they will not be…
  • POSTGet cost comparison drivers/#X-Amz-Target=AWSInsightsIndexService.GetCostComparisonDriversRetrieves key factors driving cost changes between two time periods within the last 13 months, such as usage changes, discount changes, and commitment-based…
  • POSTGet cost forecast/#X-Amz-Target=AWSInsightsIndexService.GetCostForecastRetrieves a forecast for how much Amazon Web Services predicts that you will spend over the forecast time period that you select, based on your past costs.
  • POSTGet dimension values/#X-Amz-Target=AWSInsightsIndexService.GetDimensionValuesRetrieves all available filter values for a specified filter over a period of time. You can search the dimension values for an arbitrary string.
  • POSTGet reservation coverage/#X-Amz-Target=AWSInsightsIndexService.GetReservationCoverageRetrieves the reservation coverage for your account, which you can use to see how much of your Amazon Elastic Compute Cloud, Amazon ElastiCache, Amazon…
  • POSTGet reservation purchase recommendation/#X-Amz-Target=AWSInsightsIndexService.GetReservationPurchaseRecommendationGets recommendations for reservation purchases. These recommendations might help you to reduce your costs. Reservations provide a discounted hourly rate (up…
  • POSTGet reservation utilization/#X-Amz-Target=AWSInsightsIndexService.GetReservationUtilizationRetrieves the reservation utilization for your account. Management account in an organization have access to member accounts. You can filter data by…
  • POSTGet rightsizing recommendation/#X-Amz-Target=AWSInsightsIndexService.GetRightsizingRecommendationCreates recommendations that help you save cost by identifying idle and underutilized Amazon EC2 instances. Recommendations are generated to either downsize…
  • POSTGet savings plan purchase recommendation details/#X-Amz-Target=AWSInsightsIndexService.GetSavingsPlanPurchaseRecommendationDetailsRetrieves the details for a Savings Plan recommendation. These details include the hourly data-points that construct the cost, coverage, and utilization charts.
  • POSTGet savings plans coverage/#X-Amz-Target=AWSInsightsIndexService.GetSavingsPlansCoverageRetrieves the Savings Plans covered for your account. This enables you to see how much of your cost is covered by a Savings Plan. An organization’s management…
  • POSTGet savings plans purchase recommendation/#X-Amz-Target=AWSInsightsIndexService.GetSavingsPlansPurchaseRecommendationRetrieves the Savings Plans recommendations for your account. First use StartSavingsPlansPurchaseRecommendationGeneration to generate a new set of…
  • POSTGet savings plans utilization/#X-Amz-Target=AWSInsightsIndexService.GetSavingsPlansUtilizationRetrieves the Savings Plans utilization for your account across date ranges with daily or monthly granularity. Management account in an organization have…
  • POSTGet savings plans utilization details/#X-Amz-Target=AWSInsightsIndexService.GetSavingsPlansUtilizationDetailsRetrieves attribute data along with aggregate utilization and savings data for a given time period. This doesn't support granular or grouped data…
  • POSTGet tags/#X-Amz-Target=AWSInsightsIndexService.GetTagsQueries for available tag keys and tag values for a specified period. You can search the tag values for an arbitrary string.
  • POSTGet usage forecast/#X-Amz-Target=AWSInsightsIndexService.GetUsageForecastRetrieves a forecast for how much Amazon Web Services predicts that you will use over the forecast time period that you select, based on your past usage.
  • POSTList commitment purchase analyses/#X-Amz-Target=AWSInsightsIndexService.ListCommitmentPurchaseAnalysesLists the commitment purchase analyses for your account.
  • POSTList cost allocation tag backfill history/#X-Amz-Target=AWSInsightsIndexService.ListCostAllocationTagBackfillHistoryRetrieves a list of your historical cost allocation tag backfill requests.
  • POSTList cost allocation tags/#X-Amz-Target=AWSInsightsIndexService.ListCostAllocationTagsGet a list of cost allocation tags. All inputs in the API are optional and serve as filters. By default, all cost allocation tags are returned.
  • POSTList cost category definitions/#X-Amz-Target=AWSInsightsIndexService.ListCostCategoryDefinitionsReturns the name, Amazon Resource Name (ARN), NumberOfRules and effective dates of all cost categories defined in the account. You have the option to use…
  • POSTList cost category resource associations/#X-Amz-Target=AWSInsightsIndexService.ListCostCategoryResourceAssociationsReturns resource associations of all cost categories defined in the account. You have the option to use CostCategoryArn to get the association for a specific…
  • POSTList savings plans purchase recommendation generation/#X-Amz-Target=AWSInsightsIndexService.ListSavingsPlansPurchaseRecommendationGenerationRetrieves a list of your historical recommendation generations within the past 30 days.
  • POSTList tags for resource/#X-Amz-Target=AWSInsightsIndexService.ListTagsForResourceReturns a list of resource tags associated with the resource specified by the Amazon Resource Name (ARN).
  • POSTProvide anomaly feedback/#X-Amz-Target=AWSInsightsIndexService.ProvideAnomalyFeedbackModifies the feedback property of a given cost anomaly.
  • POSTStart commitment purchase analysis/#X-Amz-Target=AWSInsightsIndexService.StartCommitmentPurchaseAnalysisSpecifies the parameters of a planned commitment purchase and starts the generation of the analysis. This enables you to estimate the cost, coverage, and…
  • POSTStart cost allocation tag backfill/#X-Amz-Target=AWSInsightsIndexService.StartCostAllocationTagBackfillRequest a cost allocation tag backfill. This will backfill the activation status (either active or inactive ) for all tag keys from para:BackfillFrom up to…
  • POSTStart savings plans purchase recommendation generation/#X-Amz-Target=AWSInsightsIndexService.StartSavingsPlansPurchaseRecommendationGenerationRequests a Savings Plans recommendation generation. This enables you to calculate a fresh set of Savings Plans recommendations that takes your latest usage…
  • POSTTag resource/#X-Amz-Target=AWSInsightsIndexService.TagResourceAn API operation for adding one or more tags (key-value pairs) to a resource. You can use the TagResource operation with a resource that already has tags. If…
  • POSTUntag resource/#X-Amz-Target=AWSInsightsIndexService.UntagResourceRemoves one or more tags from a resource. Specify only tag keys in your request. Don't specify the value.
  • POSTUpdate anomaly monitor/#X-Amz-Target=AWSInsightsIndexService.UpdateAnomalyMonitorUpdates an existing cost anomaly monitor. The changes made are applied going forward, and doesn't change anomalies detected in the past.
  • POSTUpdate anomaly subscription/#X-Amz-Target=AWSInsightsIndexService.UpdateAnomalySubscriptionUpdates an existing cost anomaly subscription. Specify the fields that you want to update. Omitted fields are unchanged. The JSON below describes the generic…
  • POSTUpdate cost allocation tags status/#X-Amz-Target=AWSInsightsIndexService.UpdateCostAllocationTagsStatusUpdates status for cost allocation tags in bulk, with maximum batch size of 20. If the tag status that's updated is the same as the existing tag status, the…
  • POSTUpdate cost category definition/#X-Amz-Target=AWSInsightsIndexService.UpdateCostCategoryDefinitionUpdates an existing cost category. Changes made to the cost category rules will be used to categorize the current month’s expenses and future expenses. This…

API details

Base URL
https://ce.{region}.amazonaws.com
Authentication
AWS Signature Version 4 (requests signed with your AWS access key)
Operations
47 operations on 47 pathsPOST 47
Description format
AWS Smithy model, API version 2017-10-25

How to test the AWS Cost Explorer Service in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the AWS Cost Explorer Service collection, without the publisher's secrets.
  3. Add your credentialsThis API uses AWS Signature Version 4 (requests signed with your AWS access key). Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Create anomaly monitor” (POST /#X-Amz-Target=AWSInsightsIndexService.CreateAnomalyMonitor), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the AWS Cost Explorer Service?

You can use the Cost Explorer API to programmatically query your cost and usage data. You can query for aggregated data such as total monthly costs or total… It is listed under Finance & banking and has 47 endpoints.

Who publishes the AWS Cost Explorer Service?

It is listed from Amazon Web Services, Inc.'s public API description (an OpenAPI document), not published by Amazon Web Services, Inc. on Swastik Codes. Anyone who controls amazonaws.com can claim the profile by adding a DNS TXT record.

What is the base URL of the AWS Cost Explorer Service?

Requests go to https://ce.{region}.amazonaws.com. Endpoint paths are added to this base URL.

How do I authenticate with the AWS Cost Explorer Service?

With AWS Signature Version 4 (requests signed with your AWS access key).

How many endpoints does the AWS Cost Explorer Service have?

47 operations on 47 paths (47 POST).

Is forking the AWS Cost Explorer Service free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.