---
title: "Get account"
method: GET
path: "/v1/account"
tags: ["Account"]
---

# Get account

`GET /v1/account`

## Request

- Base URL: `https://api.aircaps.com`
- URL: `https://api.aircaps.com/v1/account`
- Auth: HTTP bearer

Your usage limit, per-model access (`enabled`) and limits. For higher limits or model access, [talk to sales](https://research.aircaps.com/contact).

## Response `200`

The account.

- Account
  - `id` string: Account ID.
  - `object` 'account'
  - `email` string
  - `display_name` string, nullable
  - `created_at` string, date-time
  - `status` 'active' | 'suspended'
  - `tier` string
  - `usage_limit` object: One limit shared by all models (5 hours free). To raise it, [talk to sales](https://research.aircaps.com/contact).
    - `limit_seconds` number
    - `used_seconds` number
    - `reserved_seconds` number: Held by running jobs and sessions.
    - `remaining_seconds` number
  - `models` object
    - `a5s-async-v1` object
      - `name` string
      - `type` 'async'
      - `enabled` boolean: Whether this account may use the model.
      - `max_concurrent_jobs` integer
      - `max_queued_jobs` integer
      - `max_requests_per_minute` integer
      - `max_audio_duration_seconds` integer
      - `retention_days` integer
      - `jobs_queued` integer
      - `jobs_processing` integer
    - `a5s-v2-streaming` object
      - `name` string
      - `type` 'streaming'
      - `enabled` boolean
      - `max_concurrent_sessions` integer
      - `max_session_seconds` integer
    - `aircaps-diarization-v1` object: Shares the asynchronous job limits with A5S Async v1.
      - `name` string
      - `type` 'async'
      - `enabled` boolean: Whether this account may use the model (enabled on request).
      - `max_concurrent_jobs` integer
      - `max_queued_jobs` integer
      - `max_requests_per_minute` integer
      - `max_audio_duration_seconds` integer
      - `retention_days` integer
    - `aircaps-speaker-id-v1` object: Synchronous: one clip per request.
      - `name` string
      - `type` 'sync'
      - `enabled` boolean: Whether this account may use the model (enabled on request).
      - `max_requests_per_minute` integer: Enrollments and identifications together.
      - `max_clip_duration_seconds` integer
      - `max_speakers` integer
      - `max_enrollments_per_speaker` integer
      - `speakers` integer: Speakers the account has now.

## Other responses

- `401`: Missing or invalid API key. Codes: `unauthorized`.
- `403`: The account is disabled. Codes: `account_disabled`.
- `500`: Server error. Safe to retry (use the same Idempotency-Key). Codes: `internal_error`.
- `503`: Temporarily unavailable. Retry after the Retry-After interval. Codes: `service_unavailable`.

---

[API](https://skmtc.dev/aircaps/apis/aircaps-api.md) - [All operations](https://skmtc.dev/aircaps/apis/aircaps-api/llms.txt) - [OpenAPI document](https://skmtc.dev/aircaps/apis/aircaps-api/revisions/442d566f9827?raw)