# Cancel pending bulk SMS job
URL: /docs/api-reference/bulk-campaign-messaging/cancelBulkJob

## PATCH `/api/v1/public/sms/bulk/jobs/{jobId}`

**Summary:** Cancel pending bulk SMS job
**Operation ID:** `cancelBulkJob`

Aborts a bulk job if it is currently in QUEUED or SCHEDULED status. Unconsumed units are refunded to the customer wallet.

**Authentication:** `X-Api-Key: sk_live_...` or `Authorization: Bearer sk_live_...`

### Parameters

| Name | In | Required | Description |
| :--- | :--- | :--- | :--- |
| `jobId` | `path` | Yes | Job ID to cancel |

### Responses

- **`200`**: Bulk job successfully cancelled and credits refunded

```json
{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "example": "success"
    },
    "message": {
      "type": "string",
      "example": "Bulk job cancelled successfully"
    }
  }
}
```
- **`401`**: Authentication failed or API key missing
- **`422`**: Validation error or invalid input parameters