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

# 워크스페이스 구독 조회

> 워크스페이스(`organization_id`)의 현재 구독과 요금제 단가(KRW), 과금 단위(초), 통화 한도를 조회합니다. 상위 워크스페이스 키로만 호출할 수 있으며, 본인 워크스페이스나 직속 하위 워크스페이스를 조회할 수 있습니다. 직속 하위 워크스페이스를 조회하면 상위 워크스페이스의 요금제가 반환되고 `subscription_organization_id`는 상위 워크스페이스 ID입니다. 하위 워크스페이스 키로 호출하면 어떤 `organization_id`든 403 `FORBIDDEN`을 반환합니다. 하위 워크스페이스는 통화 한도를 `GET /organizations/{organization_id}/concurrency`에서 조회합니다. 날짜는 YYYY-MM-DD 형식이며, 기한이 없는 구독은 `end_date`가 `null`입니다. 활성 구독이 없으면 `NO_ACTIVE_SUBSCRIPTION`을 반환합니다.



## OpenAPI

````yaml /api-reference/v3/openapi.json get /organizations/{organization_id}/subscription
openapi: 3.1.0
info:
  title: vox.ai API
  description: >
    vox.ai API v3


    ### v3 공개 계약 규칙


    - 인증은 `Authorization: Bearer <token>` 헤더를 사용합니다. 워크스페이스 API 키를 Bearer 토큰으로
    전달합니다.

    - 요청과 응답 필드는 기본적으로 `snake_case`를 사용합니다.

    - `agent.data`는 에이전트 레지스트리와 호환되어야 하므로 `callSettings`, `toolIds`,
    `builtInTools`, `presetDynamicVariables` 같은 camelCase 필드를 유지합니다.

    - `_at`으로 끝나는 타임스탬프는 unix milliseconds입니다. 일부 입력값은 호환성을 위해 10~11자리 unix
    seconds도 허용하고 milliseconds로 정규화합니다.

    - 대량 발신 통화 가능 시간은 분 단위 정수(`start_min` / `end_min`)를 사용합니다. 알림 스케줄은 `HH:MM`
    문자열(`start_time` / `end_time`)을 사용합니다.

    - 응답 객체 자신의 식별자는 `id`입니다. 다른 리소스를 참조하는 필드와 path parameter는 `agent_id`,
    `call_id`, `telephone_line_id`처럼 명시적인 이름을 사용합니다.

    - 실패 응답은 `{ "error": { "code", "message", "details" } }` 형태입니다. 가능한 경우
    `details.field`, `details.reason`, `details.allowed_values`를 함께 제공합니다.
  version: 3.0.0
servers:
  - url: https://client-api.tryvox.co/v3
    description: 운영
