# Subscription\_Status API

**URL:** <https://community.hubspot.com/t/subscription-status-api/91079>\
**Category:** APIs & Integrations\
**Tags:** developer-tools\
**Created:** [October 4, 2023, 12:39pm UTC](https://community.hubspot.com/t/subscription-status-api/91079 "2023-10-04T12:39:10Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![CDP2023](https://avatars.discourse-cdn.com/v4/letter/c/c0e974/32.png) [@CDP2023](https://community.hubspot.com/u/CDP2023)\
**Post date:** [October 4, 2023, 12:39pm UTC](https://community.hubspot.com/t/subscription-status-api/91079/1 "2023-10-04T12:39:10Z")

</div>

Hi,

I wanted to understand what does this Subscription\_Status API endpoint : [https://developers.hubspot.com/docs/api/marketing-api/subscriptions-preferences](https://developers.hubspot.com/docs/api/marketing-api/subscriptions-preferences) help to achieve? There is little mention in the documentation but does it allow us to update the email subscriptions of contacts in bulk or does it only fetch the subscriptions the contacts are subscribed to?

 ![CDP2023_0-1696423087315.png](https://d2qpr2jzcazej7.cloudfront.net/original/3X/8/2/82cc058e8a2a876bba0a76245c8c719a88d4f1da.png)

Thanks!

---

<div class="post-metadata">

**Author:** ![Phil\_Vallender](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/phil_vallender/32/48924_2.png) [@Phil\_Vallender](https://community.hubspot.com/u/Phil_Vallender)\
**Post date:** [October 4, 2023, 2:38pm UTC](https://community.hubspot.com/t/subscription-status-api/91079/2 "2023-10-04T14:38:25Z")

</div>

Hi @CDP2023

There are several endpoints in that API that can be used to:

- Set a subscription for a contact based on their email address (you could loop through contacts to apply this in bulk)
- Remove a subscription for a contact, again based on email
- Get current subscriptions for a specific contact
- Get all subscription types in your portal

Hope this helps.

---

<div class="post-metadata">

**Author:** ![CDP2023](https://avatars.discourse-cdn.com/v4/letter/c/c0e974/32.png) [@CDP2023](https://community.hubspot.com/u/CDP2023)\
**Post date:** [October 4, 2023, 2:59pm UTC](https://community.hubspot.com/t/subscription-status-api/91079/3 "2023-10-04T14:59:35Z")

</div>

Ahh got it! Thanks [@Phil\_Vallender](https://community.hubspot.com/t5/user/viewprofilepage/user-id/74) !