---
title: "Get My Subscriptions"
url: "https://stage-api-docs.centraldispatch.com/apis/stage-event-api-1-0-0/versions/c1db9b9c-04c4-43e9-9e9c-fe74c2ca0f60/operations/getSubscriptionsMine"
---

> Full API specification: https://stage-api-docs.centraldispatch.com/apis/stage-event-api-1-0-0/versions/c1db9b9c-04c4-43e9-9e9c-fe74c2ca0f60.md

# Get My Subscriptions

`GET` `/subscriptions/mine`

Operation ID: `getSubscriptionsMine`

Get all subscriptions associated with the authenticated customer. #### 📝 Important Notes - Returns all active subscriptions for the customer in the Bearer token. - Includes webhook URLs and subscription rules for each subscription.

## Header parameters

- `Accept` (string, required) - The major version of the API to make a request against. This is a custom MIME type that contains `vnd.coxauto.v[#]+`. For example, to request a resource from version 1.x.x of an API, the Accept header should be set to `application/vnd.coxauto.v1+json`.

## Responses

- `200` - OK. Successful request.
- `401` - Unauthorized. Authentication failed or missing.
- `403` - Forbidden. The attempted action is not permitted.
- `429` - Too Many Requests. Rate limit exceeded.
- `500` - Error.
- `503` - Service Unavailable. Temporary service interruption.

## OpenAPI definition

```yaml
openapi: 3.0.1
info:
  title: Event API
  version: 1.0.0
servers:
  - url: https://event-api.centraldispatch.com
    description: Production server
paths:
  /subscriptions/mine:
    get:
      tags:
        - Subscription
      summary: Get My Subscriptions
      description: |-
        
        Get all subscriptions associated with the authenticated customer.

        #### 📝 Important Notes
        - Returns all active subscriptions for the customer in the Bearer token.
        - Includes webhook URLs and subscription rules for each subscription.
      operationId: getSubscriptionsMine
      parameters:
        - name: Accept
          in: header
          description: The major version of the API to make a request against. This is a
            custom MIME type that contains `vnd.coxauto.v[#]+`. For example, to
            request a resource from version 1.x.x of an API, the Accept header
            should be set to `application/vnd.coxauto.v1+json`.
          required: true
          schema:
            type: string
          example: application/vnd.coxauto.v1+json
      responses:
        "200":
          description: OK. Successful request.
          headers:
            Etag:
              description: Contains the current version of the resource and should be used for
                the `If-Match` header on updates.
              schema:
                type: string
              example: "8675300"
            X-CoxAuto-Media-Type:
              description: Contains the major version and format information.
              schema:
                type: string
              example: coxauto.v1; format=json
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/SubscriptionCollection"
        "401":
          description: Unauthorized. Authentication failed or missing.
        "403":
          description: Forbidden. The attempted action is not permitted.
        "429":
          description: Too Many Requests. Rate limit exceeded.
        "500":
          description: Error.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Errors"
        "503":
          description: Service Unavailable. Temporary service interruption.
      security:
        - Bearer: []
security:
  - Bearer: []
components:
  schemas:
    SubscriptionCollection:
      type: object
      properties:
        href:
          type: string
          description: The URL used to query the current collection of the resource.
          example: https://event-api.centraldispatch.com/subscriptions/mine
        count:
          type: integer
          description: The total count of resources in the collection.
          format: int32
          example: 23
        items:
          type: array
          items:
            $ref: "#/components/schemas/SubscriptionResponse"
          description: A collection of records.
      description: Details of subscriptions.
    Errors:
      type: object
      properties:
        errors:
          type: array
          items:
            $ref: "#/components/schemas/Error"
          description: A collection of errors.
          nullable: true
      description: An error occurred, and the request could not be completed.
    SubscriptionResponse:
      type: object
      properties:
        href:
          type: string
          description: The fully qualified URL of the subscription.
          example: https://event-api.centraldispatch.com/subscriptions/id/50b2863f-c75e-45cb-8d50-b5a975d67865
        subscriptionId:
          type: string
          description: The ID of the subscription.
          format: uuid
          example: 50b2863f-c75e-45cb-8d50-b5a975d67865
        callbackUrl:
          type: string
          description: A valid URL that you own, which will be used to receive event
            notifications from the Central Dispatch Event service.
          example: https://abc-trcking.net/webhook
        isEnabled:
          type: boolean
          description: Indicates whether the subscription is currently active.
          example: true
        subscriptionRules:
          $ref: "#/components/schemas/SubscriptionRules"
      description: Details of a subscription.
    Error:
      type: object
      properties:
        code:
          type: string
          description: The code used for the issue.
          nullable: true
          example: resource.issue_type
        message:
          type: string
          description: A detailed message.
          nullable: true
          example: The issue happened because something is wrong.
        property:
          type: string
          description: The property to which the issue is associated.
          nullable: true
          example: person
        properties:
          type: object
          additionalProperties:
            type: string
          description: Additional properties related to the issue.
          nullable: true
          example:
            firstName: D0nn@
            lastName: Sm!th
      description: Details of an error or issue.
    SubscriptionRules:
      required:
        - marketplaces
        - eventTypes
      type: object
      properties:
        marketplaces:
          type: array
          items:
            type: string
          description: A collection of Marketplaces to which the subscription applies. The
            caller must have access to all listed Marketplaces.
          example:
            - "10000"
        eventTypes:
          type: array
          items:
            type: string
          description: A collection of event types. Use the `Get Event Types` endpoint to
            retrieve valid values.
          example:
            - DispatchCreated
            - DispatchUpdated
            - DispatchAccepted
      description: Details of subscription rules.
  securitySchemes:
    Bearer:
      type: http
      scheme: Bearer
```