---
title: "Read an entity's custom field values"
type: reference
method: GET
path: /rest-api/additional-fields/{entityType}/{entityId}.do
tag: "Categories"
---

# Read an entity's custom field values

`GET https://YOUR-NETWORK-DOMAIN/rest-api/additional-fields/{entityType}/{entityId}.do`

Returns every custom (additional) field the network defines for the entity type, with the entity's value. A field the entity has no value for comes back with value null. These are the fields of the console's Basic Info card; their definitions are managed under /rest-api/additional-entity-fields-configuration. Needs view rights on the entity: the advertiser's share for an advertiser, campaign or banner, the site's share for a site, zone or placement.

## Path params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `entityType` | string | yes | `CAMPAIGN` | Entity type the fields belong to |
| `entityId` | integer | yes | `2001` | Id of the advertiser, campaign, banner, site, zone or placement |

## Responses

- `200` — 'fields' lists {id, name, title, value} for each field of the entity type
- `400` — Unknown entity type
- `401` — Authentication error
- `403` — No view rights on the entity
- `404` — The entity does not exist or is deleted

## Example request

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

Source: https://epom.com/ad-server/docs/api/categories/get-additional-fields