Documentation Index

Fetch the complete documentation index at: https://docs.mapp.com/llms.txt

Use this file to discover all available pages before exploring further.

Get all attributes assigned to a catalog

Updated
  • 2 minute(s) read
Prev Next
Get
/api/product-catalog/v1/catalogs/metadata/attribute/{catalogId}

Returns all active attributes assigned to the specified catalog. Inactive attributes are not returned by this endpoint.

Security
HTTP
Type bearer
Path parameters
catalogId
integer (int64) Required

Catalog identifier whose assigned attributes should be returned.

Responses
200

Catalog attributes found

[
  {
    "name": "color",
    "dataType": "MAP",
    "localizedAttributeKeyType": "LANGUAGE_COUNTRY",
    "localizedAttributeValueType": "STRING",
    "catalogType": "SOURCE"
  },
  {
    "name": "price",
    "dataType": "MAP",
    "localizedAttributeKeyType": "COUNTRY",
    "localizedAttributeValueType": "DECIMAL",
    "catalogType": "SOURCE"
  },
  {
    "name": "fashion_material",
    "dataType": "STRING",
    "localizedAttributeKeyType": null,
    "localizedAttributeValueType": null,
    "catalogType": "ENRICHED"
  }
]
Array of object
object

Represents a single product catalog attribute with its data type and optional localization metadata

name
string

Unique attribute name as defined in the catalog

dataType
string

Data type of a catalog attribute value:

  • STRING — plain text value (e.g. "blue")
  • NUMBER — integer or decimal value (e.g. 42, 3.14)
  • BOOLEAN — boolean value (true or false)
  • JSON — arbitrary JSON object (e.g. {"key": "value"})
  • MAP — flat key-value map (e.g. {"en": "blue", "de": "blau"})
  • LIST — ordered list of scalar values (e.g. ["S", "M", "L"])
  • LIST_OF_MAPS — list of key-value maps (e.g. [{"color": "red"}, {"color": "blue"}])
  • MAP_OF_LISTS — map where each key holds a list of values (e.g. {"sizes": ["S", "M"], "colors": ["red"]})
Valid values[ "STRING", "NUMBER", "BOOLEAN", "JSON", "MAP", "LIST", "LIST_OF_MAPS", "MAP_OF_LISTS" ]
localizedAttributeKeyType
string

Type of localized attribute key, determining the expected key format:

  • COUNTRY_CODE — ISO 3166-1 alpha-2 two-letter country code (e.g. US, DE)
  • LANGUAGE_CODE — ISO 639-1 two-letter language code (e.g. en, de)
  • LANGUAGE_CODE_COUNTRY_CODE — BCP 47 language-country tag, hyphen-separated (e.g. en-US, de-DE)
  • CURRENCY — ISO 4217 three-letter currency code (e.g. USD, EUR)
  • NUMBER — numeric value, integer or decimal (e.g. 42, 3.14)
  • STRING — arbitrary string value
Valid values[ "COUNTRY_CODE", "LANGUAGE_CODE", "LANGUAGE_CODE_COUNTRY_CODE", "CURRENCY", "NUMBER", "STRING" ]
localizedAttributeValueType
string

Type of localized attribute value, determining the expected value format:

  • STRING — arbitrary string value (e.g. sample text)
  • NUMBER — numeric value, integer or decimal (e.g. 42, 3.14)
  • BOOLEAN — boolean value (true or false)
  • COUNTRY_CODE — ISO 3166-1 alpha-2 two-letter country code (e.g. US, DE)
  • LANGUAGE_CODE — ISO 639-1 two-letter language code (e.g. en, de)
  • CURRENCY — ISO 4217 three-letter currency code (e.g. USD, EUR)
  • LANGUAGE_CODE_COUNTRY_CODE — BCP 47 language-country tag, hyphen-separated (e.g. en-US, de-DE)
Valid values[ "STRING", "NUMBER", "BOOLEAN", "COUNTRY_CODE", "LANGUAGE_CODE", "CURRENCY", "LANGUAGE_CODE_COUNTRY_CODE" ]
catalogType
string

Catalog data layer this attribute originates from

Valid values[ "SOURCE", "ENRICHED", "COMBINED" ]
204

No active attributes are assigned to the catalog.

500

Unexpected error while fetching catalog attributes.

{
  "message": "Unexpected error while processing request",
  "httpStatus": 500,
  "errorCode": "500 Internal Server Error",
  "timestamp": "2026-07-08T12:00:00Z"
}
object
message
string
httpStatus
integer (int32)
errorCode
string
timestamp
string (date-time)