# Get Available Placement Test Credits

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /v2/placement-tests/available-slots:
    get:
      summary: Get Available Placement Test Credits
      deprecated: false
      description: >-
        Retrieve information about available placement test credits (slots)
        across all active subscriptions. Returns total available credits, used
        credits, and breakdown by subscription.
      tags:
        - placement test
      parameters:
        - name: x-auth-zapmail
          in: header
          description: ''
          required: true
          example: ''
          schema:
            type: string
        - name: x-workspace-key
          in: header
          description: ''
          required: false
          example: ''
          schema:
            type: string
        - name: x-service-provider
          in: header
          description: ''
          required: false
          example: ''
          schema:
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                  message:
                    type: string
                  data:
                    type: object
                    properties:
                      totalAvailableCredits:
                        type: integer
                      totalUsedCredits:
                        type: integer
                      totalMonthlyCredits:
                        type: integer
                      subscriptions:
                        type: array
                        items:
                          type: object
                          properties:
                            subscriptionId:
                              type: string
                            planType:
                              type: string
                            billingCycle:
                              type: string
                            monthlyCredits:
                              type: integer
                            usedCredits:
                              type: integer
                            availableCredits:
                              type: integer
                            periodStart:
                              type: string
                            periodEnd:
                              type: string
                            status:
                              type: string
                          required:
                            - subscriptionId
                            - planType
                            - billingCycle
                            - monthlyCredits
                            - usedCredits
                            - availableCredits
                            - periodStart
                            - periodEnd
                            - status
                          x-apidog-orders:
                            - subscriptionId
                            - planType
                            - billingCycle
                            - monthlyCredits
                            - usedCredits
                            - availableCredits
                            - periodStart
                            - periodEnd
                            - status
                      nextResetDate:
                        type: string
                    required:
                      - totalAvailableCredits
                      - totalUsedCredits
                      - totalMonthlyCredits
                      - subscriptions
                      - nextResetDate
                    x-apidog-orders:
                      - totalAvailableCredits
                      - totalUsedCredits
                      - totalMonthlyCredits
                      - subscriptions
                      - nextResetDate
                required:
                  - status
                  - message
                  - data
                x-apidog-orders:
                  - status
                  - message
                  - data
              example:
                status: 200
                message: Available credits retrieved successfully
                data:
                  totalAvailableCredits: 150
                  totalUsedCredits: 80
                  totalMonthlyCredits: 230
                  subscriptions:
                    - subscriptionId: sub_abc123
                      planType: STARTER
                      billingCycle: LTD
                      monthlyCredits: 30
                      usedCredits: 12
                      availableCredits: 18
                      periodStart: '2024-12-01T00:00:00.000Z'
                      periodEnd: '2025-01-01T00:00:00.000Z'
                      status: ACTIVE
                    - subscriptionId: sub_def456
                      planType: GROWTH
                      billingCycle: MONTHLY
                      monthlyCredits: 200
                      usedCredits: 68
                      availableCredits: 132
                      periodStart: '2024-12-01T00:00:00.000Z'
                      periodEnd: '2025-01-01T00:00:00.000Z'
                      status: ACTIVE
                  nextResetDate: '2025-01-01T00:00:00.000Z'
          headers: {}
          x-apidog-name: Success
        '400':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                  message:
                    type: string
                  errorId:
                    type: string
                required:
                  - status
                  - message
                  - errorId
                x-apidog-orders:
                  - status
                  - message
                  - errorId
              example:
                status: 400
                message: User not found
                errorId: uuid-v4-error-id
          headers: {}
          x-apidog-name: Bad Request
        '401':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                  message:
                    type: string
                  errorId:
                    type: string
                required:
                  - status
                  - message
                  - errorId
                x-apidog-orders:
                  - status
                  - message
                  - errorId
              example:
                status: 401
                message: API key is required
                errorId: uuid-v4-error-id
          headers: {}
          x-apidog-name: Unauthorized
        '500':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                  message:
                    type: string
                  errorId:
                    type: string
                required:
                  - status
                  - message
                  - errorId
                x-apidog-orders:
                  - status
                  - message
                  - errorId
              example:
                status: 500
                message: Internal server error
                errorId: uuid-v4-error-id
          headers: {}
          x-apidog-name: Internal Server Error
      security: []
      x-apidog-folder: placement test
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/797058/apis/api-25779804-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://api.zapmail.ai/api
    description: Prod Env
security: []

```