---
title: "List forwarding rules"
method: GET
path: "/api/{cloudId}/v1/forwarding-rules"
tags: ["Forwarding rules"]
---

# List forwarding rules

`GET /api/{cloudId}/v1/forwarding-rules`

Lists the all forwarding rules user can view. It optionally takes three parameters - offset, size and showAll.

## Query parameters

- `showAll` boolean
- `offset` integer
- `size` integer

## Response `200`

Returned if the request is successful.

- ForwardingPaginatedResponse
  - `values` ForwardingRuleResponse[]
    - `id` string — Identifier of the forwarding rule.
    - `fromUserId` string — The id of user whose notifications will be forwarded.
    - `toUserId` string — The id of user who will receive the forwarded notifications.
    - `startDate` string — The date and time for forwarding will start, which takes a date format as (yyyy-MM-dd'T'HH:mm:ssZ) (e.g. 2017-01-15T08:00:00+02:00).
    - `endDate` string — The date and time for forwarding will end, which takes a date format as (yyyy-MM-dd'T'HH:mm:ssZ) (e.g. 2017-01-15T08:00:00+02:00).
  - `links` ForwardingLinks
    - `next` string — Link to the next page of results.

## Other responses

- `401` — Returned if the authentication credentials are incorrect.
- `402` — Returned if the customer subscription plan does not cover forwarding rules.
- `403` — Returned if the request user does not have permission to access forwarding rule.

---

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