# List subscriptions

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /v1/subscriptions:
    get:
      summary: List subscriptions
      deprecated: false
      description: ''
      tags:
        - API Reference/Subscriptions
      parameters:
        - name: customer
          in: query
          description: The ID of the customer whose subscriptions will be retrieved.
          required: false
          schema:
            type: string
        - name: price
          in: query
          description: Filter for subscriptions that contain this recurring price ID.
          required: false
          schema:
            type: string
        - name: limit
          in: query
          description: >-
            A limit on the number of objects to be returned. Limit can range
            between 1 and 100, and the default is 10.
          required: false
          schema:
            type: integer
        - name: ending_before
          in: query
          description: >-
            A cursor for use in pagination. ending_before is an object ID that
            defines your place in the list.
          required: false
          schema:
            type: string
        - name: starting_after
          in: query
          description: >-
            A cursor for use in pagination. starting_after is an object ID that
            defines your place in the list.
          required: false
          schema:
            type: string
        - name: Accept
          in: header
          description: ''
          required: true
          example: application/json
          schema:
            type: string
        - name: Content-Type
          in: header
          description: ''
          required: true
          example: application/json
          schema:
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/List'
          headers: {}
          x-apifox-name: OK
      security:
        - basic: []
      x-apifox-folder: API Reference/Subscriptions
      x-apifox-status: developing
      x-run-in-apifox: https://app.apifox.com/web/project/1296482/apis/api-190594648-run
components:
  schemas:
    List:
      type: object
      properties:
        object:
          type: string
          default: '"list"'
        url:
          type: string
        has_more:
          type: boolean
        data:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              object:
                type: string
              api_version:
                type: 'null'
              application:
                type: 'null'
              created:
                type: integer
              description:
                type: string
              enabled_events:
                type: array
                items:
                  type: string
              livemode:
                type: boolean
              metadata:
                type: object
                properties: {}
                x-apifox-orders: []
                x-apifox-ignore-properties: []
              status:
                type: string
              url:
                type: string
            x-apifox-orders:
              - id
              - object
              - api_version
              - application
              - created
              - description
              - enabled_events
              - livemode
              - metadata
              - status
              - url
            x-apifox-ignore-properties: []
      x-apifox-orders:
        - object
        - url
        - has_more
        - data
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
  securitySchemes:
    basic:
      type: http
      scheme: basic
servers:
  - url: https://apitest.wooshpay.com
    description: 官网测试
security:
  - basic: []

```