> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pingintel.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List MudMap subscriptions

> List carrier subscriptions (placed/tentative participations) on a MudMap.



## OpenAPI

````yaml https://vision.staging.pingintel.com/api/schema/?format=json get /api/v1/mudmap/{mudmap_mudmapid}/subscription
openapi: 3.0.3
info:
  title: Ping.Vision API
  version: v1.0
  description: >
    ### Ping.Vision API


    This API provides convenient, efficient access to Ping Intel's data and
    services. It is designed to be used by developers and data scientists to
    integrate Ping Intel's capabilities into their applications.


    Once SSO is set up with your organization, you can create an Organization or
    Personal API key at https://auth.pingintel.com/org.


    Please see the Python client library
    [pingintel-api](https://pypi.org/project/pingintel-api/) for commandline
    tools and programmatic access, and you

    can refer to the following documentation for details on interacting with the
    system via the HTTP API.
  contact:
    email: support@pingintel.com
    name: Ping Intel
    url: https://www.pingintel.com
servers:
  - url: https://vision.pingintel.com
    description: Ping.Vision API
  - url: https://vision.staging.pingintel.com
    description: Ping.Vision API (staging)
security: []
tags:
  - name: Create Submission
    description: The Create Submission API allows you to add new data into the system.
  - name: Update Submission
    description: >-
      The Update Submission API provides various endpoints to update, modify, or
      act upon existing submissions.
  - name: Get Submission Data
    description: ''
  - name: User Memberships
    description: >-
      The User Memberships API allows you to add, remove, and change the role of
      users in different teams, divisions, or companies.
  - name: Miscellaneous
    description: ''
paths:
  /api/v1/mudmap/{mudmap_mudmapid}/subscription:
    get:
      tags:
        - MudMap
      summary: List MudMap subscriptions
      description: >-
        List carrier subscriptions (placed/tentative participations) on a
        MudMap.
      operationId: api_v1_mudmap_subscription_list
      parameters:
        - in: path
          name: mudmap_mudmapid
          schema:
            type: string
            pattern: ^mm-[a-zA-Z0-9-]+$
          required: true
        - name: limit
          required: false
          in: query
          description: Number of results to return per page.
          schema:
            type: integer
        - name: offset
          required: false
          in: query
          description: The initial index from which to return the results.
          schema:
            type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedMudmapSubscriptionList'
          description: ''
      security:
        - authorization_header: []
components:
  schemas:
    PaginatedMudmapSubscriptionList:
      type: object
      required:
        - count
        - results
      properties:
        count:
          type: integer
          example: 123
        results:
          type: array
          items:
            $ref: '#/components/schemas/MudmapSubscription'
        next:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?offset=400&limit=100
        previous:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?offset=200&limit=100
    MudmapSubscription:
      type: object
      properties:
        created_time:
          type: string
          format: date-time
          readOnly: true
        layer_attachment:
          type: string
          format: decimal
          pattern: ^-?\d{0,18}(?:\.\d{0,2})?$
        layer_limit:
          type: string
          format: decimal
          pattern: ^-?\d{0,18}(?:\.\d{0,2})?$
        layer_participation_amount:
          type: string
          format: decimal
          pattern: ^-?\d{0,18}(?:\.\d{0,2})?$
        status:
          enum:
            - SENT_TO_UW
            - QUOTED
            - BOUND
            - DECLINED
            - INDICATION
            - PENDING
          type: string
          description: |-
            * `SENT_TO_UW` - Sent to UW
            * `QUOTED` - Quoted
            * `BOUND` - Bound
            * `DECLINED` - Declined
            * `INDICATION` - Indication
            * `PENDING` - Pending
          x-spec-enum-id: 0263b2c97ec7701b
        updated_time:
          type: string
          format: date-time
          readOnly: true
        uuid:
          type: string
          format: uuid
          readOnly: true
          nullable: true
        notes:
          type: string
        premium:
          type: string
          format: decimal
          pattern: ^-?\d{0,18}(?:\.\d{0,2})?$
          nullable: true
        terms_notes:
          type: string
          nullable: true
        uw_company:
          type: string
          nullable: true
        uw_division:
          type: string
          nullable: true
        uw_email:
          type: string
          format: email
          nullable: true
          maxLength: 254
        uw_name:
          type: string
          nullable: true
          maxLength: 255
        uw_pingid:
          type: string
          nullable: true
          maxLength: 100
        uw_submission:
          type: string
          nullable: true
          description: >-
            User-facing submission identifier, always prefixed with p- (e.g.
            p-xy-abc-xyz1234). Groups all SOVs received together (e.g. from one
            email). Primary key for submissions in Ping.Vision.
        uw_user:
          type: integer
          nullable: true
      required:
        - created_time
        - layer_attachment
        - layer_limit
        - layer_participation_amount
        - status
        - updated_time
        - uuid
  securitySchemes:
    authorization_header:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        Supports `Token `-prefixed API keys and `Bearer `-prefixed JWT-based
        authentication.

````