---
title: "List Company Call Handling Rules"
method: GET
path: "/restapi/v1.0/account/{accountId}/answering-rule"
tags: ["Call Handling Rules"]
---

# List Company Call Handling Rules

`GET /restapi/v1.0/account/{accountId}/answering-rule`

Returns a list of company call handling rules.

## Path parameters

- `accountId` string, required

## Query parameters

- `page` integer
- `perPage` integer

## Response `200`

OK

- CompanyAnsweringRuleList
  - `uri` string, uri — Link to an answering rule resource
  - `records` ListCompanyAnsweringRuleInfo[] — List of company answering rules
    - `id` string — Internal identifier of an answering rule
    - `uri` string, uri — Canonical URI of an answering rule
    - `enabled` boolean — Specifies if the rule is active or inactive. The default value is `true`
    - `type` 'BusinessHours' | 'AfterHours' | 'Custom' — Type of an answering rule, the default value is 'Custom' = ['BusinessHours', 'AfterHours', 'Custom']
    - `name` string — Name of an answering rule specified by user. Max number of symbols is 30. The default value is 'My Rule N' where 'N' is the first free number
    - `calledNumbers` CalledNumberInfo[] — Answering rules are applied when calling to selected number(s)
      - `phoneNumber` string — Called phone number
    - `extension` CompanyAnsweringRuleExtensionInfo
      - `id` string — Internal identifier of an extension
  - `paging` EnumeratedPagingModel
    - `perPage` integer, required — Current page size, describes how many items are in each page. Matches "perPage" parameter from the request.
    - `page` integer — The current page number. 1-indexed, so the first page is 1 by default. May be omitted if result is empty (because non-existent page was specified or perPage=0 was requested)
    - `pageStart` integer — The zero-based number of the first element on the current page. Omitted if the page is omitted or result is empty
    - `pageEnd` integer — The zero-based index of the last element on the current page. Omitted if the page is omitted or result is empty
    - `totalPages` integer — The total number of pages in a dataset. May be omitted for some resources due to performance reasons
    - `totalElements` integer — The total number of elements in a dataset. May be omitted for some resource due to performance reasons
  - `navigation` PageNavigationModel — Links to other pages of the current result set
    - `firstPage` PageNavigationUri
      - `uri` string, uri — Canonical URI to retrieve the particular page of the result set
    - `nextPage` PageNavigationUri
      - `uri` string, uri — Canonical URI to retrieve the particular page of the result set
    - `previousPage` PageNavigationUri
      - `uri` string, uri — Canonical URI to retrieve the particular page of the result set
    - `lastPage` PageNavigationUri
      - `uri` string, uri — Canonical URI to retrieve the particular page of the result set

## Other responses

- `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
- `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/revisions/8d602198ec97/schema)