---
title: "List attribution plugin installations"
method: GET
path: "/v1/ai-cost-management/attribution-plugins"
tags: ["attribution-plugins"]
---

# List attribution plugin installations

`GET /v1/ai-cost-management/attribution-plugins`

## Request

- Base URL: `https://global.api.konghq.com`
- URL: `https://global.api.konghq.com/v1/ai-cost-management/attribution-plugins`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer

Returns a page of the attribution plugin installations on the organization's AI Gateways, sorted by `gateway_id` unless the request sets `sort`. An AI Gateway without the plugin has no entry.

## Query parameters

- `sort` string
- `page[size]` integer
- `page[after]` string
- `page[before]` string

## Response `200`

A page of attribution plugin installations.

- object
  - `data` AICostAttributionPlugin[], required: The attribution plugin installations on this page, in `sort` order.
    - `gateway_id` string, uuid, required: The ID of the AI Gateway the plugin is installed on.
    - `version` string, required: The plugin version installed on the gateway.
    - `latest_version` string, required: The newest plugin version. When it differs from `version`, a `PUT` of the stored configuration installs it.
    - `integrations` AICostAttributionPluginIntegration[], required: The integrations whose headers the plugin reads.
    - `headers` AICostAttributionPluginHeaderMapping[], required: Request headers mapped to tag keys.
      - `name` string, required: The request header, compared case-insensitively. A credential header, or the start of one such as `x-goog` for `x-goog-api-key`, is refused.
      - `tag_key` string, required: The tag key the header's value becomes.
    - `prefixes` AICostAttributionPluginPrefixMapping[], required: Header prefixes whose headers become tags.
      - `name` string, required: The prefix, compared case-insensitively. Every header named `<name>-<remainder>` becomes the tag `<remainder>`. A credential header, or the start of one, is refused.
    - `operator_tags` object, required: Tags the plugin adds to every request.
    - `group_patterns` string[], required: PCRE regular expressions that choose which groups the plugin keeps from the caller's token.
    - `created_at` string, date-time, required: An ISO-8601 timestamp representation of entity creation date.
    - `updated_at` string, date-time, required: An ISO-8601 timestamp representation of entity update date.
  - `meta` CursorMeta, required: Pagination metadata.
    - `page` CursorMetaPage, required
      - `first` string, path: URI to the first page
      - `last` string, path: URI to the last page
      - `next` string, path, nullable, required: URI to the next page
      - `previous` string, path, nullable, required: URI to the previous page
      - `size` number, required: Requested page size

## Other responses

- `400`: A query parameter is invalid. `invalid_parameters` names each invalid parameter.
- `401`: The request has no valid access token. The token is missing, malformed, or expired, or it fails another check, and the response doesn't say which.
- `403`: The access token is valid, but its principal lacks the permission this operation requires. For an operation on one resource, the response doesn't reveal whether that resource exists.

## Changes

- **2026-11-19** `3b071797f6e4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/kong/apis/konnect-api-go-sdk/changes/v1/ai-cost-management/attribution-plugins/get.md)

---

[API](https://skmtc.dev/kong/apis/konnect-api-go-sdk.md) - [All operations](https://skmtc.dev/kong/apis/konnect-api-go-sdk/llms.txt) - [OpenAPI document](https://skmtc.dev/kong/apis/konnect-api-go-sdk/revisions/3b071797f6e4?raw)
