---
title: "Retrieves an existing distribution policy by Id."
method: GET
path: "/routing/distributionPolicies/{distributionPolicyId}"
---

# Retrieves an existing distribution policy by Id.

`GET /routing/distributionPolicies/{distributionPolicyId}`

Retrieves an existing distribution policy by Id.

## Path parameters

- `distributionPolicyId` string, required

## Query parameters

- `api-version` string, required

## Response `200`

The request has succeeded.

- DistributionPolicy — Policy governing how jobs are distributed to workers
  - `etag` string, required — The ETag (or entity tag) HTTP response header is an identifier for a specific version of a resource. It lets caches be more efficient and save bandwidth, as a web server does not need to resend a full response if the content was not changed. It is a string of ASCII characters placed between double quotes, like "675af34563dc-tr34".
  - `id` string, required — Id of a distribution policy.
  - `name` string — Friendly name of this policy.
  - `offerExpiresAfterSeconds` number, double — Number of seconds after which any offers created under this policy will be expired.
  - `mode` DistributionMode — Abstract base class for defining a distribution mode.
    - `minConcurrentOffers` integer — Governs the minimum desired number of active concurrent offers a job can have.
    - `maxConcurrentOffers` integer — Governs the maximum number of active concurrent offers a job can have.
    - `bypassSelectors` boolean — If set to true, then router will match workers to jobs even if they don't match label selectors. Warning: You may get workers that are not qualified for a job they are matched with if you set this variable to true. This flag is intended more for temporary usage. By default, set to false.
    - `kind` 'bestWorker' | 'longestIdle' | 'roundRobin', required — Discriminators for supported distribution mode types.

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/azure/apis/communication-jobrouter.md) · [All operations](https://skmtc.net/azure/apis/communication-jobrouter/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/communication-jobrouter/revisions/c06e8f55d8b7/schema)