---
updatedAt: 2026-07-24T18:24:08.000Z
agentTools:
  projectIndex: https://docs.conveyor.com/llms.txt
---

# GET Vendor Subscriptions

Lists all users who signed up for subprocessor change notifications on your Trust Center. These subscribers receive emails when subprocessors are added or removed from your vendor profile. Authentication: API key or OAuth.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "portal-api",
    "version": "2.0"
  },
  "servers": [
    {
      "url": "https://api.conveyor.com/api"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-KEY"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/v2/vendor_subscriptions ": {
      "get": {
        "operationId": "get_v2-vendor-subscriptions",
        "summary": "GET Vendor Subscriptions",
        "description": "Lists all users who signed up for subprocessor change notifications on your Trust Center. These subscribers receive emails when subprocessors are added or removed from your vendor profile. Authentication: API key or OAuth.",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "Page number. Default: 1.",
            "schema": {
              "type": "integer",
              "default": 1,
              "minimum": 1
            }
          },
          {
            "name": "per_page",
            "in": "query",
            "required": false,
            "description": "Results per page. Default: 25.",
            "schema": {
              "type": "integer",
              "default": 25,
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Paginated list of vendor subscriptions.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "vendor_subscriptions",
                    "page",
                    "per_page",
                    "total_pages"
                  ],
                  "properties": {
                    "vendor_subscriptions": {
                      "type": "array",
                      "description": "List of subscriber objects.",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "format": "uuid",
                            "description": "UUID of the subscription record."
                          },
                          "email": {
                            "type": "string",
                            "format": "email",
                            "nullable": true,
                            "description": "Subscriber's email address."
                          },
                          "name": {
                            "type": "string",
                            "nullable": true,
                            "description": "Subscriber's display name."
                          },
                          "subscribed_at": {
                            "type": "string",
                            "format": "date-time",
                            "description": "ISO 8601 datetime when the user subscribed."
                          }
                        }
                      }
                    },
                    "page": {
                      "type": "integer",
                      "description": "Current page."
                    },
                    "per_page": {
                      "type": "integer",
                      "description": "Results per page."
                    },
                    "total_pages": {
                      "type": "integer",
                      "description": "Total number of pages."
                    }
                  }
                },
                "examples": {
                  "Result": {
                    "value": {
                      "vendor_subscriptions": [
                        {
                          "id": "f024b9de-76bc-408d-b79c-4eeee9fbbe8f",
                          "email": "ivana.tso@conveyor.com",
                          "name": "Ivana Tso",
                          "subscribed_at": "2026-04-28T19:28:55.772Z"
                        },
                        {
                          "id": "5742efdd-e41b-4389-a454-f1b26c570230",
                          "email": "phillip.graham@conveyor.com",
                          "name": "Phillip Graham",
                          "subscribed_at": "2026-04-09T22:51:31.846Z"
                        }
                      ],
                      "page": 1,
                      "per_page": 25,
                      "total_pages": 1
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "No Trust Center found for the program.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "description": "Error message."
                    }
                  }
                },
                "examples": {
                  "No Trust Center found": {
                    "value": {
                      "error": "No trust center found for the program"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized: missing or invalid credentials.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "description": "Error message."
                    }
                  }
                },
                "examples": {
                  "Unauthorized": {
                    "value": {
                      "error": "Unauthorized"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Forbidden: insufficient permissions.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "description": "Error message."
                    }
                  }
                },
                "examples": {
                  "Forbidden": {
                    "value": {
                      "error": "Forbidden"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": false,
    "proxy-enabled": false
  },
  "x-readme-fauxas": true
}
```