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

# Batch get subscriptions

> Retrieve up to 100 subscriptions by their resource names or globally unique identifiers. Use `-` as the plan path parameter to retrieve subscriptions across plans in the same store. Subscriptions are returned in the requested order. The request fails with 404 if any subscription does not exist in the parent scope.



## OpenAPI

````yaml get /v1/stores/{store}/subscription-plans/{plan}/subscriptions:batchGet
openapi: 3.1.0
info:
  version: 1.0.0
  title: Confío public api
servers:
  - description: Production
    url: https://api.confiopagos.com
  - description: Development
    url: https://api.dev.confiopagos.com
security:
  - bearerAuth: []
paths:
  /v1/stores/{store}/subscription-plans/{plan}/subscriptions:batchGet:
    get:
      summary: Batch get subscriptions
      description: >-
        Retrieve up to 100 subscriptions by their resource names or globally
        unique identifiers. Use `-` as the plan path parameter to retrieve
        subscriptions across plans in the same store. Subscriptions are returned
        in the requested order. The request fails with 404 if any subscription
        does not exist in the parent scope.
      parameters:
        - schema:
            type: string
            example: 01G65Z755AFWAKHE12NY0CQ9FH
          required: true
          name: store
          in: path
        - schema:
            type: string
            description: >-
              The subscription plan identifier. Use `-` to retrieve
              subscriptions across plans in the store.
            example: '-'
          required: true
          description: >-
            The subscription plan identifier. Use `-` to retrieve subscriptions
            across plans in the store.
          name: plan
          in: path
        - schema:
            type: array
            items:
              type: string
              minLength: 1
            minItems: 1
            maxItems: 100
            description: >-
              Subscriptions to retrieve, each given by its resource name
              (`stores/{store}/subscription-plans/{plan}/subscriptions/{subscription}`)
              or its globally unique identifier. Repeat the parameter for each
              subscription, up to 100. Every subscription must belong to the
              store in the path and, unless the path uses
              `subscription-plans/-`, to the selected subscription plan.
            example:
              - >-
                stores/01G65Z755AFWAKHE12NY0CQ9FH/subscription-plans/01JNRVWWHH68E76V3TMFFT6GHJ/subscriptions/01JNRWE8M2Q7T8ZK3V9B1XA4CD
              - 01JNRWF3Y8B5C2D9E6F4G7H1JK
          required: true
          description: >-
            Subscriptions to retrieve, each given by its resource name
            (`stores/{store}/subscription-plans/{plan}/subscriptions/{subscription}`)
            or its globally unique identifier. Repeat the parameter for each
            subscription, up to 100. Every subscription must belong to the store
            in the path and, unless the path uses `subscription-plans/-`, to the
            selected subscription plan.
          name: names
          in: query
          style: form
          explode: true
      responses:
        '200':
          description: Successfully fetched subscriptions.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchGetSubscriptionsResponse'
components:
  schemas:
    BatchGetSubscriptionsResponse:
      type: object
      properties:
        subscriptions:
          type: array
          items:
            $ref: '#/components/schemas/Subscription'
          description: >-
            The requested subscriptions, in the same order as the `names` query
            parameters
      required:
        - subscriptions
    Subscription:
      type: object
      properties:
        name:
          type: string
          description: Subscription's resource name
          example: >-
            stores/01JNRRDZDPH40DB2YRW329BFXM/subscription-plans/01JNRVWWHH68E76V3TMFFT6GHJ/subscriptions/01JNRVWWHH68E76V3TMFFT6GHJ
        correlationId:
          type: string
          description: >-
            Your internal subscription/order ID, as provided when the
            subscription was created.
          example: '36285414'
        firstChargeAmountCents:
          type: number
          description: Optional first charge amount in cents (only for the first charge)
          example: 3000000
        redirectUri:
          type: string
          format: uri
          description: Optional redirect URI after subscription payment
          example: https://example.com/subscription-status
        status:
          type: string
          enum:
            - PENDING_ACCEPTANCE
            - ACTIVE
            - PROCESSING
            - TRIALING
            - PAST_DUE
            - CANCELED
            - EXPIRED
            - SUSPENDED
          description: Subscription status
          example: PENDING_ACCEPTANCE
        buyer:
          type: object
          properties:
            email:
              type: string
              format: email
              description: Buyer email address
              example: buyer@example.com
            phoneNumber:
              type: string
              description: Buyer phone number (E.164 format)
              example: '+573215786325'
            firstName:
              type: string
              description: Buyer first name
              example: Santiago
            lastName:
              type: string
              description: Buyer last name
              example: García
          required:
            - email
            - phoneNumber
            - firstName
            - lastName
          description: Buyer information
        acceptanceUrl:
          type: string
          description: >-
            URL for buyer to accept the subscription (only available when status
            is PENDING_ACCEPTANCE)
          example: https://checkout.confiopagos.com/s/abc123token
        acceptanceExpireTime:
          type: string
          description: >-
            Moment after which the subscription can no longer be accepted. Only
            meaningful while the status is PENDING_ACCEPTANCE.
          example: '2024-01-22T10:30:00Z'
        currentPeriodStart:
          type: string
          description: Start of current billing period
          example: '2024-01-15T10:30:00Z'
        currentPeriodEnd:
          type: string
          description: End of current billing period
          example: '2024-02-15T10:30:00Z'
        nextBillingTime:
          type: string
          description: Next billing date
          example: '2024-02-15T10:30:00Z'
        createTime:
          type: string
          description: Creation timestamp
          example: '2024-01-15T10:30:00Z'
      required:
        - name
        - status
        - buyer
        - createTime
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.