Skip to main content
GET
/
v1
/
team
/
cost
Get cost details for the team.
curl --request GET \
  --url https://api.friendli.ai/v1/team/cost \
  --header 'Authorization: Bearer <token>'
{
  "has_more": true,
  "data": [
    {
      "start_time": "2023-11-07T05:31:56Z",
      "end_time": "2023-11-07T05:31:56Z",
      "results": [
        {
          "total": 123,
          "quantity": 0.934167,
          "unit_price": 290,
          "line_item": "h100, gpu_time"
        }
      ]
    }
  ],
  "next_page": null
}
Get cost details for the team. If X-Friendli-Team is omitted, this endpoint uses the default team configured in Friendli Suite. There may be a slight delay between usage and when it shows up in cost. If you need to call this endpoint repeatedly, wait at least 5 minutes between calls. To request successfully, it is mandatory to enter a Personal API Key (e.g. flp_XXX) value in the Bearer Token field. Refer to the authentication section on our introduction page to learn how to acquire this variable and visit here to generate your API Key.

Authorizations

​
Authorization
string
header
required

When using Friendli Suite API for inference requests, you need to provide a Personal API Key for authentication and authorization purposes.

For more detailed information, please refer here.

Headers

​
X-Friendli-Team
string | null

ID of team to run requests as (optional parameter).

Query Parameters

​
start_time
string<date-time>
required

RFC 3339 timestamp in UTC. The time portion must be zeroed out (e.g., 2026-01-01T00:00:00Z). Must be no earlier than one year ago.

​
bucket_width
enum<string> | null
default:1d

Width of each time bucket in response. Currently only 1d is supported, default to 1d.

Available options:
1d
​
end_time
string<date-time>
required

RFC 3339 timestamp in UTC. The time portion must be zeroed out (e.g., 2026-01-02T00:00:00Z).

​
limit
integer | null
default:7

A limit on the number of buckets to be returned. Limit can range between 1 and 35, and the default is 7.

Required range: 1 <= x <= 35
​
page
string | null

A cursor for use in pagination. Corresponding to the next_page field from the previous response.

​
group_by
enum<string> | null

Group the costs by the specified fields. Currently only line_item is supported.

Available options:
line_item

Response

Team cost response

​
has_more
boolean
required
Example:

false

​
data
CostBucket · object[]
required
​
next_page
string | null
Example:

null

Last modified on June 24, 2026