---
title: "Get Account Info"
method: GET
path: "/restapi/v1.0/account/{accountId}"
tags: ["Company"]
---

# Get Account Info

`GET /restapi/v1.0/account/{accountId}`

Returns basic information about a particular RingCentral customer account.

## Path parameters

- `accountId` string, required

## Response `200`

Account information

- GetAccountInfoResponse
  - `id` integer — Internal identifier of an account
  - `uri` string, uri — Canonical URI of an account
  - `bsid` string — Internal identifier of an account in the billing system
  - `mainNumber` string — Main phone number of the current account
  - `operator` AccountOperatorInfo — Operator extension information. This extension will receive all calls and messages addressed to an operator.
    - `uri` string, uri — Link to an operator extension resource
    - `id` integer — Internal identifier of an operator extension
    - `extensionNumber` string — Number of an operator extension
    - `partnerId` string — Internal identifier of an extension created by partner. Supported for Partner Applications. The RingCentral supports the mapping of accounts and stores the corresponding account ID/extension ID for each partner ID of a client application. In request URIs partner IDs are accepted instead of regular RingCentral native IDs as path parameters using `pid=XXX` clause. Though in response URIs contain the corresponding account IDs and extension IDs. In all request and response bodies these values are reflected via partnerId attributes of account and extension
  - `partnerId` string — Additional account identifier, created by partner application and applied on client side
  - `serviceInfo` ServiceInfo — Account service information, including brand, sub-brand, service plan and billing plan
    - `uri` string, uri — Canonical URI of a service info resource
    - `billingPlan` BillingPlanInfo — Information on account billing plan
      - `id` string — Internal identifier of a billing plan
      - `name` string — Billing plan name
      - `durationUnit` 'Day' | 'Month' | 'Year' — Duration period
      - `duration` integer — Number of duration units
      - `type` 'Initial' | 'Regular' | 'Suspended' | 'Trial' | 'TrialNoCC' | 'Free' — Billing plan type
      - `includedPhoneLines` integer — Included digital lines count
    - `brand` BrandInfo — Information on account brand
      - `id` string — Internal identifier of a brand
      - `name` string — Brand name, for example RingCentral UK , ClearFax
      - `homeCountry` CountryInfoShortModel
        - `id` string — Internal identifier of a country
        - `uri` string, uri — Canonical URI of a country resource
        - `name` string — The official name of a country
        - `isoCode` string — A ISO country code value complying with the [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format.
        - `callingCode` string — Country calling code defined by [ITU-T](http://en.wikipedia.org/wiki/ITU-T) recommendations [E.123](http://en.wikipedia.org/wiki/E.123) and [E.164](http://en.wikipedia.org/wiki/E.164), see [Calling Codes](http://en.wikipedia.org/wiki/List_of_country_calling_codes)
    - `servicePlan` ServicePlanInfo — Information on account service plan
      - `id` string — Internal identifier of a service plan
      - `name` string — Name of a service plan
      - `edition` string — Edition of a service plan
      - `freemiumProductType` 'Freyja' | 'Phoenix'
    - `targetServicePlan` TargetServicePlanInfo — Information on account target service plan
      - `id` string — Internal identifier of a target service plan
      - `name` string — Name of a target service plan
      - `edition` string — Edition of a service plan
      - `freemiumProductType` 'Freyja' | 'Phoenix'
    - `contractedCountry` CountryInfoShortModel
      - `id` string — Internal identifier of a country
      - `uri` string, uri — Canonical URI of a country resource
      - `name` string — The official name of a country
      - `isoCode` string — A ISO country code value complying with the [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format.
      - `callingCode` string — Country calling code defined by [ITU-T](http://en.wikipedia.org/wiki/ITU-T) recommendations [E.123](http://en.wikipedia.org/wiki/E.123) and [E.164](http://en.wikipedia.org/wiki/E.164), see [Calling Codes](http://en.wikipedia.org/wiki/List_of_country_calling_codes)
    - `uBrand` UBrandInfo — Account sub-brand information
      - `id` string — Sub-brand unique ID
      - `name` string — Sub-brand name
  - `setupWizardState` 'NotStarted' | 'Incomplete' | 'Completed' | 'Unknown' — Initial configuration wizard state
  - `signupInfo` SignupInfoResource — Account sign up data
    - `tosAccepted` boolean
    - `signupState` string[]
    - `verificationReason` 'CC_Failed' | 'Phone_Suspicious' | 'CC_Phone_Not_Match' | 'AVS_Not_Available' | 'MaxMind' | 'CC_Blacklisted' | 'Email_Blacklisted' | 'Phone_Blacklisted' | 'Cookie_Blacklisted' | 'Device_Blacklisted' | 'IP_Blacklisted' | 'Agent_Instance_Blacklisted' | 'Charge_Limit' | 'Other_Country' | 'Unknown'
    - `marketingAccepted` boolean — Updates 'Send Marketing Information' flag on web interface
    - `creationTime` string, date-time — The timestamp of account creation
  - `status` 'Initial' | 'Confirmed' | 'Unconfirmed' | 'Disabled' — Status of the current account
  - `statusInfo` AccountStatusInfo — Optional information to be used when account is moved to "Disabled" status
    - `reason` 'SuspendedVoluntarily' | 'SuspendedInvoluntarily' | 'CancelledVoluntarily' | 'CancelledInvoluntarily' — Type of suspension, voluntarily or not
    - `comment` string — A meaningful description of the reason to change the status
    - `till` string, date-time — Date after which the account will get deleted. Parameter can be used to overwrite default retention period
  - `regionalSettings` AccountRegionalSettings — Account level region data (web service Auto-Receptionist settings)
    - `homeCountry` CountryInfoShortModel
      - `id` string — Internal identifier of a country
      - `uri` string, uri — Canonical URI of a country resource
      - `name` string — The official name of a country
      - `isoCode` string — A ISO country code value complying with the [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format.
      - `callingCode` string — Country calling code defined by [ITU-T](http://en.wikipedia.org/wiki/ITU-T) recommendations [E.123](http://en.wikipedia.org/wiki/E.123) and [E.164](http://en.wikipedia.org/wiki/E.164), see [Calling Codes](http://en.wikipedia.org/wiki/List_of_country_calling_codes)
    - `timezone` TimezoneInfo — Extension timezone information
      - `id` string — Internal identifier of a timezone
      - `uri` string, uri — Canonical URI of a timezone
      - `name` string — Short name of a timezone
      - `description` string — Meaningful description of the timezone
      - `bias` string
    - `language` RegionalLanguageInfo — Information on a language set as regional
      - `id` string — Internal identifier of a language set as regional
      - `localeCode` string — Localization code of a language set as regional
      - `name` string — Official name of a language set as regional
    - `greetingLanguage` GreetingLanguageInfo — Information on language used for telephony greetings
      - `id` string — Internal identifier of a greeting language
      - `localeCode` string — Localization code of a greeting language
      - `name` string — Official name of a greeting language
    - `formattingLocale` FormattingLocaleInfo — Formatting language preferences for numbers, dates and currencies
      - `id` string — Internal identifier of a formatting language
      - `localeCode` string — Localization code of a formatting language
      - `name` string — Official name of a formatting language
    - `timeFormat` '12h' | '24h' — Time format setting. The default value is '12h' = ['12h', '24h']
    - `currency` CurrencyInfo — Currency information
      - `id` integer — Internal identifier of a currency
      - `code` string — Official code of a currency
      - `name` string — Official name of a currency
      - `symbol` string — Graphic symbol of a currency
      - `minorSymbol` string — Minor graphic symbol of a currency
  - `federated` boolean — Specifies whether an account is included into any federation of accounts or not
  - `outboundCallPrefix` integer — If outbound call prefix is not specified, or set to null (0), then the parameter is not returned; the supported value range is 2-9
  - `cfid` string — Customer facing identifier. Returned for accounts with the turned off PBX features. Equals to main company number in [E.164](https://www.itu.int/rec/T-REC-E.164-201011-I) (without "+" sign)format
  - `limits` AccountLimits — Limits which are effective for the account
    - `freeSoftPhoneLinesPerExtension` integer — Max number of free softphone phone lines per user extension
    - `meetingSize` integer — Max number of participants in RingCentral meeting hosted by this account's user
    - `cloudRecordingStorage` integer — Meetings recording cloud storage limitation in Gb
    - `maxMonitoredExtensionsPerUser` integer — Max number of extensions which can be included in the list of users monitored for Presence
    - `maxExtensionNumberLength` integer — Max length of extension numbers of an account; the supported value is up to 8 symbols, depends on account type
    - `siteCodeLength` integer — Length of a site code
    - `shortExtensionNumberLength` integer — Length of a short extension number

---

[API](https://skmtc.net/ringcentral/apis/ringcentral-api.md) · [All operations](https://skmtc.net/ringcentral/apis/ringcentral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringcentral/ringcentral-api/versions/8d602198ec97/schema)