---
title: "List additional entity fields"
type: reference
method: GET
path: /rest-api/additional-entity-fields-configuration/list.do
tag: "Users"
---

# List additional entity fields

`GET https://YOUR-NETWORK-DOMAIN/rest-api/additional-entity-fields-configuration/list.do`

Returns all configured additional entity fields that extend the standard entity model with custom attributes. Each field includes its unique ID, internal name, display title, and the entity type it belongs to (e.g. BANNER, CAMPAIGN). The response is wrapped in a SearchResult container with 'data' array and 'total' count. Requires the ADDITIONAL_ENTITIES_FIELDS_CONFIGURATION admin permission; without it the call answers 403 naming the permission.

## Responses

- `200` — SearchResult containing the list of AdditionalEntityField objects in 'data' and total count in 'total'
- `400` — Bad request — invalid or missing parameters
- `401` — Authentication error - invalid hash, timestamp, or username
- `403` — Forbidden - user lacks ADDITIONAL_ENTITIES_FIELDS_CONFIGURATION permission

## Example request

```bash
curl --request GET \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/additional-entity-fields-configuration/list.do' \
  --header 'X-Api-Key: YOUR_API_KEY'
```

Source: https://epom.com/ad-server/docs/api/users/get-additional-entity-fields-configuration-list