Cost API

Finout Cost API enables you to query and analyze costs using user-defined Finout Views. You can easily get a list of your views and retrieve the costs for a specified view. You can query the costs for any date range of up to 90 days specified in UTC timestamps. The results are returned in JSON format for easy processing.

Note: Only cost data is returned when querying a view via the Cost API.

GET/Views

Description

Gets a list of all your account views. For more information on views, see Finout Views.

Prerequisites

• Generate a Client ID and Secret Key from Finout to add in Headers.

• You must create a view in the MegaBill before querying the GET view. There is currently no 'Create View' API option.

Request https://app.finout.io/v1/view

Response

200

{
    "data": [
        {
            "name": "Cost Ratio - Weightings by Group Name",
            "id": "25568bb9-7d9b-4b72-9361-07abcb4e5f29"
        },
        {
            "name": "Shared Services - Support, Marketplace, Security",
            "id": "08252cda-3f70-4779-822c-cf4bdf65cc28"
        },

        {
            "name": "K8s by App_Component",
            "id": "f76be053-1138-431f-a6e1-9f6d1852398b"
        }
    ],
    "requestId": "05ac7c0f-2e85-4af0-8ef7-3ace11e420d7"
}

Returns a JSON object with the following properties:

• name: The names of your account's views.

• id: The unique identifier of your account's views.

POST /Query by view

Description

Return all costs for a specified view and date range for up to 90 days. For more information on views, see Finout Views.

Prerequisites

• Generate a Client ID and Secret Key from Finout to add in Headers.

• You must first GET the view you want to query

• Add the GET view ID to the body of the POST query. Example:

  ​{
  "viewId": "6244e453-e8b8-4f1f-9a96-4ba1ae5d48f7"
  }

• You must either specify dates or delete them completely. The query won't work when blank dates are still present. Example:

  ​​{
       "viewId": "",
       "date": {
           "unixTimeMillSecondsStart": 1719824738,
           "unixTimeMillSecondsEnd": 1719911138
       },
       "costType": "netAmortizedCost"
     }

Request

https://app.finout.io/v1/cost/query-by-view

Request Query Example

{
    "viewId": "{VIEW_ID}",
    "date": {
        "unixTimeMillSecondsStart": 1719824738000,
        "unixTimeMillSecondsEnd": 1719911138000
    },
    "costType": "netAmortizedCost"
}

Body of Request

Parameter	Type	Description
viewId	string	The ID of the view that the user queries
date	object	“unixTimeMillSecondsStart” and “unixTimeMillSecondsEnd” keys
unixTimeMillSecondsStart	Numeric	Start Date represented in Unix Epoch time
unixTimeMillSecondsEnd	Numeric	End Date represented in Unix Epoch time
costType	String	Types of costs: - blendedCost - unblendedCost - netUnblendedCost - amortizedCost - netAmortizedCost See Cost and Usage Types for an explanation of each cost.

Response without X-Axis

Without group by

{
    "data": [
        {
            "name": "Total",
            "dateRange": {
                "from": 1719792000000,
                "to": 1719878400000
            },
            "data": [
                {
                    "time": 1719792000000,
                    "cost": 4146.056203015
                }
            ]
        }
    ],
    "request": {
        "viewId": "58682b6c-6eed-4ed2-b649-3e3a180925b0",
        "date": {
            "unixTimeMillSecondsStart": 1719824738000,
            "unixTimeMillSecondsEnd": 1719911138000
        },
        "costType": "netAmortizedCost"
    },
    "requestId": "6ed650ca-9ea5-42f5-97eb-4b1f61cd6ac3"
}

With group by

With multiple group bys

Response with X-Axis

X-Axis without group by

{
    "data": [
        {
            "name": "Total",
            "data": [
                {
                    "cost": 816.3798754186101,
                    "xAxis": "ap-northeast-1"
                },
                {
                    "cost": 16.122873119388935,
                    "xAxis": "ap-northeast-2"
                },
                {
                    "cost": 0.578173890734156,
                    "xAxis": "ap-northeast-3"
                },
                {
                    "cost": 3.447814177025843,
                    "xAxis": "ap-south-1"
                },
                {
                    "cost": 1.0833228981371137,
                    "xAxis": "ap-southeast-1"
                },
                {
                    "cost": 1326.9919779724503,
                    "xAxis": "ap-southeast-2"
                },
                {
                    "cost": 1091.2001295606847,
                    "xAxis": "ca-central-1"
                },
                {
                    "cost": 10864.315413267484,
                    "xAxis": "eu-central-1"
                },
                {
                    "cost": 0.680978558571026,
                    "xAxis": "eu-north-1"
                },
                {
                    "cost": 152.0044725767814,
                    "xAxis": "eu-west-1"
                },
                {
                    "cost": 7.653599999999999e-8,
                    "xAxis": "us-west-2"
                }
            ]
        }
    ],
    "request": {
        "viewId": "8be1c2f8-ee6e-4467-bef0-6955ff791cd2",
        "date": {
            "unixTimeMillSecondsStart": 1719824738000,
            "unixTimeMillSecondsEnd": 1719911138000
        },
        "costType": "netAmortizedCost"
    },
    "requestId": "2bbb87e7-b5fc-4e42-9eae-36c88fee8f34"
}

X-Axis with group by

X-Axis with multiple group bys

Errors

400	Bad Request
401	Unauthorized
429	Too many requests
503	Server unavailable
504	Gateway Timeout