---
title: "GET /sip-rules"
method: GET
path: "/sip-rules"
---

# GET /sip-rules

`GET /sip-rules`

Lists the SIP rules under the administrator's AWS account.

## Query parameters

- `sip-media-application` string
- `max-results` integer
- `next-token` string
- `MaxResults` string
- `NextToken` string

## Response `200`

Success

- ListSipRulesResponse
  - `SipRules` SipRule[] — List of SIP rules and rule details.
    - `SipRuleId` string — The SIP rule ID.
    - `Name` string — The name of the SIP rule.
    - `Disabled` boolean — Indicates whether the SIP rule is enabled or disabled. You must disable a rule before you can delete it.
    - `TriggerType` 'ToPhoneNumber' | 'RequestUriHostname' — The type of trigger assigned to the SIP rule in <code>TriggerValue</code>, currently <code>RequestUriHostname</code> or <code>ToPhoneNumber</code>.
    - `TriggerValue` string — If <code>TriggerType</code> is <code>RequestUriHostname</code>, then the value can be the outbound host name of the Amazon Chime Voice Connector. If <code>TriggerType</code> is <code>ToPhoneNumber</code>, then the value can be a customer-owned phone number in E164 format. <code>SipRule</code> is triggered when a SIP rule requests host name or <code>ToPhoneNumber</code> matches in the incoming SIP request.
    - `TargetApplications` SipRuleTargetApplication[] — Target SIP media application and other details, such as priority and AWS Region, to be specified in the SIP rule. Only one SIP rule per AWS Region can be provided.
      - `SipMediaApplicationId` string — The SIP media application ID.
      - `Priority` integer — Priority of the SIP media application in the target list.
      - `AwsRegion` string — The AWS Region of the target application.
    - `CreatedTimestamp` string, date-time — The time at which the SIP rule was created, in ISO 8601 format.
    - `UpdatedTimestamp` string, date-time — The time at which the SIP rule was last updated, in ISO 8601 format.
  - `NextToken` string — The token to use to retrieve the next page of results.

## Other responses

- `480` — UnauthorizedClientException
- `481` — ForbiddenException
- `482` — BadRequestException
- `483` — ThrottledClientException
- `484` — ServiceUnavailableException
- `485` — ServiceFailureException

---

[API](https://skmtc.net/aws/apis/chime.md) · [All operations](https://skmtc.net/aws/apis/chime/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/chime/versions/40da18840201/schema)