Cost

Provider detail

One provider’s page for a period: its catalogue entry, the tenant’s connections with their last sync, the sections that apply to it, usage per canonical unit with cost per unit, and value signals. sections is derived from the data itself: seats for seat or user-month usage, tokens for token usage, ci_minutes for CI job minutes, commitments when commitment discounts appear, recommendations when the provider has active recommendations. seats.active is null when the provider reports no seat activity. Amounts are in their billing currency, one entry per currency. Returns 404 when the provider is neither in the catalogue nor connected nor billed in the period.

GET

api

tenant

cost

providers

{provider}

Provider detail

curl --request GET \
  --url https://api.costgraph.ai/api/v1/tenant/cost/providers/{provider} \
  --header 'Authorization: <api-key>' \
  --header 'X-CostGraph-Tenant-ID: <x-costgraph-tenant-id>'

import requests

url = "https://api.costgraph.ai/api/v1/tenant/cost/providers/{provider}"

headers = {
    "X-CostGraph-Tenant-ID": "<x-costgraph-tenant-id>",
    "Authorization": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'X-CostGraph-Tenant-ID': '<x-costgraph-tenant-id>', Authorization: '<api-key>'}
};

fetch('https://api.costgraph.ai/api/v1/tenant/cost/providers/{provider}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.costgraph.ai/api/v1/tenant/cost/providers/{provider}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "X-CostGraph-Tenant-ID: <x-costgraph-tenant-id>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.costgraph.ai/api/v1/tenant/cost/providers/{provider}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-CostGraph-Tenant-ID", "<x-costgraph-tenant-id>")
	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.costgraph.ai/api/v1/tenant/cost/providers/{provider}")
  .header("X-CostGraph-Tenant-ID", "<x-costgraph-tenant-id>")
  .header("Authorization", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.costgraph.ai/api/v1/tenant/cost/providers/{provider}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-CostGraph-Tenant-ID"] = '<x-costgraph-tenant-id>'
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "message": "some message",
  "status": "success",
  "data": {
    "ciMinutes": 123,
    "connections": [
      {
        "connectionId": "<string>",
        "displayName": "<string>",
        "id": "<string>",
        "lastSyncError": "<string>",
        "lastSyncedAt": "<string>",
        "providerAccountId": "<string>",
        "status": "<string>"
      }
    ],
    "days": [
      "<string>"
    ],
    "metadata": {
      "category": "<string>",
      "docsUrl": "<string>",
      "grain": "<string>",
      "name": "<string>",
      "slug": "<string>"
    },
    "provider": "<string>",
    "seats": {
      "active": 123,
      "assigned": 123
    },
    "sections": [
      "<string>"
    ],
    "tokensByModel": [
      {
        "cost": 123,
        "currency": "<string>",
        "model": "<string>",
        "tokens": 123
      }
    ],
    "usage": [
      {
        "cost": 123,
        "costPerUnit": 123,
        "currency": "<string>",
        "quantity": 123,
        "unit": "<string>"
      }
    ]
  }
}

{
  "message": "some message",
  "status": "error"
}

{
  "message": "some message",
  "status": "error"
}

{
  "message": "some message",
  "status": "error"
}

Authorizations

Authorization

string

header

required

Enter "Bearer {token}"

Headers

X-CostGraph-Tenant-ID

string

required

Tenant ID

Path Parameters

provider

string

required

Provider slug, as cost rows carry it (e.g. aws, github, openrouter)

Query Parameters

period

enum<string>

Cost period; defaults to month_to_date

Available options:

month_to_date,

last_7d,

last_30d,

calendar_month,

custom

month

string

Closed calendar month in YYYY-MM format; required when period=calendar_month

start

string

Window start in RFC3339 format; required when period=custom

end

string

Window end in RFC3339 format; required when period=custom

Response

message

string

required

Example:

"some message"

status

string

required

Example:

"success"

data

object

Show child attributes

Provider detail

curl --request GET \
  --url https://api.costgraph.ai/api/v1/tenant/cost/providers/{provider} \
  --header 'Authorization: <api-key>' \
  --header 'X-CostGraph-Tenant-ID: <x-costgraph-tenant-id>'

import requests

url = "https://api.costgraph.ai/api/v1/tenant/cost/providers/{provider}"

headers = {
    "X-CostGraph-Tenant-ID": "<x-costgraph-tenant-id>",
    "Authorization": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'X-CostGraph-Tenant-ID': '<x-costgraph-tenant-id>', Authorization: '<api-key>'}
};

fetch('https://api.costgraph.ai/api/v1/tenant/cost/providers/{provider}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.costgraph.ai/api/v1/tenant/cost/providers/{provider}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "X-CostGraph-Tenant-ID: <x-costgraph-tenant-id>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.costgraph.ai/api/v1/tenant/cost/providers/{provider}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-CostGraph-Tenant-ID", "<x-costgraph-tenant-id>")
	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.costgraph.ai/api/v1/tenant/cost/providers/{provider}")
  .header("X-CostGraph-Tenant-ID", "<x-costgraph-tenant-id>")
  .header("Authorization", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.costgraph.ai/api/v1/tenant/cost/providers/{provider}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-CostGraph-Tenant-ID"] = '<x-costgraph-tenant-id>'
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "message": "some message",
  "status": "success",
  "data": {
    "ciMinutes": 123,
    "connections": [
      {
        "connectionId": "<string>",
        "displayName": "<string>",
        "id": "<string>",
        "lastSyncError": "<string>",
        "lastSyncedAt": "<string>",
        "providerAccountId": "<string>",
        "status": "<string>"
      }
    ],
    "days": [
      "<string>"
    ],
    "metadata": {
      "category": "<string>",
      "docsUrl": "<string>",
      "grain": "<string>",
      "name": "<string>",
      "slug": "<string>"
    },
    "provider": "<string>",
    "seats": {
      "active": 123,
      "assigned": 123
    },
    "sections": [
      "<string>"
    ],
    "tokensByModel": [
      {
        "cost": 123,
        "currency": "<string>",
        "model": "<string>",
        "tokens": 123
      }
    ],
    "usage": [
      {
        "cost": 123,
        "costPerUnit": 123,
        "currency": "<string>",
        "quantity": 123,
        "unit": "<string>"
      }
    ]
  }
}

{
  "message": "some message",
  "status": "error"
}

{
  "message": "some message",
  "status": "error"
}

{
  "message": "some message",
  "status": "error"
}

Getting started

Endpoints

Provider detail

Authorizations

Headers

Path Parameters

Query Parameters

Response