---
title: "List extra keys used in service accounts"
method: POST
path: "/v2/billing/extras"
tags: ["Billing"]
---

# List extra keys used in service accounts

`POST /v2/billing/extras`

List extra keys for service accounts.

## Request body

- BillingExtraKeysRequest
  - `service_account_ids` string[] — Service Account IDs
  - `descendant_service_account_query` DescendantServiceAccountQuery
    - `service_account_ids` string[], required — Service account IDs that belong to the ancestors of matching accounts.
    - `include_self` boolean — Include the given service accounts in the result set
    - `include_billing_as_parent` boolean — Also include accounts whose billing_account_id matches any of the given accounts.
    - `include_resource_as_parent` boolean — Also include accounts whose resource_service_account_id matches any of the given accounts.
    - `include_commercial_as_parent` boolean — Also include AWS GovCloud accounts whose commercial_account_id matches any of the given accounts.
    - `exclude_service_account_ids` string[] — Service account IDs to excluded with descendants.
  - `for_platform` boolean — If set, redirect the query to billing platform line items summary collection
  - `skip_service_account_grouping` boolean — If set, do not group by service account
  - `extra_keys` string[] — If set, the subset of keys to return
  - `include_values` boolean — If set, include values, not just keys

## Response `200`

Success

- ServiceAccountKeyValues[] — List of tag key/value pairs by service account
  - `service_account_id` string — Service Account ID
  - `values_by_key` KeyValues[] — List of tag key/value pairs for an account
    - `key` string — Key of the pair
    - `values` string[] — Values of the key

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/corestack/apis/corestack-external-api.md) · [All operations](https://skmtc.net/corestack/apis/corestack-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/corestack/corestack-external-api/versions/bf2cdf20826d/schema)