Get email subscription status for an email address

curl --request GET \
  --url https://api.hubapi.com/email/public/v1/subscriptions/{email_address}

{
  "subscribed": false,
  "markedAsSpam": false,
  "portalId": 62515,
  "bounced": false,
  "email": "jerry@example.org",
  "subscriptionStatuses": [],
  "status": "unsubscribed"
}

GET

public

subscriptions

{email_address}

Get email subscription status for an email address

curl --request GET \
  --url https://api.hubapi.com/email/public/v1/subscriptions/{email_address}

{
  "subscribed": false,
  "markedAsSpam": false,
  "portalId": 62515,
  "bounced": false,
  "email": "jerry@example.org",
  "subscriptionStatuses": [],
  "status": "unsubscribed"
}

Scope requirements

Path Parameters

email_address

string<email>

required

The email address for which you are requesting subscription status.

Response

Email subscription status retrieved successfully

subscribed

boolean

Whether the email is subscribed to all emails

markedAsSpam

boolean

Whether the email has been marked as spam

portalId

integer

The portal ID

bounced

boolean

Whether the email has bounced

string<email>

The email address

subscriptionStatuses

object[]

Show child attributes

status

string

Overall subscription status (e.g., subscribed, unsubscribed)

Last modified on March 30, 2026

⌘I