This is an optional step that aims at simplifying your usage of the API.
Retrieving your monthly consumption via the Scaleway API
Follow the procedure below to download your monthly consumption using the Scaleway Billing API and curl
.
Before you start
To complete the actions presented below, you must have:
- A Scaleway account and logged into the console
- Created an API key with sufficient IAM permissions to perform the actions described on this page
- Installed
curl
- Configured your environment variables.
Exporting your environment variables
Open a terminal and run the following command to export your API secret key and your Organization ID.
export SCW_SECRET_KEY="<API secret key>"export SCW_ORGANIZATION_ID="<Scaleway Organization ID>"
Consumption of the current month
Run the following command to obtain your consumption over the current month.
curl -X GET \-H "X-Auth-Token: $SCW_SECRET_KEY" \-H "Content-Type: application/json" \"https://api.scaleway.com/billing/v2beta1/consumptions?organization_id=$SCW_ORGANIZATION_ID"
Consumption of a product category
Run the following command to obtain your consumption over the current month for just one category of products.
Specify the target category_name
as one of:
BareMetal
Compute
Containers
Labs
Managed Databases
Managed Services
Network
Object Storage
Observability
Security and Identity
Serverless
Storage
Subscription
curl -X GET \-H "X-Auth-Token: $SCW_SECRET_KEY" \-H "Content-Type: application/json" \"https://api.scaleway.com/billing/v2beta1/consumptions?organization_id=$SCW_ORGANIZATION_ID&category_name=Compute"
Consumption of a specific month
Run the following command to obtain your consumption for a specific month.
Specify the target billing period as YYYY-MM
, e.g. 2023-11
.
curl -X GET \-H "X-Auth-Token: $SCW_SECRET_KEY" \-H "Content-Type: application/json" \"https://api.scaleway.com/billing/v2beta1/consumptions?organization_id=$SCW_ORGANIZATION_ID&billing_period=2023-11"
Consumption of a specific Project
Run the following command to obtain your consumption for a specific Project only.
First, choose your target project_id
:
export SCW_PROJECT_ID="<Scaleway Project ID>"
Then inject it in your API request:
curl -X GET \-H "X-Auth-Token: $SCW_SECRET_KEY" \-H "Content-Type: application/json" \"https://api.scaleway.com/billing/v2beta1/consumptions?project_id=SCW_PROJECT_ID"