> ## Documentation Index
> Fetch the complete documentation index at: https://sendcloud.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Shipping Rules API overview

Shipping rules let you automate how shipments are handled. A rule applies one or more actions to a shipment whenever the shipment matches its conditions, so you can set shipping methods, add insurance, or update other properties without manual work.

## Endpoints

### Managing rules

* [Retrieve a list of shipping rules](/api/v3/shipping-rules/retrieve-a-list-of-shipping-rules) — list all rules for your account in evaluation order, including their conditions and actions.
* [Create a shipping rule](/api/v3/shipping-rules/create-a-shipping-rule) — create a new rule with conditions and actions.
* [Retrieve a shipping rule](/api/v3/shipping-rules/retrieve-a-shipping-rule) — get a single rule by its ID.
* [Update a shipping rule](/api/v3/shipping-rules/update-a-shipping-rule) — update the name, status, conditions, or actions of a rule.
* [Delete a shipping rule](/api/v3/shipping-rules/delete-a-shipping-rule) — remove a rule permanently.
* [Reorder your shipping rules](/api/v3/shipping-rules/reorder-your-shipping-rules) — change the order in which rules are evaluated.

### Possibilities

Use these endpoints to discover the valid values for building rule conditions and actions.

* [Retrieve a list of available actions](/api/v3/shipping-rules/retrieve-a-list-of-available-actions) — list all actions without their accepted values.
* [Retrieve an action](/api/v3/shipping-rules/retrieve-an-action) — get a single action including the full list of accepted values.
* [Retrieve a list of available conditions](/api/v3/shipping-rules/retrieve-a-list-of-available-conditions) — list all condition properties and operators without their accepted values.
* [Retrieve a condition property](/api/v3/shipping-rules/retrieve-a-condition-property) — get a single condition property including the full list of accepted values.
* [Retrieve a list of available operators](/api/v3/shipping-rules/retrieve-a-list-of-available-operators) — list all operators.

## How rules work

Rules are evaluated in order, from first to last. When a shipment matches a rule's conditions, its actions are applied. Multiple rules can match the same shipment — all matching rules are applied in order.

Use [Reorder your shipping rules](/api/v3/shipping-rules/reorder-your-shipping-rules) to control evaluation order.

### Development status

The Shipping Rules v3 API is currently in [beta](https://support.sendcloud.com/hc/en-us/articles/4417167140756-What-is-beta-), meaning that it is still under development.
During this phase, we continually monitor and test the API to improve its performance, review the requested and the returned data, and uncover any potential bugs that could have a future impact on our users.

<Warning>
  Please note that there is a possibility of experiencing breaking changes while the API is still in beta.
</Warning>