security: []
paths:
  /organizations/{organization_id}/subscription:
    get:
      tags:
        - Organizations
      summary: 워크스페이스 구독 조회
      description: >-
        워크스페이스(`organization_id`)의 현재 구독과 요금제 단가(KRW), 과금 단위(초), 통화 한도를 조회합니다.
        상위 워크스페이스 키로만 호출할 수 있으며, 본인 워크스페이스나 직속 하위 워크스페이스를 조회할 수 있습니다. 직속 하위
        워크스페이스를 조회하면 상위 워크스페이스의 요금제가 반환되고 `subscription_organization_id`는 상위
        워크스페이스 ID입니다. 하위 워크스페이스 키로 호출하면 어떤 `organization_id`든 403 `FORBIDDEN`을
        반환합니다. 하위 워크스페이스는 통화 한도를 `GET
        /organizations/{organization_id}/concurrency`에서 조회합니다. 날짜는 YYYY-MM-DD
        형식이며, 기한이 없는 구독은 `end_date`가 `null`입니다. 활성 구독이 없으면
        `NO_ACTIVE_SUBSCRIPTION`을 반환합니다.
      operationId: getOrganizationSubscription
      parameters:
        - name: organization_id
          in: path
          required: true
          schema:
            type: string
            description: 조회할 워크스페이스 ID입니다(본인 또는 직속 하위 워크스페이스).
            title: Organization Id
          description: 조회할 워크스페이스 ID입니다(본인 또는 직속 하위 워크스페이스).
      responses:
        '200':
          description: 성공 응답
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SubscriptionResponse'
        '400':
          description: 요청 검증 오류
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                validationError:
                  summary: 요청 검증 오류
                  value:
                    error:
                      code: VALIDATION_ERROR
                      message: Request validation failed.
                      details:
                        field: name
                        reason: must not be blank
                NO_ACTIVE_SUBSCRIPTION:
                  summary: 활성 구독 없음
                  value:
                    error:
                      code: NO_ACTIVE_SUBSCRIPTION
                      message: 활성 구독이 없습니다.
                      details:
                        organization_id: 11111111-1111-1111-1111-111111111111
        '401':
          description: 인증이 필요합니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                unauthorized:
                  summary: Bearer 토큰 누락 또는 오류
                  value:
                    error:
                      code: UNAUTHORIZED
                      message: Authentication is required.
                      details: {}
        '403':
          description: 권한이 없습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                forbidden:
                  summary: 권한이 없습니다.
                  value:
                    error:
                      code: FORBIDDEN
                      message: Permission denied.
                      details: {}
        '404':
          description: 리소스를 찾을 수 없습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                notFound:
                  summary: 리소스를 찾을 수 없습니다.
                  value:
                    error:
                      code: RESOURCE_NOT_FOUND
                      message: Resource not found.
                      details:
                        resource: agent
        '409':
          description: 충돌이 발생했습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                conflict:
                  summary: 상태 충돌이 발생했습니다.
                  value:
                    error:
                      code: CONFLICT
                      message: The requested operation conflicts with current state.
                      details:
                        current_status: draft
        '429':
          description: >-
            요청 한도를 초과했습니다. API 키 트래픽은 기본값으로 워크스페이스당 초당 5회·분당 120회, Supabase JWT
            트래픽은 기본값으로 사용자당 초당 10회·분당 240회로 제한되며, 워크스페이스 대시보드에는 기본 분당 2,400회의
            백스톱 한도가 적용됩니다. 한도는 운영자가 조정할 수 있고, 초과한 버킷의 실제 한도와 윈도우는 429 응답의
            X-RateLimit-Limit·X-RateLimit-Window 헤더로 알려 줍니다. 개별 경로 자체 리미터가 만든
            429 응답에는 이 헤더가 없을 수 있습니다.
          headers:
            Retry-After:
              description: >-
                초과한 공용 v3 인증 주체(auth-principal) 리미터 윈도우가 초기화될 때까지 남은 시간입니다. 단위는
                초입니다. 개별 경로 자체 리미터가 만든 429 응답에는 이 헤더가 없을 수 있습니다.
              schema:
                type: integer
                minimum: 1
            X-RateLimit-Limit:
              description: >-
                초과한 공용 v3 인증 주체(auth-principal) 리미터 윈도우의 최대 요청 수입니다. 개별 경로 자체
                리미터가 만든 429 응답에는 이 헤더가 없을 수 있습니다.
              schema:
                type: integer
                minimum: 1
            X-RateLimit-Window:
              description: >-
                초과한 공용 v3 인증 주체(auth-principal) 리미터 윈도우의 길이입니다. 단위는 초입니다. 개별 경로
                자체 리미터가 만든 429 응답에는 이 헤더가 없을 수 있습니다.
              schema:
                type: integer
                minimum: 1
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                rateLimited:
                  summary: 요청 한도를 초과했습니다.
                  value:
                    error:
                      code: RATE_LIMIT_EXCEEDED
                      message: Too many requests.
                      details:
                        limit: 10
                        window_seconds: 1
                        scope: user
        '500':
          description: 서버 내부 오류가 발생했습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                internalError:
                  summary: 서버 내부 오류가 발생했습니다.
                  value:
                    error:
                      code: INTERNAL_ERROR
                      message: Internal server error.
                      details: {}
        '503':
          description: 서비스를 일시적으로 사용할 수 없습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                serviceUnavailable:
                  summary: 서비스를 일시적으로 사용할 수 없습니다.
                  value:
                    error:
                      code: SERVICE_UNAVAILABLE
                      message: Service temporarily unavailable.
                      details: {}
      security:
        - BearerAuth: []
