Get notification icon

GET /api/v1/notifications/icons/{iconId}

Serves a notification icon image. Icon IDs are derived from notification data (session, ID, timestamp, and file extension). Use this endpoint when rendering notification payloads that reference an icon asset.

Parameters

Name	In	Type	Required	Description
iconId	path	string	Yes	The unique identifier for the icon (e.g., 6_10_1749024932903.png)

Response

200

The icon image is returned as binary content. The response includes standard cache headers and a Content-Type reflecting the image format (image/png, image/jpeg, or image/svg+xml).

Response headers

Header	Description
Content-Type	MIME type of the image (e.g., image/png)
Cache-Control	Caching directives (e.g., public, max-age=86400)
ETag	Entity tag for cache validation
Last-Modified	Last modification date

The response body is the raw image bytes — not JSON.

304

Client cache is still valid. The response has an empty body; honor the cached version of the icon.

404

{
  "success": false,
  "error": "Not Found",
  "details": "The requested icon does not exist"
}

429

{
  "success": false,
  "error": "Rate Limit Exceeded",
  "details": "Too many requests, please try again later"
}

SDK usage

The iconId is passed positionally as a string.

const icon = await client.notifications.icons.get("6_10_1749024932903.png");

cURL example

curl -O \
  https://api.hoody.com/api/v1/notifications/icons/6_10_1749024932903.png

Tip

Icon IDs typically encode session, notification, timestamp, and file extension components separated by underscores and a dot before the extension (e.g., sessionID_notificationID_timestamp.ext). Cache responses using the ETag and Last-Modified headers returned with the image.