---
title: "Cancel Rate Request"
method: POST
path: "/services/rating/v1/rate-requests/{id}/cancellations"
tags: ["Multi-Modal: Rating"]
---

# Cancel Rate Request

`POST /services/rating/v1/rate-requests/{id}/cancellations`

## Request

- Base URL: `https://na12.api.project44.com`
- URL: `https://na12.api.project44.com/services/rating/v1/rate-requests/{id}/cancellations`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `/api/v4/oauth2/token`
- TypeScript: <https://skmtc.dev/project44/apis/project44-rest-api/docs/services/rating/v1/rate-requests/:id/cancellations/post.ts> (a function with typed inputs; its response is checked against the schema)

Cancels a rate request. If a booking was in progress at the time of cancellation, it will also be cancelled and its bookingId is returned in the response. If a booking was already accepted by a carrier, a 409 is returned — the accepted booking cannot be cancelled. If the rate request is already cancelled, this call is idempotent and returns 200. This endpoint is feature-flagged; a 403 is returned if the feature is not enabled for the tenant.

## Path parameters

- `id` string, uuid, required

## Response `200`

Successful Response

- RateRequestCancellationConfirmation
  - `bookingId` string, uuid, nullable: The booking id, returned when a booking was in progress at the time of cancellation and was successfully cancelled.
  - `rateRequestId` string, uuid: The id of the cancelled rate request.

## Other responses

- `403`: Forbidden — feature not enabled for tenant, or caller is not a SHIPPER.
- `404`: Not Found — rate request does not exist.
- `409`: Conflict — a booking has already been accepted by a carrier and cannot be cancelled. The bookingId of the accepted booking is returned in the error body.

---

[API](https://skmtc.dev/project44/apis/project44-rest-api.md) - [All operations](https://skmtc.dev/project44/apis/project44-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/project44/apis/project44-rest-api/revisions/cdf9675e2294?raw)