v1

latestSwagger 2.02026-08-04232286653.5 KB
Usage

Get project-level usage for products in Crusoe Cloud.

get/organizations/{org_id}/usage

Path parameters

org_idstring required

org_id is the ID of the org to fetch usage for

Query parameters

projectsstring[]

projects is an optional list of project IDs to filter usage by; absent means all projects

resource_typesstring[]

resource_types is an optional list of product types to filter usage by; absent means all products

regionsstring[]

regions is an optional list of regions to filter usage by; absent means all regions

start_datestring

start_date is the optional start date (inclusive) of the usage period, formatted YYYY-MM-DD

end_datestring

end_date is the optional end date of the usage period, formatted YYYY-MM-DD

intervalstring

interval controls how usage is aggregated over the period: "daily" (the default) or "monthly"

Response

Usage retrieved successfully

Example response

{
  "items": [
    {
      "billable_metric": "gpu-hours",
      "date": "2022-07-01",
      "project_id": "d8f58dfd-dd86-4ee4-8f01-643e6d0f15bb",
      "quantity": 2.123,
      "region": "us-northcentral1",
      "reservation_id": "d8f58dfd-dd86-4ee4-8f01-643e6d0f15bb",
      "resource_type": "a40.1x"
    }
  ]
}