---
title: "Get Account Info"
method: GET
path: "/restapi/v2/accounts/{accountId}"
tags: ["Company"]
---

# Get Account Info

`GET /restapi/v2/accounts/{accountId}`

Returns basic information about particular RingCentral account

## Path parameters

- `accountId` string, required

## Response `200`

Successful response

- AccountInfo
  - `id` string, required — Internal identifier of RingCentral account
  - `externalAccountId` string — External account ID. Used as a primary key to link accounts between RingCentral and partner systems.
  - `mainNumber` string — Phone number in e.164 format (with '+' prefix)
  - `status` 'Initial' | 'Unconfirmed' | 'Confirmed' | 'Disabled', required — Account status
  - `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
  - `companyName` string — Company name
  - `companyAddress` PostalAddress — Postal address/location
    - `street` string, required — Street address
    - `street2` string — Street address (2nd line)
    - `city` string, required — City name
    - `state` string — State or province information in the target country
    - `zip` string, required — Postal code in the target country
    - `country` string, required — ISO-3166-1 2-letter country code (alpha2)
  - `serviceInfo` ServiceInfoV2, required — Service Plan information (billing package, brand, etc.)
    - `package` ServiceInfoPackage, required — Billing package information
      - `id` string, required — Billing package ID
      - `version` '1', required — Billing package version
    - `brand` ServiceInfoBrand — Internal RC "brand" information
      - `id` string, required — RingCentral brand ID
      - `name` string, required — RingCentral brand name
    - `contractedCountry` ServiceInfoCountryShortModel
      - `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` ServiceInfoUBrand — Account sub-brand information
      - `id` string — Sub-brand unique ID
      - `name` string — Sub-brand name
    - `servicePlan` ServiceInfoPlan — 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'
  - `contactInfo` SystemUserContactInfo — Personal contact information
    - `firstName` string, required — Given name
    - `lastName` string, required — Family name
    - `email` string, email, required — Contact email
    - `contactPhone` string, required — Phone number in e.164 format (with '+' prefix)
    - `id` string, required — Internal identifier of System user extension
    - `extensionNumber` string, required — Short number of an extension. Actual max length depends on system length limit for extension.
  - `opportunityId` string — Opportunity identifier (typically created by SalesForce)

## Other responses

- `403` — General response with **HTTP 403 "Forbidden"** status.<br> Reasons: the requested operation is forbidden because of certain resource state, lack of permissions, feature unavailability, etc.
- `404` — General response with **HTTP 404 "Not found"** status.<br> Reasons: the entity with given ID (typically specified in a path parameter), is not found or inaccessible
- `429` — General response with **HTTP 429 "Too many requests"** status.<br> Reasons: certain rate limit is exceeded.
- `500` — General response with **HTTP 500 "Internal Server Error"** status.<br> Reasons: general server-side error.
- `503` — General response with **HTTP 503 "Service not available"** status.<br> Reasons: server cannot process the request because of being overloaded, misconfiguration or other issues.

---

[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)