v1

latestOpenAPI 3.0.3RingCentral API License Agreement2026-08-064871,2921.5 MB

Company

Get Account Info

Returns basic information about particular RingCentral account

get/restapi/v2/accounts/{accountId}

Path parameters

accountIdstring required

Internal identifier of the RingCentral account (can be set to "~" to indicate that the account associated with current authorization session should be used)

Response

Successful response

idstring required

Internal identifier of RingCentral account

externalAccountIdstring

External account ID. Used as a primary key to link accounts between RingCentral and partner systems.

mainNumberstring

Phone number in e.164 format (with '+' prefix)

status'Initial' | 'Unconfirmed' | 'Confirmed' | 'Disabled' required

Account status

companyNamestring

Company name

opportunityIdstring

Opportunity identifier (typically created by SalesForce)

Example response

{
  "id": "8000012345",
  "externalAccountId": "acme-us-12345",
  "mainNumber": "+16501234567",
  "status": "Confirmed",
  "statusInfo": {
    "reason": "CancelledVoluntarily",
    "comment": "By customer request. Case ABC123",
    "till": "2023-03-26T11:30:45.940Z"
  },
  "companyName": "Acme Inc.",
  "companyAddress": {
    "street": "20 Davis Dr",
    "city": "Belmont",
    "state": "CA",
    "zip": "94002",
    "country": "US"
  },
  "serviceInfo": {
    "package": {
      "id": "555"
    },
    "brand": {
      "id": "6699",
      "name": "Partner 1"
    },
    "uBrand": {
      "id": "111.222",
      "name": "Sub-brand name"
    }
  },
  "contactInfo": {
    "firstName": "John",
    "lastName": "Smith",
    "email": "john.smith@acme.com",
    "contactPhone": "+16501234567",
    "extensionNumber": "205"
  },
  "opportunityId": "0061800000DwZzJAAV"
}