---
title: "Read entity counts"
method: GET
path: "/cm/v1/entity-counts"
tags: ["ReadEntityCount"]
---

# Read entity counts

`GET /cm/v1/entity-counts`

Retrieve the current number of entities and the limits under each ancestor types.
Visit the [guide document](https://developer.moloco.cloud/docs/entity-quota) for more details.

## Query parameters

- `ad_account_id` string
- `product_id` string
- `campaign_id` string
- `entity_type` 'UNKNOWN_ENTITY_TYPE' | 'ENTITY_TYPE_PLATFORM' | 'ENTITY_TYPE_AD_ACCOUNT' | 'ENTITY_TYPE_PRODUCT' | 'ENTITY_TYPE_CAMPAIGN' | 'ENTITY_TYPE_AD_GROUP' | 'ENTITY_TYPE_CREATIVE_GROUP' | 'ENTITY_TYPE_CREATIVE' | 'ENTITY_TYPE_TRACKING_LINK' | 'ENTITY_TYPE_TARGET' | 'ENTITY_TYPE_CUSTOMER_SET' | 'ENTITY_TYPE_CUSTOMER_ACTIVITY', required

## Response `200`

A successful response.

- MessagesReadEntityCountResponse
  - `entity_counts` DspEntityCount[] — Entity counts of the given entity type under for each parent scope.
    - `scope_type` 'UNKNOWN_ENTITY_TYPE' | 'ENTITY_TYPE_PLATFORM' | 'ENTITY_TYPE_AD_ACCOUNT' | 'ENTITY_TYPE_PRODUCT' | 'ENTITY_TYPE_CAMPAIGN' | 'ENTITY_TYPE_AD_GROUP' | 'ENTITY_TYPE_CREATIVE_GROUP' | 'ENTITY_TYPE_CREATIVE' | 'ENTITY_TYPE_TRACKING_LINK' | 'ENTITY_TYPE_TARGET' | 'ENTITY_TYPE_CUSTOMER_SET' | 'ENTITY_TYPE_CUSTOMER_ACTIVITY' — List of entity types supported in DSP API.
    - `limit` string, int64 — The total number of entities allowed under the scope type. 'limit' for the entity is different for each scope type. Visit the [guide document](https://developer.moloco.cloud/docs/entity-quota) for more details.
    - `current` string, int64 — The number of entities created so far.

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/moloco/apis/moloco-ads-campaign-management-api.md) · [All operations](https://skmtc.net/moloco/apis/moloco-ads-campaign-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/moloco/moloco-ads-campaign-management-api/revisions/5c85d0910ac0/schema)