Vibes Platform Subscription API

The Subscription API API from Vibes Platform — 4 operation(s) for subscription api.

Documentation GitHub OpenAPI

Operations 6

GET /companies/{company_key}/mobiledb/persons/{person_key}/subscriptions Get subscriptions for a person_key

GET /companies/{company_key}/mobiledb/persons/external/{external_person_id}/subscriptions Get subscriptions for external_person_id

GET /companies/{company_key}/mobiledb/persons/{person_key}/subscriptions/{subscription_list_id} Get subscription status for list by person_key

DELETE /companies/{company_key}/mobiledb/persons/{person_key}/subscriptions/{subscription_list_id} Unsubscribe person by person_key

GET /companies/{company_key}/mobiledb/persons/external/{external_person_id}/subscriptions/{subscription_list_id} Get subscription status for list by external_person_id

DELETE /companies/{company_key}/mobiledb/persons/external/{external_person_id}/subscriptions/{subscription_list_id} Unsubscribe person by external_person_id

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/vibes-platform-subscription-api-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Vibes Platform Subscription API
  version: 1.0.0
servers:
- url: https://public-api.vibescm.com
  description: North America
- url: https://public-api.eu.vibes.com/
  description: EMEA
security:
- basicAuth: []
tags:
- name: Subscription API
paths:
  /companies/{company_key}/mobiledb/persons/{person_key}/subscriptions:
    get:
      tags:
      - Subscription API
      summary: Get subscriptions for a person_key
      parameters:
      - name: X-API-Version
        in: header
        schema:
          type: string
          default: 1
      - name: active_only
        in: query
        schema:
          type: boolean
        example: 'false'
      - name: company_key
        in: path
        schema:
          type: string
        required: true
      - name: person_key
        in: path
        schema:
          type: string
        required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/subscriptionsResponse'
        '404':
          description: The `person_key` cannot be located.
  /companies/{company_key}/mobiledb/persons/external/{external_person_id}/subscriptions:
    get:
      tags:
      - Subscription API
      summary: Get subscriptions for external_person_id
      parameters:
      - name: X-API-Version
        in: header
        schema:
          type: string
          default: 1
      - name: company_key
        in: path
        schema:
          type: string
        required: true
      - name: external_person_id
        in: path
        schema:
          type: string
        required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/subscriptionsResponse'
        '404':
          description: The `external_person_id` cannot be located.
  /companies/{company_key}/mobiledb/persons/{person_key}/subscriptions/{subscription_list_id}:
    get:
      tags:
      - Subscription API
      summary: Get subscription status for list by person_key
      parameters:
      - name: X-API-Version
        in: header
        schema:
          type: string
          default: 1
      - name: company_key
        in: path
        schema:
          type: string
        required: true
      - name: person_key
        in: path
        schema:
          type: string
        required: true
      - name: subscription_list_id
        in: path
        schema:
          type: string
        required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/subscriptionsResponse'
        '404':
          description: The person record cannot be located or they are not subscribed to the specified list.
    delete:
      tags:
      - Subscription API
      summary: Unsubscribe person by person_key
      parameters:
      - name: X-API-Version
        in: header
        schema:
          type: string
          default: 1
      - name: company_key
        in: path
        schema:
          type: string
        required: true
      - name: person_key
        in: path
        schema:
          type: string
        required: true
        description: <div style="color:#dd1e2e; background:url(https://d2xs7zaan7w9gl.cloudfront.net/data/pages/64014/widgets/48027d01-e827-45e0-b96d-227c1099eedc/image/1680214872.png?icon-24x24-warning.png) no-repeat 10px center; background-color:#FCEAEC; padding:10px; font-size:13px;"><div style="padding-left:35px"><b>Important:</b> If you are entering a real person_key, please note that using the <b>"Try It"</b> feature on the righthand console will send an actual API call to our system. This may result in a person being unsubscribed.</div></div>
      - name: subscription_list_id
        in: path
        schema:
          type: string
        required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
        '204':
          description: Deletion was successful.
        '404':
          description: Either the person cannot be located or they are already not subscribed to the specified list.
  /companies/{company_key}/mobiledb/persons/external/{external_person_id}/subscriptions/{subscription_list_id}:
    get:
      tags:
      - Subscription API
      summary: Get subscription status for list by external_person_id
      parameters:
      - name: X-API-Version
        in: header
        schema:
          type: string
          default: 1
      - name: company_key
        in: path
        schema:
          type: string
        required: true
      - name: external_person_id
        in: path
        schema:
          type: string
        required: true
      - name: subscription_list_id
        in: path
        schema:
          type: string
        required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/subscriptionsResponse'
        '404':
          description: Either the person record cannot be located or the person is not subscribed to the specified list.
    delete:
      tags:
      - Subscription API
      summary: Unsubscribe person by external_person_id
      parameters:
      - name: X-API-Version
        in: header
        schema:
          type: string
          default: 1
      - name: company_key
        in: path
        schema:
          type: string
        required: true
      - name: external_person_id
        in: path
        schema:
          type: string
        required: true
        description: <div style="color:#dd1e2e; background:url(https://d2xs7zaan7w9gl.cloudfront.net/data/pages/64014/widgets/48027d01-e827-45e0-b96d-227c1099eedc/image/1680214872.png?icon-24x24-warning.png) no-repeat 10px center; background-color:#FCEAEC; padding:10px; font-size:13px;"><div style="padding-left:35px"><b>Important:</b> If you are entering a real external_person_id, please note that using the <b>"Try It"</b> feature on the righthand console will send an actual API call to our system. This may result in a person being unsubscribed.</div></div>
      - name: subscription_list_id
        in: path
        schema:
          type: string
        required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
        '204':
          description: Deletion was successful.
        '404':
          description: Either the person cannot be located or they are already not subscribed to the specified list.
components:
  schemas:
    subscriptionsResponse:
      type: array
      items:
        $ref: '#/components/schemas/subscriptionResponse'
    subscriptionResponse:
      type: object
      properties:
        person:
          type: object
          description: Person reference information for the subscription.
          properties:
            id:
              type: string
              description: Vibes-unique person identifier.
            url:
              type: string
              description: Reference URL to the person resource.
        subscription_list:
          type: object
          properties:
            id:
              type: string
              description: Vibes unique subscription list identifier.
            url:
              type: string
              description: Reference URL to the subscription list resource.
        opt_in_date:
          type: string
          description: Date string indicating when the subscription was entered in ISO-8601 format.
        opt_out_date:
          type: string
          description: Date string indicating when the subscription was ended, if relevant, in ISO-8601 format.
        opt_out_reason:
          type: string
          description: The reason why the person was opted-out, if relevant.
          enum:
          - user_opt_out
          - disconnect
          - list_archived
          - bulk_opt_out
          - failed_at_carrier
          - obsolete_carrier
          - platform_opt_out
          - keyword_opt_out
          - api_opt_out
          - button_opt_out
        url:
          type: string
          description: A reference URL to the existing object, as a relative URL to the existing domain.
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic