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

New
  • 1 minute(s) read
Prev Next
Get
/api/product-catalog/v1/catalogs/metadata/attribute/{catalogId}
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)