Skip to main content
GET
/
email
/
public
/
v1
/
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"
}

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

​
email
string<email>

The email address

​
subscriptionStatuses
object[]
​
status
string

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

Last modified on December 12, 2025