---
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.

# Get attribute group

Get a specific attribute group by its ID.


# 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"
        ]
      },
      "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"
        ]
      },
      "ErrorResponse": {
        "type": "object",
        "description": "Error response",
        "properties": {
          "message": {
            "type": "string",
            "description": "Error description"
          },
          "error_code": {
            "type": "string",
            "description": "Error code ID",
            "deprecated": true
          },
          "code": {
            "description": "Error code ID",
            "type": "string"
          }
        }
      }
    },
    "examples": {
      "ERUL0805": {
        "description": "Attribute group not found example",
        "value": {
          "message": "attribute group not found",
          "error_code": "RULVAL0400",
          "code": "ERUL0805"
        }
      }
    }
  },
  "tags": [
    {
      "name": "Attribute groups",
      "description": "API endpoints for managing attribute groups used in flex controls."
    }
  ],
  "paths": {
    "/v1/attribute-groups/{groupId}": {
      "get": {
        "operationId": "get-v1-attribute-groups-groupId",
        "summary": "Get attribute group",
        "description": "Get a specific attribute group by its ID.\n",
        "tags": [
          "Attribute groups"
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "groupId",
            "in": "path",
            "description": "Attribute group ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK. Attribute group was found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AttributeGroupObject"
                }
              }
            }
          },
          "404": {
            "description": "Not found. The attribute group was not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "examples": {
                  "attribute group not found": {
                    "$ref": "#/components/examples/ERUL0805"
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
```