---
title: "GET Contact Consent Counts"
method: GET
path: "/contacts/counts"
tags: ["Contacts"]
---

# GET Contact Consent Counts

`GET /contacts/counts`

Use to get the total contacts count for the account and the total contact-consent counts for each consent state. Optionally, to include the total number of contacts that subscribed within the last 30 days in the results, use `new_subscribers` in the `include` query parameter. To optimize open rates, reduce spam reports, and help grow your business,  you must value your contact's consent to receive or to not receive your emails.

## Query parameters

- `include` 'new_subscriber'

## Response `200`

Request successful

- ContactsCounts
  - `total` integer — Total number of contacts for the account.
  - `explicit` integer — Total number of contacts explicitly confirmed. Consent is obtained when you explicitly ask your potential contacts for permission to send the email (for example, using a sign-up form) and they agree. After you obtain express consent, it is good forever or until the contact opts out.
  - `implicit` integer — Total number of contacts implicitly confirmed. Consent is inferred based on actions, such as having an existing business relationship (making a purchase or donation, for example). In order to maintain implied consent to comply with CASL a contact must take a business action with you at least once every two years. Under CAN-Spam there is no need to maintain implied consent, it is assumed until the receiver indicates they no longer wish to receive messages.
  - `pending` integer — Total number of contacts pending confirmation. Consent is requested and pending confirmation from the contact.
  - `unsubscribed` integer — Total number of unsubscribed contacts. Consent is revoked when a contact has unsubscribed.
  - `new_subscriber` integer — Total number of newly subscribed contacts.

## Other responses

- `400` — Bad request. Either the JSON was malformed or there was a data validation error.
- `401` — The Access Token used is invalid.
- `403` — Forbidden request. You lack the necessary scopes, you lack the necessary user privileges, or the application is deactivated.
- `404` — The requested resource was not found.
- `500` — There was a problem with our internal service.
- `503` — Our internal service is temporarily unavailable.

---

[API](https://skmtc.net/cc/apis/appconnect-v3.md) · [All operations](https://skmtc.net/cc/apis/appconnect-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cc/appconnect-v3/revisions/4b4a534c818d/schema)