## Total record count for an object type

**get** `/v2/prism/{teamId}/deal/count`

Returns the total number of records of this object type that the caller can see. Avoids the page-overshoot anti-pattern — clients no longer need to keep paging until `has_more` flips false to discover the total. Currently does not apply query filters; for a filtered total, pass `include_total: true` in a POST `/query` body. Unfiltered counts on high-cardinality types (especially `engagement`) scan the full access-scoped set and can take tens of seconds or time out; prefer a filtered `include_total` query or accept that this endpoint is expensive there.

### Path Parameters

- `teamId: optional string`

### Query Parameters

- `list_id: optional string`

  Scope the count to a specific list/app.

### Returns

- `total: number`

  Number of records matching the access scope.

### Example

```http
curl https://developers.micro.so/v2/prism/$TEAM_ID/deal/count \
    -H "x-api-key: $MICRO_API_KEY"
```

#### Response

```json
{
  "total": 0
}
```