---
title: "Get Inbox Message Count – Retrieves the count of inbox messages for an account, optionally filtered by status."
method: GET
path: "/programs/{programCode}/accounts/{accountIdentifier}/inbox/messages/count"
tags: ["Notification"]
---

# Get Inbox Message Count – Retrieves the count of inbox messages for an account, optionally filtered by status.

`GET /programs/{programCode}/accounts/{accountIdentifier}/inbox/messages/count`

Get Inbox Message Count

## Path parameters

- `programCode` string, required
- `accountIdentifier` string, required

## Query parameters

- `status` integer
- `sccAccountIdentifier` string

## Headers

- `X-GD-RequestId` string, required

## Response `200`

OK

- GetInboxMessageCountResponse — Represents the response returned after retrieving the count of inbox messages for an account. Contains the total number of messages matching the request criteria, along with standard response metadata. Used to provide message count information for display, notification badges, or analytics within a partner program.
  - `count` integer, nullable — The total number of inbox messages matching the request criteria. Used for notification badges, message analytics, or pagination.
  - `responseDetails` ResponseDetail[], nullable — Required: A list of response details providing status codes, descriptions, and additional information about the result of the operation.
    - `code` integer — The primary status or error code for the response (e.g., 200 for success, 400 for validation error).
    - `subCode` integer, nullable — An optional subcode providing more granular detail about the response or error.
    - `description` string, nullable — A human-readable description of the response, error, or status.
    - `url` string, nullable — A URL linking to documentation or a web page with more information about the response code.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/greendot/apis/baas-apis.md) · [All operations](https://skmtc.net/greendot/apis/baas-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/greendot/baas-apis/revisions/666553766b78/schema)