# Zones

A Zone is used to define a [ShippingRate](/urn?urn=ctp%3Aapi%3Atype%3AShippingRate) for a set of locations.

A maximum number of **100** Zones can be created per Project. This is a soft limit that can be increased per Project after a performance impact review. See [Limit increase guidance](/api/limit-increase-guidance.md#discount-and-checkout-limits).

## Representations

#### Zone

[type definition](/api/projects/zones.md?urn=ctp:api:type:Zone).

#### ZoneDraft

[type definition](/api/projects/zones.md?urn=ctp:api:type:ZoneDraft).

#### ZonePagedQueryResponse

[type definition](/api/projects/zones.md?urn=ctp:api:type:ZonePagedQueryResponse).

#### ZoneReference

[type definition](/api/projects/zones.md?urn=ctp:api:type:ZoneReference).

#### ZoneResourceIdentifier

[type definition](/api/projects/zones.md?urn=ctp:api:type:ZoneResourceIdentifier).

#### Location

[type definition](/api/projects/zones.md?urn=ctp:api:type:Location).

## Get Zone

### Get Zone by ID

[endpoint definition](/api/projects/zones.md?urn=ctp:api:endpoint:/\{projectKey}/zones/\{id}:GET).

### Get Zone by Key

[endpoint definition](/api/projects/zones.md?urn=ctp:api:endpoint:/\{projectKey}/zones/key=\{key}:GET).

## Query Zones

[endpoint definition](/api/projects/zones.md?urn=ctp:api:endpoint:/\{projectKey}/zones:GET).

## Check if Zone exists

### Check if Zone exists by ID

[endpoint definition](/api/projects/zones.md?urn=ctp:api:endpoint:/\{projectKey}/zones/\{id}:HEAD).

### Check if Zone exists by Key

[endpoint definition](/api/projects/zones.md?urn=ctp:api:endpoint:/\{projectKey}/zones/key=\{key}:HEAD).

### Check if Zone exists by Query Predicate

[endpoint definition](/api/projects/zones.md?urn=ctp:api:endpoint:/\{projectKey}/zones:HEAD).

## Create Zone

[endpoint definition](/api/projects/zones.md?urn=ctp:api:endpoint:/\{projectKey}/zones:POST).

## Update Zone

### Update Zone by ID

[endpoint definition](/api/projects/zones.md?urn=ctp:api:endpoint:/\{projectKey}/zones/\{id}:POST).

### Update Zone by Key

[endpoint definition](/api/projects/zones.md?urn=ctp:api:endpoint:/\{projectKey}/zones/key=\{key}:POST).

## Update actions

#### Set Key

[type definition](/api/projects/zones.md?urn=ctp:api:type:ZoneSetKeyAction).

#### Change Name

[type definition](/api/projects/zones.md?urn=ctp:api:type:ZoneChangeNameAction).

#### Set Description

[type definition](/api/projects/zones.md?urn=ctp:api:type:ZoneSetDescriptionAction).

#### Add Location

[type definition](/api/projects/zones.md?urn=ctp:api:type:ZoneAddLocationAction).

#### Remove Location

[type definition](/api/projects/zones.md?urn=ctp:api:type:ZoneRemoveLocationAction).

## Delete Zone

### Delete Zone by ID

[endpoint definition](/api/projects/zones.md?urn=ctp:api:endpoint:/\{projectKey}/zones/\{id}:DELETE).

### Delete Zone by Key

[endpoint definition](/api/projects/zones.md?urn=ctp:api:endpoint:/\{projectKey}/zones/key=\{key}:DELETE).

## Related pages

- [Area overview page with navigation](/api.md)
- [Previous page: Shipping Methods](/api/projects/shippingMethods.md)