Finances — Docs - Rocketeers app

  [ Rocketeers ](/)   

[Login](https://rocketeersapp.com/login) 

  Documentation menu   

On this page

 [Docs](https://rocketeersapp.com/docs) / [Using the API](https://rocketeersapp.com/docs/api)

    Copy as Markdown 

Finances
========

A finance overview for a team, line items, per currency totals, and a grand total.

1. [Endpoint](#content-endpoint)
2. [Query parameters](#content-query-parameters)
3. [Example request](#content-example-request)
4. [Example response](#content-example-response)

Returns a finance overview for a team: a list of cost line items, per currency totals, and a single grand total. This endpoint is **not paginated**.

[\#](#content-endpoint "Permalink")Endpoint
-------------------------------------------

 ```
GET /api/{team}/finances

```

Required ability: `finances:read`

[\#](#content-query-parameters "Permalink")Query parameters
-----------------------------------------------------------

This endpoint takes no query parameters.

[\#](#content-example-request "Permalink")Example request
---------------------------------------------------------

 ```
curl "https://rocketeersapp.com/api/your-team/finances" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"

```

[\#](#content-example-response "Permalink")Example response
-----------------------------------------------------------

The exact line item structure is computed server side from your team's resources, so treat the items below as illustrative rather than a fixed schema.

 ```
{
  "data": [
    { "label": "Servers", "amount": 240.00, "currency": "EUR" },
    { "label": "Storages", "amount": 35.50, "currency": "EUR" },
    { "label": "Databases", "amount": 80.00, "currency": "EUR" }
  ],
  "totals": {
    "EUR": 355.50
  },
  "grand_total": 355.50,
  "results": 3,
  "meta": [],
  "served_in": "8.10ms"
}

```

See [Response format](/docs/api/response-format#the-finances-envelope) for how this envelope differs from the paginated list endpoints.

[ Previous  Projects](https://rocketeersapp.com/docs/api/projects) [ Next   Servers](https://rocketeersapp.com/docs/api/servers)