--- schema_version: "1" id: 1ac0b41bf6db4d57d6b3ddc0d0c562aba0eb988b04d4399fb47f80e3183e42de title: EventBusSubscriber collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_eventbussubscriber.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_eventbussubscriber.htm source_site: developer.salesforce.com content_type: documentation content_hash: fe91bf7586a9db29e6281dadf1509917cdcffab1eea8fb3e0cd68d1f503b6dce description: Represents a trigger, process, or flow that’s subscribed to a platform event or a change data capture event. Doesn’t include CometD or Pub/Sub API subscribers. --- # EventBusSubscriber Represents a trigger, process, or flow that’s subscribed to a platform event or a change data capture event. Doesn’t include CometD or Pub/Sub API subscribers. ## Supported Calls describeSObjects(), query() ## Special Access Rules EventBusSubscriber is read only and can only be queried. As of Summer ’20 and later, only your Salesforce org's internal users can access this object. ## Fields | Field | Details | | --- | --- | | ExternalId | Type string Properties Filter, Group, Nillable, Sort Description The ID of the subscriber. For example, the trigger ID. | | IsPartitioned | Type boolean Properties Defaulted on create, Filter, Group, Sort Description Indicates whether the platform event Apex trigger is configured with parallel subscriptions (true) or not (false). The default value is false. See [Platform Event Processing at Scale with Parallel Subscriptions for Apex Triggers](https://developer.salesforce.com/docs/atlas.en-us.264.0.platform_events.meta/platform_events/platform_events_ps.htm) in the Platform Events Developer Guide. This field is available in API version 62.0 and later. | | LastError | Type string Properties Filter, Group, Nillable, Sort Description The error message that the last thrown EventBus.RetryableException contains. This field applies to Apex triggers only. Available in API version 43.0 and later. | | LastProcessed | Type string Properties Filter, Group, Nillable, Sort Description The replay ID of the last event that the subscriber processed. This field replaces Position as of API level 66.0. | | LastPublished | Type string Properties Filter, Group, Nillable, Sort Description The replay ID of the last published event. This field replaces Tip as of API level 66.0. ![Note](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/images/icon_note.png) #### Note For high-volume platform events and change events, the value for Tip isn’t available and is always -1. | | Name | Type string Properties Filter, Group, Nillable, Sort Description The name of the subscribed item, such as the trigger or process name. If the subscribed item’s name is “Process”, at least one flow Pause element is subscribed to the event. | | Position | Type int Properties Filter, Group, Nillable, Sort Description The replay ID of the last event that the subscriber processed. This field has been deprecated as of API level 66.0 and should no longer be used. Use LastProcessed instead. This field may not be properly represented if the value exceeds the maximum integer size. | | Retries | Type int Properties Filter, Group, Nillable, Sort Description The number of times the trigger was retried due to throwing the EventBus.RetryableException. This field applies to Apex triggers only. Available in API version 43.0 and later. | | Status | Type picklist Properties Filter, Group, Nillable, Restricted picklist, Sort Description Indicates the status of the subscriber. Can be one of these values: - Error— The subscriber was disconnected and stopped receiving published events. A trigger reaches this state when it exceeds the number of maximum retries with the EventBus.RetryableException. Trigger assertion failures and unhandled exceptions don’t cause the error state. We recommend limiting the retries to fewer than nine times to avoid reaching this state. When you fix and save the trigger, or for a managed package trigger, if you redeploy the package, the trigger resumes automatically from the tip, starting from new events. Also, you can resume a trigger subscription in the subscription detail page that you access from the platform event page. - Repartitioning—The system is in the process of modifying the trigger's parallel subscription configuration. - Running—The subscriber is actively listening to events. If you modify the subscriber, the subscription continues to process events. - Suspended—The subscriber is disconnected and can’t receive events because a Salesforce admin suspended it or due to an internal error. You can resume a trigger subscription in the subscription detail page that you access from the platform event page. To resume a process, deactivate it and then reactivate it. If you modify the subscriber, the subscription resumes automatically from the tip, starting from new events. For more information, see [View and Manage an Event’s Subscribers on the Platform Event’s Detail Page](https://developer.salesforce.com/docs/atlas.en-us.264.0.platform_events.meta/platform_events/platform_events_get_subscribers_apex.htm "HTML (New Window)") in the Platform Events Developer Guide. | | Tip | Type int Properties Filter, Group, Nillable, Sort Description The replay ID of the last published event. This field has been deprecated as of API level 66.0 and should no longer be used. Use LastPublished instead. This field may not be properly represented if the value exceeds the maximum integer size. ![Note](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/images/icon_note.png) #### Note For high-volume platform events and change events, the value for Tip isn’t available and is always -1. | | Topic | Type string Properties Filter, Group, Nillable, Sort Description The name of the subscription channel that corresponds to a platform event or change event. For a platform event, the topic name is the event name appended with \_\_e, such as MyEvent\_\_e. For a change event, the topic is the name of the change event, such as AccountChangeEvent. | | Type | Type string Properties Filter, Group, Nillable, Sort Description The subscriber type (ApexTrigger). If the subscriber is a process or flow Pause element, the type is blank. | ## Usage Use EventBusSubscriber to query details about subscribers to a platform event. You can get all subscribers for a particular event by filtering on the Topic field, as follows. SELECT ExternalId, Name, Position, Status, Tip, Type FROM EventBusSubscriber WHERE Topic='Low\_Ink\_\_e'