> ## Documentation Index
> Fetch the complete documentation index at: https://omniflow-vpn.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get v1accountsubscriptions



## OpenAPI

````yaml https://raw.githubusercontent.com/kewldan/omniflow/main/api/openapi.yaml get /v1/account/subscriptions/{subscriptionID}
openapi: 3.0.3
info:
  title: Omniflow API
  version: 1.0.0
  description: >-
    Customer, commerce, payment, wallet, fulfillment, and operations API for
    Omniflow.
servers: []
security: []
paths:
  /v1/account/subscriptions/{subscriptionID}:
    get:
      tags:
        - account
      operationId: getAccountSubscription
      parameters:
        - $ref: '#/components/parameters/AccountSubscriptionID'
        - in: query
          name: locale
          schema:
            type: string
            enum:
              - ru
              - en
      responses:
        '200':
          description: Subscription
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountSubscription'
        '404':
          $ref: '#/components/responses/Problem'
components:
  parameters:
    AccountSubscriptionID:
      in: path
      name: subscriptionID
      required: true
      schema:
        type: string
        format: uuid
  schemas:
    AccountSubscription:
      type: object
      required:
        - id
        - slot
        - label
        - plan
        - phase
        - daysLeft
        - provisioned
        - live
        - traffic
        - devices
      properties:
        id:
          type: string
          format: uuid
        slot:
          type: integer
        label:
          type: string
        plan:
          type: string
        phase:
          type: string
          enum:
            - none
            - provisioning
            - active
            - expiring_soon
            - grace
            - limited
            - disabled
            - expired
            - failed
        endsAt:
          type: string
          format: date-time
        daysLeft:
          type: integer
        provisioned:
          type: boolean
        live:
          type: boolean
          description: >-
            The traffic and device figures were read from Remnawave. When false
            they are the last observed values and the panel says so.
        traffic:
          $ref: '#/components/schemas/AccountTraffic'
        devices:
          $ref: '#/components/schemas/AccountDeviceUsage'
        pendingOrderId:
          type: string
          format: uuid
          description: >-
            The unpaid order that opened this subscription, present only while
            no entitlement has been provisioned. The panel renders the card as
            "payment pending" with a way to the order rather than as a
            subscription that is not active.
    AccountTraffic:
      type: object
      required:
        - usedBytes
        - unlimited
        - percent
      properties:
        usedBytes:
          type: integer
          format: int64
        limitBytes:
          type: integer
          format: int64
          nullable: true
        unlimited:
          type: boolean
        percent:
          type: integer
          minimum: 0
          maximum: 100
          description: >-
            Computed on the server and clamped, so the bar and its textual
            equivalent cannot disagree. Meaningless when unlimited.
    AccountDeviceUsage:
      type: object
      required:
        - used
        - unlimited
      properties:
        used:
          type: integer
        limit:
          type: integer
          nullable: true
        unlimited:
          type: boolean
    Problem:
      type: object
      required:
        - type
        - title
        - status
      properties:
        type:
          type: string
          format: uri
        title:
          type: string
        status:
          type: integer
        detail:
          type: string
        request_id:
          type: string
  responses:
    Problem:
      description: Request failed
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'

````

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