> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vobiz.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Retrieve a Subaccount
> Fetch the full details of a specific Vobiz subaccount by its sub_auth_id - credentials, permissions, rate limits, and current status for a single tenant.
```http theme={null}
GET https://api.vobiz.ai/api/v1/accounts/{auth_id}/sub-accounts/{sub_auth_id}
```
Returns the details of a specific subaccount by its ID.
**Authentication required:**
* `X-Auth-ID` - Your account Auth ID
* `X-Auth-Token` - Your account Auth Token
* `Content-Type: application/json`
## Arguments
No arguments required.
## Request
```bash cURL theme={null}
curl -X GET 'https://api.vobiz.ai/api/v1/accounts/{auth_id}/sub-accounts/{sub_auth_id}' \
--header 'X-Auth-ID: {auth_id}' \
--header 'X-Auth-Token: {auth_token}'
```
## Response Example
```json Success Response (200 OK) theme={null}
{
"name": "Support Team",
"email": "support@example.com",
"phone": "+1234567890",
"description": "Support-facing voice workload",
"permissions": {
"calls": true,
"cdr": true
},
"rate_limit": 500,
"id": "500001",
"parent_account_id": "510762",
"parent_auth_id": "MA_XXXXXXXX",
"auth_id": "SA_XXXXXXXX",
"auth_token": "",
"api_id": "aabbccdd-1234-5678-90ab-cdef12345678",
"email_verified": false,
"enabled": true,
"is_active": true,
"created": "2025-10-22T03:57:35.997500Z",
"modified": "2025-10-22T03:57:35.997500Z",
"created_at": "2025-10-22T03:57:35.997500Z",
"updated_at": "2025-10-22T03:57:35.997500Z",
"account": "/v1/Account/MA_XXXXXXXX/",
"resource_uri": "/v1/Account/MA_XXXXXXXX/Subaccount/SA_XXXXXXXX/",
"last_used": null
}
```
`auth_token` is masked on retrieve — it is only returned in clear text **once**, at [creation](/sub-accounts/create-subaccount). The numeric `id` and the `auth_id` (`SA_…`) are different identifiers; use `auth_id` as the `sub_auth_id` path segment on every other call.
## OpenAPI
````yaml GET /api/v1/accounts/{auth_id}/sub-accounts/{sub_auth_id}
openapi: 3.0.3
info:
title: Vobiz API
description: >
The Vobiz API lets you make calls, manage phone numbers, configure SIP
trunks,
and access account data programmatically.
**Base URL:** `https://api.vobiz.ai`
**Authentication:** All requests require `X-Auth-ID` and `X-Auth-Token`
headers.
Obtain these from your [Vobiz Console](https://console.vobiz.ai).
version: '1.0'
contact:
email: support@vobiz.ai
url: https://vobiz.ai
servers:
- url: https://api.vobiz.ai
description: Production
security:
- AuthID: []
AuthToken: []
tags:
- name: Account
description: Manage your account details and credentials
- name: Balance
description: Retrieve balance and transaction history
- name: Calls
description: Make and manage outbound calls
- name: Live Calls
description: Retrieve and control in-progress calls
- name: CDR
description: Call detail records and history
- name: Sub-Accounts
description: Create and manage sub-accounts
- name: Phone Numbers
description: Manage phone numbers on your account
- name: Trunks
description: Configure SIP trunks for inbound and outbound calling
- name: Conference
description: Manage conference calls and members
- name: Applications
description: Manage voice and messaging applications with webhook URLs
- name: Endpoints
description: Manage SIP endpoints for IP phones, softphones, and SIP clients
- name: Partner API
description: >-
Reseller and white-label endpoints for managing customer sub-accounts,
balance transfers, transactions, CDRs, and DIDs across your partner
ecosystem
- name: Sub-Account KYC
description: >-
Per-sub-account KYC verification (PAN, GST, CIN, Aadhaar, DigiLocker) and
hosted email/redirect KYC sessions. Authenticated as the parent main
account.
- name: Sub-Account KYC (Test Mode)
description: >-
Mock KYC endpoints that never call the upstream provider. Drive verified /
failed / pending / error outcomes with magic inputs for integration
testing.
paths:
/api/v1/accounts/{auth_id}/sub-accounts/{sub_auth_id}:
get:
tags:
- Sub-Accounts
summary: Retrieve a sub-account
description: Retrieve details of a specific sub-account.
operationId: retrieve-subaccount
parameters:
- $ref: '#/components/parameters/AuthId'
- name: sub_auth_id
in: path
required: true
schema:
type: string
example: SA_XXXXXX
responses:
'200':
description: Sub-account details
content:
application/json:
schema:
type: object
properties:
name:
type: string
email:
nullable: true
phone:
nullable: true
description:
nullable: true
permissions:
nullable: true
rate_limit:
type: integer
id:
type: string
parent_account_id:
type: string
parent_auth_id:
type: string
auth_id:
type: string
auth_token:
type: string
api_id:
type: string
email_verified:
type: boolean
enabled:
type: boolean
created:
type: string
modified:
type: string
is_active:
type: boolean
created_at:
type: string
updated_at:
type: string
last_used:
nullable: true
account:
type: string
resource_uri:
type: string
required:
- name
- email
- phone
- description
- permissions
- rate_limit
- id
- parent_account_id
- parent_auth_id
- auth_id
- auth_token
- api_id
- email_verified
- enabled
- created
- modified
- is_active
- created_at
- updated_at
- last_used
- account
- resource_uri
example:
name: Acme Sub-Account
email: null
phone: null
description: null
permissions: null
rate_limit: 1000
id: '500001'
parent_account_id: '510762'
parent_auth_id: MA_XXXXXXXX
auth_id: SA_XXXXXXXX
auth_token:
api_id: 11223344-1234-5678-90ab-cdef12345678
email_verified: false
enabled: true
created: '2026-03-25'
modified: '2026-03-25'
is_active: true
created_at: '2026-03-25T10:00:00Z'
updated_at: '2026-03-25T10:00:00Z'
last_used: null
account: /v1/Account/MA_XXXXXXXX/
resource_uri: /v1/Account/MA_XXXXXXXX/Subaccount/SA_XXXXXXXX/
components:
parameters:
AuthId:
name: auth_id
in: path
required: true
description: Your account Auth ID
schema:
type: string
example: MA_XXXXXX
securitySchemes:
AuthID:
type: apiKey
in: header
name: X-Auth-ID
description: Your Vobiz account Auth ID
AuthToken:
type: apiKey
in: header
name: X-Auth-Token
description: Your Vobiz account Auth Token
````