---
updatedAt: 2026-05-12T17:47:03.000Z
---

Fetch the complete documentation index at: https://developers.pismo.io/pismo-docs/llms.txt. Use this file to discover all available pages before exploring further.

# List attribute groups

List all available attribute groups in the organization. You can optionally provide the `limit` query parameter to specify the maximum number of groups to return per page.


# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Core platform - Flex controls",
    "version": "1.0.0",
    "description": "Flex controls API",
    "contact": {
      "name": "API Support",
      "url": "https://developers.pismo.io/support/"
    },
    "license": {
      "name": "Copyright Pismo"
    }
  },
  "servers": [
    {
      "url": "https://sandbox.pismolabs.io/rules",
      "description": "Sandbox API server for testing"
    }
  ],
  "components": {
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "Account access token. Tokens can expire quickly, which can result in an \"Unauthorized\" error.",
        "bearerFormat": "JWT"
      }
    },
    "schemas": {
      "AttributeGroupDescription": {
        "type": "string",
        "description": "Short description of the attribute group",
        "maxLength": 50,
        "minLength": 1,
        "example": "High-risk merchant IDs"
      },
      "AttributeGroupID": {
        "type": "string",
        "description": "Attribute group ID, unique within the organization",
        "maxLength": 36,
        "minLength": 1,
        "example": "non-trusted-merchants"
      },
      "AttributeGroupType": {
        "type": "string",
        "enum": [
          "merchant_id",
          "merchant_category_code"
        ],
        "description": "Flex control scope\n  * `merchant_category_code`:  Merchant category code (MCC) is a four-digit number assigned to a business by credit card companies. It is used to classify the business by the type of goods or services it provides.\n  * `merchant_id`: Unique ID assigned to a merchant by the payment processor.\n"
      },
      "AttributeGroupValues": {
        "type": "array",
        "description": "Attribute group values\n- Each value must be unique within the array\n- Maximum of 20,000 items\n- Each item must not exceed 15 characters\n",
        "maxLength": 25000,
        "minLength": 1,
        "items": {
          "type": "string",
          "pattern": "^[a-zA-Z0-9]+$",
          "maxLength": 15,
          "minLength": 1
        },
        "example": [
          "0123",
          "2224",
          "3876"
        ]
      },
      "AttributeListGroupResponse": {
        "type": "object",
        "description": "Response containing a list of attribute groups",
        "properties": {
          "items": {
            "type": "array",
            "description": "List of attribute groups",
            "items": {
              "$ref": "#/components/schemas/AttributeGroupObject"
            }
          }
        }
      },
      "AttributeGroupObject": {
        "type": "object",
        "description": "Attribute group object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/AttributeGroupID"
          },
          "description": {
            "$ref": "#/components/schemas/AttributeGroupDescription"
          },
          "type": {
            "$ref": "#/components/schemas/AttributeGroupType"
          },
          "values": {
            "$ref": "#/components/schemas/AttributeGroupValues"
          }
        },
        "required": [
          "id",
          "description",
          "type",
          "values"
        ]
      }
    }
  },
  "tags": [
    {
      "name": "Attribute groups",
      "description": "API endpoints for managing attribute groups used in flex controls."
    }
  ],
  "paths": {
    "/v1/attribute-groups": {
      "get": {
        "operationId": "get-v1-attribute-groups",
        "summary": "List attribute groups",
        "description": "List all available attribute groups in the organization. You can optionally provide the `limit` query parameter to specify the maximum number of groups to return per page.\n",
        "tags": [
          "Attribute groups"
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "limit",
            "description": "Maximum number of attribute groups to return",
            "in": "query",
            "schema": {
              "type": "number",
              "example": 100
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK. Attribute groups for the account were found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AttributeListGroupResponse"
                }
              }
            }
          }
        }
      }
    }
  }
}
```