---
title: "AS Group APIs"
slug: "as-group-apis"
description: "Learn how to use Kentik's AS Group APIs to programmatically manage AS Groups, enabling traffic aggregation for advanced filtering and analysis."
updated: 2026-02-20T15:27:37Z
published: 2026-02-20T15:27:37Z
canonical: "kb.kentik.com/as-group-apis"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://kb.kentik.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AS Group APIs

This article covers how to get started with the AS Group APIs.

> [!NOTE]
> **Notes:**
> 
> - The [**API Tester**](https://portal.kentik.com/v4/core/api-tester) in the v4 Portal enables you to securely call the methods of these APIs using your organization's Kentik data.
> - AS Groups are supported in the Kentik portal via the **Settings »** **AS Groups** page. For more information, see [**AS Groups**](/v1/docs/as-groups).
> - Protobuf specifications for Kentik’s v6 APIs are available in our [**api-schema-public**](https://github.com/kentik/api-schema-public) repository.

## AS Group Usage

The AS Group API provides programmatic access to the configuration of AS Groups, allowing the traffic of a set of ASes to be summed so it can be evaluated together for the purpose of filtering and top-X grouping in queries.

## AS Group RPCs

The tables below provide a quick reference to key information about each Remote Procedure Call in these APIs. Use the links in the tables to see schemas for the request and/or response body (if any).

> [!NOTE]
> **Note:** To test methods using your own Kentik data, use the portal's [**API Tester**](https://portal.kentik.com/v4/core/api-tester).

### ListASGroups

**API: ASGroupService**

| REST Method | REST Endpoint | Description |
| --- | --- | --- |
| GET | /as_group/v202212 /as_group | Returns list of configured AS groups. |
| \| **Request body:** None **Parameters:** None \| **Response body**: [v202212ListASGroupsResponse](/v1/docs/as-group-apis#listasgroupsresponse) \| \| --- \| --- \| |
| **Request body:** None **Parameters:** None | **Response body**: [v202212ListASGroupsResponse](/v1/docs/as-group-apis#listasgroupsresponse) |

### CreateASGroup

**API: ASGroupService**

| REST Method | REST Endpoint | Description |
| --- | --- | --- |
| POST | /as_group/v202212 /as_group | Create configuration for a new AS group. Returns the newly created configuration. |
| \| **Request body:** [v202212CreateASGroupRequest](/v1/docs/as-group-apis#createasgrouprequest) **Parameters:** None \| **Response body**: [v202212CreateASGroupResponse](/v1/docs/as-group-apis#createasgroupresponse) \| \| --- \| --- \| |
| **Request body:** [v202212CreateASGroupRequest](/v1/docs/as-group-apis#createasgrouprequest) **Parameters:** None | **Response body**: [v202212CreateASGroupResponse](/v1/docs/as-group-apis#createasgroupresponse) |

### UpdateASGroup

**API: ASGroupService**

| REST Method | REST Endpoint | Description |
| --- | --- | --- |
| PUT | /as_group/v202212 /as_group/{asGroup.id} | Replaces configuration of an AS group with attributes in the request. Returns the updated configuration. |
| \| **Request body:** [v202212UpdateASGroupRequest](/v1/docs/as-group-apis#updateasgrouprequest) \| **Response body:** [v202212UpdateASGroupResponse](/v1/docs/as-group-apis#updateasgroupresponse) \| \| --- \| --- \| **Parameters**: \| Name \| Description \| Required \| Type \| \| --- \| --- \| --- \| --- \| \| asGroup.id \| System generated unique identifier \| true \| string \| |
| **Request body:** [v202212UpdateASGroupRequest](/v1/docs/as-group-apis#updateasgrouprequest) | **Response body:** [v202212UpdateASGroupResponse](/v1/docs/as-group-apis#updateasgroupresponse) |
| Name | Description | Required | Type |
| asGroup.id | System generated unique identifier | true | string |

### GetASGroup

**API: ASGroupService**

| REST Method | REST Endpoint | Description |
| --- | --- | --- |
| GET | /as_group/v202212 /as_group/{asGroup.id} | Returns configuration of a AS group specified by ID. |
| \| **Request body**: None \| **Response body:** [v202212GetASGroupResponse](/v1/docs/as-group-apis#getasgroupresponse) \| \| --- \| --- \| **Parameters:** \| Name \| Description \| Required \| Type \| \| --- \| --- \| --- \| --- \| \| asGroup.id \| ID of the requested AS group \| true \| string \| |
| **Request body**: None | **Response body:** [v202212GetASGroupResponse](/v1/docs/as-group-apis#getasgroupresponse) |
| Name | Description | Required | Type |
| asGroup.id | ID of the requested AS group | true | string |

### DeleteASGroup

**API: ASGroupService**

| REST Method | REST Endpoint | Description |
| --- | --- | --- |
| DELETE | /as_group/v202212 /as_group/{asGroup.id} | Deletes configuration of an AS group with specific ID. |
| \| **Request body:** None \| **Response body:** [v202212DeleteASGroupResponse](/v1/docs/as-group-apis#deleteasgroupresponse) \| \| --- \| --- \| **Parameters:** \| Name \| Description \| Required \| Type \| \| --- \| --- \| --- \| --- \| \| asGroup.id \| ID of the AS group to be deleted \| true \| string \| |
| **Request body:** None | **Response body:** [v202212DeleteASGroupResponse](/v1/docs/as-group-apis#deleteasgroupresponse) |
| Name | Description | Required | Type |
| asGroup.id | ID of the AS group to be deleted | true | string |

## AS Group Schemas

This API uses the following schemas.

#### protobufAny

| **Schema:** protobufAny | **Type:** object |
| --- | --- |
| **Properties:** \| Name \| Value \| \| --- \| --- \| \| typeUrl \| type: string \| \| value \| type: string format: byte \| |
| Name | Value |
| typeUrl | type: string |
| value | type: string format: byte |

#### rpcStatus

| **Schema:** rpcStatus | **Type:** object |
| --- | --- |
| **Properties:** \| Name \| Value \| \| --- \| --- \| \| code \| type: integer format: int32 \| \| message \| type: string \| \| details \| type: array items: $ref: [protobufAny](/v1/docs/as-group-apis#protobufany) \| |
| Name | Value |
| code | type: integer format: int32 |
| message | type: string |
| details | type: array items: $ref: [protobufAny](/v1/docs/as-group-apis#protobufany) |

#### ASGroupConcise

| **Schema:** v202212ASGroupConcise | **Type:** object |
| --- | --- |
| **Properties** **(* = required)** \| Name \| Value \| \| --- \| --- \| \| id \| type: string description: System generated unique identifier readOnly: true \| \| name * \| type: string description: User selected unique name \| \| asn \| type: array items: type: string description: List of ASNs \| \| createdDate \| type: string format: date-time description: Creation timestamp (UTC) readOnly: true \| \| updatedDate \| type: string format: date-time description: Last modification timestamp (UTC) readOnly: true \| |
| Name | Value |
| id | type: string description: System generated unique identifier readOnly: true |
| name * | type: string description: User selected unique name |
| asn | type: array items: type: string description: List of ASNs |
| createdDate | type: string format: date-time description: Creation timestamp (UTC) readOnly: true |
| updatedDate | type: string format: date-time description: Last modification timestamp (UTC) readOnly: true |

#### ASGroupDetailed

| **Schema:** v202212ASGroupDetailed | **Type:** object |
| --- | --- |
| **Properties (* = required)** \| Name \| Value \| \| --- \| --- \| \| id \| type: string description: System generated unique identifier readOnly: true \| \| name * \| type: string description: User selected unique name \| \| asn \| type: array items: $ref: [v202212AutonomousSystem](/v1/docs/as-group-apis#autonomoussystem) description: List of ASNs \| \| createdDate \| type: string format: date-time description: Creation timestamp (UTC) readOnly: true \| \| updatedDate \| type: string format: date-time description: Last modification timestamp (UTC) readOnly: true \| |
| Name | Value |
| id | type: string description: System generated unique identifier readOnly: true |
| name * | type: string description: User selected unique name |
| asn | type: array items: $ref: [v202212AutonomousSystem](/v1/docs/as-group-apis#autonomoussystem) description: List of ASNs |
| createdDate | type: string format: date-time description: Creation timestamp (UTC) readOnly: true |
| updatedDate | type: string format: date-time description: Last modification timestamp (UTC) readOnly: true |

#### AutonomousSystem

| **Schema:** v202212AutonomousSystem | **Type:** object |
| --- | --- |
| **Properties:** \| Name \| Value \| \| --- \| --- \| \| asn \| type: integer format: int64 \| \| name \| type: string \| |
| Name | Value |
| asn | type: integer format: int64 |
| name | type: string |

#### CreateASGroupRequest

| **Schema:** v202212CreateASGroupRequest | **Type:** object |
| --- | --- |
| **Properties:** \| Name \| Value \| \| --- \| --- \| \| asGroup \| $ref: [v202212ASGroupConcise](/v1/docs/as-group-apis#asgroupconcise) \| |
| Name | Value |
| asGroup | $ref: [v202212ASGroupConcise](/v1/docs/as-group-apis#asgroupconcise) |

#### CreateASGroupResponse

| **Schema:** v202212CreateASGroupResponse | **Type:** object |
| --- | --- |
| **Properties:** \| Name \| Value \| \| --- \| --- \| \| asGroup \| $ref: [v202212ASGroupDetailed](/v1/docs/as-group-apis#asgroupdetailed) \| |
| Name | Value |
| asGroup | $ref: [v202212ASGroupDetailed](/v1/docs/as-group-apis#asgroupdetailed) |

#### DeleteASGroupResponse

| **Schema:** v202212DeleteASGroupResponse | **Type:** object |
| --- | --- |
| **Properties:** None. |

#### GetASGroupResponse

| **Schema:** v202212GetASGroupResponse | **Type:** object |
| --- | --- |
| **Properties:** \| Name \| Value \| \| --- \| --- \| \| asGroup \| $ref: [v202212ASGroupDetailed](/v1/docs/as-group-apis#asgroupdetailed) \| |
| Name | Value |
| asGroup | $ref: [v202212ASGroupDetailed](/v1/docs/as-group-apis#asgroupdetailed) |

#### ListASGroupsResponse

| **Schema:** v202212ListASGroupsResponse | **Type:** object |
| --- | --- |
| **Properties:** \| Name \| Value \| \| --- \| --- \| \| asGroups \| type: array items: $ref: [v202212ASGroupDetailed](/v1/docs/as-group-apis#asgroupdetailed) description: List of configurations of requested AS groups \| \| invalidCount \| type: integer format: int64 description: Number of invalid entries encountered while collecting data \| |
| Name | Value |
| asGroups | type: array items: $ref: [v202212ASGroupDetailed](/v1/docs/as-group-apis#asgroupdetailed) description: List of configurations of requested AS groups |
| invalidCount | type: integer format: int64 description: Number of invalid entries encountered while collecting data |

#### UpdateASGroupRequest

| **Schema:** v202212UpdateASGroupRequest | **Type:** object |
| --- | --- |
| **Properties:** \| Name \| Value \| \| --- \| --- \| \| asGroup \| $ref:[v202212ASGroupConcise](/v1/docs/as-group-apis#asgroupconcise) \| |
| Name | Value |
| asGroup | $ref:[v202212ASGroupConcise](/v1/docs/as-group-apis#asgroupconcise) |

#### UpdateASGroupResponse

| **Schema:** v202212UpdateASGroupResponse | **Type:** object |
| --- | --- |
| **Properties:** \| Name \| Value \| \| --- \| --- \| \| asGroup \| $ref: [v202212ASGroupDetailed](/v1/docs/as-group-apis#asgroupdetailed) \| |
| Name | Value |
| asGroup | $ref: [v202212ASGroupDetailed](/v1/docs/as-group-apis#asgroupdetailed) |