--- updatedAt: 2026-07-28T19:33:42.000Z --- # (Beta) Get contacts for your organization Retrieves the contact list from a single organization. If you have an account that has multiple organizations, you would retrieve the contact list from the organization where you created the API token.

Token Permissions: [ iam_user:get ] # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "Platform", "description": "# REST API Concepts\n\nSolace PubSub+ Platform provides RESTful APIs that you can use to manage your data in PubSub+ Cloud. The REST APIs allow\nyou to model your event-driven architectures from your own client applications.\n\nThe following document describes the public REST APIs available for use. Please note that these APIs are in the Early\nAccess release stage and are available for testing and early user feedback. The APIs are subject to change until they\nare declared Generally Available.", "version": "2.2.2" }, "servers": [ { "url": "https://api.solace.cloud", "description": "Solace PubSub+ Cloud US EAST Region" }, { "url": "https://api.solacecloud.com.au", "description": "Solace PubSub+ Cloud AU Region" }, { "url": "https://api.solacecloud.eu", "description": "Solace PubSub+ Cloud EU Region" }, { "url": "https://api.solacecloud.sg", "description": "Solace PubSub+ Cloud SG Region" } ], "security": [ { "APIToken": [] } ], "tags": [ { "name": "Organization Contacts" } ], "paths": { "/api/v2/platform/contacts": { "get": { "tags": [ "Organization Contacts" ], "summary": "(Beta) Get contacts for your organization", "description": "Retrieves the contact list from a single organization. If you have an account that has multiple organizations, you would retrieve the contact list from the organization where you created the API token.

Token Permissions: [ iam_user:get ]", "operationId": "getMyContacts", "parameters": [ { "name": "contactType", "in": "query", "description": "The type of contact to filter by. The allowed contact types are: ", "required": false, "schema": { "type": "string", "default": "", "enum": [ "EXTERNAL_ALERTS", "EXTERNAL_NOTIFICATIONS" ] } } ], "responses": { "200": { "description": "OK.", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "Bad request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "additionalProperties": { "default": "" }, "default": "" }, "example": { "message": "Bad request.", "errorId": "618e2fb0-a198-4d9d-9219-13e51ef0ecec" } }, "*/*": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "additionalProperties": { "default": "" }, "default": "" }, "example": { "message": "An authentication error occurred.", "errorId": "618e2fb0-a198-4d9d-9219-13e51ef0ecec" } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "additionalProperties": { "default": "" }, "default": "" }, "example": { "message": "You do not have permissions to perform this operation.", "errorId": "618e2fb0-a198-4d9d-9219-13e51ef0ecec" } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "additionalProperties": { "default": "" }, "default": "" }, "example": { "message": "Could not find service 4o5kyf4x5504.", "errorId": "618e2fb0-a198-4d9d-9219-13e51ef0ecec" } } } }, "502": { "description": "Bad Gateway - Marketplace integration error.", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } } }, "components": { "schemas": { "Envelope": { "type": "object", "default": null, "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/OrganizationContact" } }, "meta": { "type": "object", "additionalProperties": {}, "default": "", "description": "

The metadata about the response, which can include:

" }, "included": { "type": "array", "items": {} } } }, "ErrorResponse": { "type": "object", "default": null, "properties": { "message": { "type": "string", "default": "", "description": "A user-friendly message that describes the error.", "example": "An error occurred." }, "errorId": { "type": "string", "default": "", "description": "The UUID (Universally Unique Identifier) that is logged with an appropriate stack trace for a WARN or ERROR log that allows support to better determine what cause the error.", "example": "123e4567-e89b-12d3-a456-426655440000" }, "meta": { "type": "object", "additionalProperties": {}, "default": "", "description": "The metadata about the error. This provides additional information about the error that occurred.", "example": "'object': { 'field': 'description' }" }, "validationDetails": { "type": "object", "additionalProperties": { "type": "array", "items": { "type": "string" } }, "default": "", "description": "When applicable, these are the details of issues with the fields provided for the REST call.", "example": "'name': ['Not unique']" } } }, "OrganizationContact": { "type": "object", "default": null, "properties": { "id": { "type": "string", "default": "", "description": "The unique identifier for the organization contact." }, "type": { "type": "string", "default": "", "description": "The type of object for informational purposes.", "readOnly": true }, "email": { "type": "string", "default": "", "description": "The email address of the organization contact." }, "contactType": { "type": "string", "default": "", "description": "The type of notification that is sent to the contact's email. The allowed contact types are: ", "enum": [ "INTERNAL", "EXTERNAL_ALERTS", "EXTERNAL_NOTIFICATIONS" ] } } } }, "securitySchemes": { "APIToken": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT" } } } } ```