# List Apple Messages for Business routing rules

`GET /v1/amb/routing-rules`

Returns the workspace's Apple Messages for Business routing rules, highest precedence first. A rule only runs when a conversation is created or reopened, matching it to a queue based on the group and intent its entry point carried. It never runs again while the conversation stays open, so a queue an operator moves a conversation to is not overwritten by the next message the customer sends.

## Code samples

**TypeScript**

```ts
const result = await bird.amb.routingRules.list({
  business_id: "abz_01krdgeqcxet5s7t44vh8rt9mg",
});
console.log(result);
```

Examples: [TypeScript](/docs/api/reference/list-amb-routing-rules.ts.md) · [Python](/docs/api/reference/list-amb-routing-rules.py.md) · [Go](/docs/api/reference/list-amb-routing-rules.go.md) · [PHP](/docs/api/reference/list-amb-routing-rules.php.md) · [CLI](/docs/api/reference/list-amb-routing-rules.cli.md) · [MCP](/docs/api/reference/list-amb-routing-rules.mcp.md) · [cURL](/docs/api/reference/list-amb-routing-rules.curl.md)

## Example response `200`

```json
{
  "data": [
    {
      "created_at": "2026-05-20T09:14:52Z",
      "updated_at": "2026-05-25T16:42:01Z",
      "id": "arr_01krdgeqcxet5s7t44vh8rt9mg",
      "business_id": "abz_01krdgeqcxet5s7t44vh8rt9mg",
      "match_kind": "intent",
      "match_intent_id": "order_status",
      "match_group_id": "support",
      "queue": "billing",
      "precedence": 10,
      "is_default": false
    }
  ]
}
```

## Query parameters

- `business_id` (string): Keep only routing rules belonging to this business. Omit to return rules across all businesses in the workspace.

## Response body

- `data` (array of object, required): The workspace's routing rules, optionally filtered by business, highest precedence first and ties broken by `id`. Rules are evaluated within their business in this order. The set is returned in full; this list is not paginated.
- `data.created_at` (string, required)
- `data.updated_at` (string, required)
- `data.id` (string, required): Unique identifier for the routing rule.
- `data.business_id` (string, required): The Apple Messages for Business brand this rule belongs to.
- `data.match_kind` (string, required)

  What a routing rule matches against the entry point that started the conversation.

  - `intent` matches on the entry point's intent alone: `match_intent_id` is set and `match_group_id` is null.
  - `group` matches on the entry point's group alone: `match_group_id` is set and `match_intent_id` is null.
  - `both` matches only when the entry point carries the given intent and the given group together, so `match_intent_id` and `match_group_id` are both set. There are two match fields rather than one because `both` needs to carry an intent and a group at once.

  Possible values: `intent`, `group`, `both`
- `data.match_intent_id` (nullable string): The entry point intent this rule matches, as sent in Apple's `intentID`. Set when `match_kind` is `intent` or `both`, null when it is `group`.
- `data.match_group_id` (nullable string): The entry point group this rule matches, as sent in Apple's `groupID`. Set when `match_kind` is `group` or `both`, null when it is `intent`.
- `data.queue` (string, required): The queue a matching conversation is filed into. A queue is a label your console filters by rather than a resource you create ahead of time, so any value routes.
- `data.precedence` (integer, required): Evaluation order among this business's rules. The highest-precedence rule a conversation matches wins; rules tied on precedence are evaluated by their `id`.
- `data.is_default` (boolean, required): Whether this rule catches a conversation that matches nothing else. A business has at most one. A conversation created or reopened while none exists routes to an empty queue, which the console lists as unrouted.

## Related resources

- [Should I use a Bird SDK or call the API directly?](/explained/platform/should-i-use-an-sdk-or-call-the-api-directly) (answer)
- [Build your first integration](/learn/paths/integration) (course)
- [Send your first email](/docs/get-started/send-your-first-email) (docs)

[Get an implementation brief](/learn/workspace?topic=api-basics)