GET

/billing-groups

http://iot.{region}.amazonaws.com/billing-groups

Lists the billing groups you have created. Requires permission to access the <a href="https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiot.html#awsiot-actions-as-permissions">ListBillingGroups</a> action.

Access Token Required: API Key

Query Params

nextTokenstring

To retrieve the next set of results, the <code>nextToken</code> value from a previous response; otherwise null to receive the first set of results.

maxResultsinteger

The maximum number of results to return per request.

namePrefixFilterstring

Limit the results to billing groups whose names have the given prefix.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request GET \
2     --url 'http://iot.{region}.amazonaws.com/billing-groups' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}