components:
  schemas:
    SubscriptionResponse:
      properties:
        display_name:
          type: string
          title: Display Name
          description: 요금제 표시 이름입니다.
        organization_id:
          type: string
          title: Organization Id
          description: 조회한 워크스페이스 ID입니다.
        subscription_organization_id:
          type: string
          title: Subscription Organization Id
          description: 구독을 보유한 워크스페이스 ID입니다. 하위 워크스페이스를 조회하면 상위 워크스페이스 ID입니다.
        start_date:
          type: string
          title: Start Date
          description: 현재 구독 기간 시작일입니다(YYYY-MM-DD).
        end_date:
          anyOf:
            - type: string
            - type: 'null'
          title: End Date
          description: 현재 구독 기간 종료일입니다(YYYY-MM-DD). 기한이 없으면 `null`입니다.
        plan_monthly_fee_decimal:
          type: string
          title: Plan Monthly Fee Decimal
          description: 월 구독료입니다(KRW 원 단위, Decimal 문자열).
        plan_monthly_credit_allowance_decimal:
          type: string
          title: Plan Monthly Credit Allowance Decimal
          description: 매월 제공되는 크레딧 금액입니다(KRW 원 단위, Decimal 문자열).
        plan_agent_fee_rate_decimal:
          type: string
          title: Plan Agent Fee Rate Decimal
          description: >-
            AI 통화 요금입니다. `plan_agent_fee_increment`초마다 붙는 금액입니다(KRW 원 단위,
            Decimal 문자열). 요금제에 따라 모델 사용료가 따로 붙을 수 있습니다.
        plan_agent_fee_increment:
          type: integer
          title: Plan Agent Fee Increment
          description: AI 통화 요금의 과금 단위입니다(초). 통화 시간을 이 단위로 올림합니다.
        plan_transfer_fee_rate_decimal:
          type: string
          title: Plan Transfer Fee Rate Decimal
          description: >-
            통화 전환 요금입니다. `plan_transfer_fee_increment`초마다 붙는 금액입니다(KRW 원 단위,
            Decimal 문자열).
        plan_transfer_fee_increment:
          type: integer
          title: Plan Transfer Fee Increment
          description: 통화 전환 요금의 과금 단위입니다(초). 통화 시간을 이 단위로 올림합니다.
        plan_telephony_mobile_fee_rate_decimal:
          type: string
          title: Plan Telephony Mobile Fee Rate Decimal
          description: >-
            휴대전화 통신료입니다. `plan_telephony_mobile_fee_increment`초마다 붙는 금액입니다(KRW 원
            단위, Decimal 문자열).
        plan_telephony_mobile_fee_increment:
          type: integer
          title: Plan Telephony Mobile Fee Increment
          description: 휴대전화 통신료의 과금 단위입니다(초). 통화 시간을 이 단위로 올림합니다.
        plan_telephony_landline_fee_rate_decimal:
          type: string
          title: Plan Telephony Landline Fee Rate Decimal
          description: >-
            유선전화 통신료입니다. `plan_telephony_landline_fee_increment`초마다 붙는 금액입니다(KRW
            원 단위, Decimal 문자열).
        plan_telephony_landline_fee_increment:
          type: integer
          title: Plan Telephony Landline Fee Increment
          description: 유선전화 통신료의 과금 단위입니다(초). 통화 시간을 이 단위로 올림합니다.
        plan_telephony_voip_fee_rate_decimal:
          type: string
          title: Plan Telephony Voip Fee Rate Decimal
          description: >-
            인터넷전화 통신료입니다. `plan_telephony_voip_fee_increment`초마다 붙는 금액입니다(KRW 원
            단위, Decimal 문자열).
        plan_telephony_voip_fee_increment:
          type: integer
          title: Plan Telephony Voip Fee Increment
          description: 인터넷전화 통신료의 과금 단위입니다(초). 통화 시간을 이 단위로 올림합니다.
        plan_telephony_uan_fee_rate_decimal:
          type: string
          title: Plan Telephony Uan Fee Rate Decimal
          description: >-
            대표번호 통신료입니다. `plan_telephony_uan_fee_increment`초마다 붙는 금액입니다(KRW 원
            단위, Decimal 문자열).
        plan_telephony_uan_fee_increment:
          type: integer
          title: Plan Telephony Uan Fee Increment
          description: 대표번호 통신료의 과금 단위입니다(초). 통화 시간을 이 단위로 올림합니다.
        plan_telephony_personal_fee_rate_decimal:
          type: string
          title: Plan Telephony Personal Fee Rate Decimal
          description: >-
            개인번호 통신료입니다. `plan_telephony_personal_fee_increment`초마다 붙는 금액입니다(KRW
            원 단위, Decimal 문자열).
        plan_telephony_personal_fee_increment:
          type: integer
          title: Plan Telephony Personal Fee Increment
          description: 개인번호 통신료의 과금 단위입니다(초). 통화 시간을 이 단위로 올림합니다.
        plan_telephony_toll_free_fee_rate_decimal:
          type: string
          title: Plan Telephony Toll Free Fee Rate Decimal
          description: >-
            수신자부담 통신료입니다. `plan_telephony_toll_free_fee_increment`초마다 붙는
            금액입니다(KRW 원 단위, Decimal 문자열).
        plan_telephony_toll_free_fee_increment:
          type: integer
          title: Plan Telephony Toll Free Fee Increment
          description: 수신자부담 통신료의 과금 단위입니다(초). 통화 시간을 이 단위로 올림합니다.
        plan_outbound_minimum_fee_decimal:
          type: string
          title: Plan Outbound Minimum Fee Decimal
          description: 발신 통화 1건의 최소 기본료입니다(KRW 원 단위, Decimal 문자열).
        plan_voicemail_fee_decimal:
          type: string
          title: Plan Voicemail Fee Decimal
          description: 음성사서함으로 연결된 발신 통화 1건의 기본료입니다(KRW 원 단위, Decimal 문자열).
        plan_failed_call_fee_decimal:
          type: string
          title: Plan Failed Call Fee Decimal
          description: 연결에 실패한 발신 통화 1건의 기본료입니다(KRW 원 단위, Decimal 문자열).
        plan_chat_send_fee_decimal:
          type: string
          title: Plan Chat Send Fee Decimal
          description: >-
            AI 채팅 답변 1건의 기본료입니다(KRW 원 단위, Decimal 문자열). 요금제에 따라 모델 사용료가 따로 붙을 수
            있습니다.
        plan_chat_room_fee_decimal:
          type: string
          title: Plan Chat Room Fee Decimal
          description: 카카오 상담톡 활성방 1개의 요금입니다(KRW 원 단위, Decimal 문자열).
        plan_unit_test_fee_decimal:
          type: string
          title: Plan Unit Test Fee Decimal
          description: 유닛 테스트 실행 1건의 기본료입니다(KRW 원 단위, Decimal 문자열).
        plan_scenario_test_fee_decimal:
          type: string
          title: Plan Scenario Test Fee Decimal
          description: 시나리오 테스트에서 에이전트 응답 1개마다 붙는 기본료입니다(KRW 원 단위, Decimal 문자열).
        plan_sms_send_text_fee_decimal:
          type: string
          title: Plan Sms Send Text Fee Decimal
          description: SMS 단문 발신 건당 요금입니다(KRW 원 단위, Decimal 문자열).
        plan_sms_send_lms_fee_decimal:
          type: string
          title: Plan Sms Send Lms Fee Decimal
          description: LMS(장문) 발신 건당 요금입니다(KRW 원 단위, Decimal 문자열).
        plan_sms_send_mms_fee_decimal:
          type: string
          title: Plan Sms Send Mms Fee Decimal
          description: MMS 발신 건당 요금입니다(KRW 원 단위, Decimal 문자열).
        plan_sms_recv_fee_decimal:
          type: string
          title: Plan Sms Recv Fee Decimal
          description: SMS 수신 건당 요금입니다(KRW 원 단위, Decimal 문자열).
        plan_concurrent_call_limit:
          anyOf:
            - type: integer
            - type: 'null'
          title: Plan Concurrent Call Limit
          description: 동시 통화 한도입니다. `null`이면 무제한입니다.
        plan_hourly_call_limit:
          anyOf:
            - type: integer
            - type: 'null'
          title: Plan Hourly Call Limit
          description: 시간당 통화 한도입니다. `null`이면 무제한입니다.
        plan_daily_call_limit:
          anyOf:
            - type: integer
            - type: 'null'
          title: Plan Daily Call Limit
          description: 일일 통화 한도입니다. `null`이면 무제한입니다.
      type: object
      required:
        - display_name
        - organization_id
        - subscription_organization_id
        - start_date
        - plan_monthly_fee_decimal
        - plan_monthly_credit_allowance_decimal
        - plan_agent_fee_rate_decimal
        - plan_agent_fee_increment
        - plan_transfer_fee_rate_decimal
        - plan_transfer_fee_increment
        - plan_telephony_mobile_fee_rate_decimal
        - plan_telephony_mobile_fee_increment
        - plan_telephony_landline_fee_rate_decimal
        - plan_telephony_landline_fee_increment
        - plan_telephony_voip_fee_rate_decimal
        - plan_telephony_voip_fee_increment
        - plan_telephony_uan_fee_rate_decimal
        - plan_telephony_uan_fee_increment
        - plan_telephony_personal_fee_rate_decimal
        - plan_telephony_personal_fee_increment
        - plan_telephony_toll_free_fee_rate_decimal
        - plan_telephony_toll_free_fee_increment
        - plan_outbound_minimum_fee_decimal
        - plan_voicemail_fee_decimal
        - plan_failed_call_fee_decimal
        - plan_chat_send_fee_decimal
        - plan_chat_room_fee_decimal
        - plan_unit_test_fee_decimal
        - plan_scenario_test_fee_decimal
        - plan_sms_send_text_fee_decimal
        - plan_sms_send_lms_fee_decimal
        - plan_sms_send_mms_fee_decimal
        - plan_sms_recv_fee_decimal
      title: SubscriptionResponse
      description: 워크스페이스 구독 조회 응답입니다. 워크스페이스 조회 응답의 `subscription`과 같은 필드를 제공합니다.
    ErrorResponse:
      type: object
      required:
        - error
      title: ErrorResponse
      description: 모든 실패 응답에서 사용하는 v3 error envelope입니다.
      examples:
        - error:
            code: VALIDATION_ERROR
            message: Request validation failed.
            details:
              field: name
              reason: must not be blank
      properties:
        error:
          $ref: '#/components/schemas/ErrorDetail'
          description: 오류 payload입니다.
    ErrorDetail:
      type: object
      required:
        - code
        - message
        - details
      title: ErrorDetail
      description: 기계가 읽을 수 있는 v3 오류 상세 정보입니다.
      examples:
        - code: VALIDATION_ERROR
          message: Request validation failed.
          details:
            field: name
            reason: must not be blank
      properties:
        code:
          type: string
          title: Code
          description: 기계가 읽을 수 있는 오류 code입니다. message parsing 대신 이 값을 사용합니다.
          examples:
            - VALIDATION_ERROR
        message:
          type: string
          title: Message
          description: 사용자에게 표시할 수 있는 오류 메시지입니다. 프로그램 처리는 `code`를 사용합니다.
          examples:
            - Request validation failed.
        details:
          type: object
          title: Details
          additionalProperties: true
          description: 구조화된 context입니다. 주로 `field`, `reason`, `allowed_values`를 포함합니다.
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Organization API key
      description: '워크스페이스 API 키를 `Authorization: Bearer <token>` 형식으로 보냅니다.'

````

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