--- title: "Listing Attribute Definitions" slug: "engage-api-listing-attribute-definitions" updated: 2026-07-30T16:38:39Z published: 2026-07-30T16:40:14Z canonical: "docs.mapp.com/engage-api-listing-attribute-definitions" --- > ## 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. # Listing Attribute Definitions This use case shows how to retrieve Engage attribute definitions through the API — for example, to discover which profile attributes exist and their data types before mapping or syncing contact data. ## Prerequisites Before you begin, make sure you have valid authorization credentials. See [Getting Started with Engage API](/v1-api/apidocs/getting-started-with-engage-api) for more information. ## Procedure Retrieve the profile attributes with a GET request. Optional query parameters let you include archived attributes (`archived`) and enumerated values (`withEnums`). ```json GET 'https://your-engage-domain.com/api/rest/profileAttributes/list?withEnums=true' ``` To retrieve a single attribute, use `GET /profileAttributes/get` with an `attributeId`. ## Conclusion You receive a **200** response with an array of attribute definitions. Each entry includes fields such as `id`, `name`, `displayName`, and `dataType`, and flags such as `standard`, `technical`, `archived`, and `enumerated` (with `enumeratedValues`). Member, group, and address attributes have their own list endpoints. ## Related Topics [List profile attributes](/v1-api/apidocs/list-profile-attributes-1) [Get a profile attribute](/v1-api/apidocs/get-a-single-profile-attribute-by-id-1) [Getting Started with Engage API](/v1-api/apidocs/getting-started-with-engage-api)