---
title: "Suspend a number on the service"
method: PATCH
path: "/services/{id}/numbers/{phoneNumber}/suspend"
tags: ["Services"]
---

# Suspend a number on the service

`PATCH /services/{id}/numbers/{phoneNumber}/suspend`

Suspends a number assigned to the specified service. You can include a note as to the reason of the suspension.

## Request body

- SuspendRequest — The request body for suspending a number.
  - `suspended` boolean — Set to `true` to suspend a number.
  - `note` string — An optional field to include a note providing context about the suspension.

## Response `200`

Response detailing the suspended number.

- ServicePhoneNumber
  - `phoneNumber` string, phoneNumber — A phone number in [E.164](https://community.sinch.com/t5/Glossary/E-164/ta-p/7537) format, including the leading '+'.
  - `permissions` 'both' | 'send' | 'receive' — Allows you to set permissions for sending and receiving faxes to this email/phone number combination. Default value is `both`.
  - `country` string — The country code of the phone number in ISO 3166-1 alpha-2 format.
  - `suspended` boolean — Specifies if a number is suspended or not.
  - `note` string — An optional field providing context about the suspension.
  - `projectId` string — The `Id` of the project associated with the call.
  - `serviceId` string — ID of the fax service used.

---

[API](https://skmtc.dev/sinch/apis/fax-api.md) · [All operations](https://skmtc.dev/sinch/apis/fax-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sinch/fax-api/revisions/dbb6f03ef838/schema)