> This page is for API, version 2026-01-01 (Stable) (default). > For other versions, use one of these documentation indexes: > - 2026-01-01 (Stable) (default): https://developer.deel.com/api/stable/llms.txt > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://developer.deel.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer.deel.com/_mcp/server. # Approve or reject quotes on a clearance request POST https://api.letsdeel.com/rest/it/clearance-requests/{clearance_request_id}/decide Content-Type: application/json Approves or rejects each item in a clearance request that is `PENDING_DECISION`. Every request item currently in the clearance request must be included in the payload. When every item is rejected the clearance request is cancelled. Accepted items move on to collection and hand-off to the clearance partner. **Token scopes**: `it-service-requests:write` **Beta**: this version requires the `X-Beta: true` request header and its contract may change before it is promoted to stable. It is scheduled to become stable on 2026-12-17. Reference: https://developer.deel.com/api/reference/endpoints/clearance-requests/decide-a-clearance-request-v-2026-09-17 ## Authentication - `Authorization` header (bearer token, required) — ## Authentication The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail. ```curl curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/authentication) - `Authorization` header (bearer token, required) — Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/ ## Servers - `https://api.letsdeel.com/rest` (Production, default) - `https://api-staging.letsdeel.com/rest` (Demo) ## Request ### Path parameters - `clearance_request_id` (string, required) — Unique identifier of the clearance request ### Headers - `X-Beta` (enum, required, default: true) — Opts in to the beta version of this endpoint. Must be `true`. - Allowed values: `true` ### Body (application/json) This endpoint expects an object. - `data` (ItClearanceRequestsClearanceRequestIdDecidePostRequestBodyContentApplicationJsonSchemaData, required) ## Response ### 200 OK - `data` (ItClearanceRequestsClearanceRequestIdDecidePostResponsesContentApplicationJsonSchemaData, required) ## Errors ### 400 Bad Request Error Bad Request - `errors` (list of ItClearanceRequestsClearanceRequestIdDecidePostResponsesContentApplicationJsonSchemaErrorsItems, required) ### 401 Unauthorized Error Unauthorized - `errors` (list of ItClearanceRequestsClearanceRequestIdDecidePostResponsesContentApplicationJsonSchemaErrorsItems, required) ### 403 Forbidden Error Forbidden - `errors` (list of ItClearanceRequestsClearanceRequestIdDecidePostResponsesContentApplicationJsonSchemaErrorsItems, required) ### 404 Not Found Error Not Found - `errors` (list of ItClearanceRequestsClearanceRequestIdDecidePostResponsesContentApplicationJsonSchemaErrorsItems, required) ### 409 Conflict Error Conflict - `errors` (list of ItClearanceRequestsClearanceRequestIdDecidePostResponsesContentApplicationJsonSchemaErrorsItems, required) ### 422 Unprocessable Entity Error Unprocessable Entity - `errors` (list of ItClearanceRequestsClearanceRequestIdDecidePostResponsesContentApplicationJsonSchemaErrorsItems, required) ### 500 Internal Server Error Internal Server Error - `errors` (list of ItClearanceRequestsClearanceRequestIdDecidePostResponsesContentApplicationJsonSchemaErrorsItems, required) ## Types ### ItClearanceRequestsClearanceRequestIdDecidePostRequestBodyContentApplicationJsonSchemaData - `items` (list of ItClearanceRequestsClearanceRequestIdDecidePostRequestBodyContentApplicationJsonSchemaDataItemsItems, required) — Decisions on each request item in the clearance request. Every request item in the clearance request must be included; otherwise the endpoint returns a `clearance_request_items_undecided` error. ### ItClearanceRequestsClearanceRequestIdDecidePostResponsesContentApplicationJsonSchemaData - `id` (string, required) — Unique identifier of the clearance request - `status` (enum, required) — Current state of the clearance request - Allowed values: `CANCELLED`, `COMPLETED`, `DECIDED`, `PENDING_DECISION`, `PENDING_QUOTE`, `PENDING_RETURN` - `public_id` (string, required) — Public identifier of the clearance request - `created_at` (string, required) — Creation timestamp of the clearance request - `expires_at` (string, required, nullable) — Timestamp indicating when the request expires and the manager can no longer take action, absent when no deadline applies - `request_items` (list of ItClearanceRequestsClearanceRequestIdDecidePostResponsesContentApplicationJsonSchemaDataRequestItemsItems, required) — Items included in this clearance request, one per asset being cleared - `cancelled_reason` (enum, required, nullable) — Reason the clearance request was cancelled, absent unless the status is CANCELLED - Allowed values: `DEADLINE_EXCEEDED`, `REQUESTED_BY_CUSTOMER` ### ItClearanceRequestsClearanceRequestIdDecidePostResponsesContentApplicationJsonSchemaErrorsItems - `code` (string, required) — Error code of the handler which produced the returned error - `field` (string, required, nullable) — The field name where input validation failed - `message` (string, required) — Description of the returned error ### ItClearanceRequestsClearanceRequestIdDecidePostRequestBodyContentApplicationJsonSchemaDataItemsItems - `is_accepted` (boolean, required) — Whether the quote for this request item is accepted (`true`) or rejected (`false`). When every item is rejected the clearance request is cancelled. - `request_item_id` (string, required) — Unique identifier of the clearance request item the decision applies to ### ItClearanceRequestsClearanceRequestIdDecidePostResponsesContentApplicationJsonSchemaDataRequestItemsItems - `id` (string, required) — Unique identifier of the clearance request item - `asset` (ItClearanceRequestsClearanceRequestIdDecidePostResponsesContentApplicationJsonSchemaDataRequestItemsItemsAsset, required) — Asset being cleared as part of this clearance request item - `status` (enum, required) — Current state of the item within the clearance request lifecycle - Allowed values: `CANCELLED`, `CUSTOMER_ACCEPTED_QUOTE`, `CUSTOMER_REJECTED_QUOTE`, `PENDING_CUSTOMER_DECISION`, `PENDING_QUOTE`, `SKIPPED_QUOTE` - `quote_price` (ItClearanceRequestsClearanceRequestIdDecidePostResponsesContentApplicationJsonSchemaDataRequestItemsItemsQuotePrice, required, nullable) — Quote price offered by the clearance partner for the asset, absent until a quote is received ### ItClearanceRequestsClearanceRequestIdDecidePostResponsesContentApplicationJsonSchemaDataRequestItemsItemsAsset Asset being cleared as part of this clearance request item - `id` (string, required) — Unique identifier of the asset - `product` (ItClearanceRequestsClearanceRequestIdDecidePostResponsesContentApplicationJsonSchemaDataRequestItemsItemsAssetProduct, required) — Product details of the asset - `public_id` (string, required) — Public identifier of the asset - `serial_number` (string, required, nullable) — Asset serial number, absent when the manufacturer did not assign one ### ItClearanceRequestsClearanceRequestIdDecidePostResponsesContentApplicationJsonSchemaDataRequestItemsItemsQuotePrice Quote price offered by the clearance partner for the asset, absent until a quote is received - `amount` (string, required) — Amount - `currency` (enum, required) — Three-letter currency code for the price - Allowed values: `AED`, `AFN`, `ALL`, `AMD`, `ANG`, `AOA`, `ARS`, `AUD`, `AWG`, `AZN`, `BAM`, `BDT`, `BGN`, `BHD`, `BIF`, `BMD`, `BOB`, `BRL`, `BSD`, `BTN`, `BWP`, `BYN`, `BZD`, `CAD`, `CDF`, `CHF`, `CLP`, `CNY`, `COP`, `CRC`, `CUC`, `CVE`, `CZK`, `DJF`, `DKK`, `DOP`, `DZD`, `EGP`, `ERN`, `ETB`, `EUR`, `FJD`, `FKP`, `GBP`, `GEL`, `GHS`, `GIP`, `GMD`, `GNF`, `GTQ`, `GYD`, `HKD`, `HNL`, `HRK`, `HTG`, `HUF`, `IDR`, `ILS`, `INR`, `IQD`, `IRR`, `ISK`, `JMD`, `JOD`, `JPY`, `KES`, `KGS`, `KHR`, `KMF`, `KPW`, `KRW`, `KWD`, `KYD`, `KZT`, `LAK`, `LBP`, `LKR`, `LRD`, `LSL`, `LTL`, `LYD`, `MAD`, `MDL`, `MGA`, `MKD`, `MMK`, `MNT`, `MRU`, `MUR`, `MVR`, `MWK`, `MXN`, `MYR`, `MZN`, `NAD`, `NGN`, `NIO`, `NOK`, `NPR`, `NZD`, `OMR`, `PAB`, `PEN`, `PGK`, `PHP`, `PKR`, `PLN`, `PYG`, `QAR`, `RON`, `RSD`, `RUB`, `RWF`, `SAR`, `SBD`, `SCR`, `SDG`, `SEK`, `SGD`, `SHP`, `SLL`, `SOS`, `SRD`, `SSP`, `STD`, `SYP`, `SZL`, `THB`, `TJS`, `TMT`, `TND`, `TOP`, `TRY`, `TTD`, `TWD`, `TZS`, `UAH`, `UGX`, `USD`, `UYU`, `UZS`, `VEF`, `VND`, `VUV`, `WST`, `XAF`, `XCD`, `XOF`, `XPF`, `YER`, `ZAR`, `ZMW`, `ZWD` ### ItClearanceRequestsClearanceRequestIdDecidePostResponsesContentApplicationJsonSchemaDataRequestItemsItemsAssetProduct Product details of the asset - `id` (string, required) — Unique identifier of the product - `name` (string, required) — Product name - `brand` (string, required) — Product brand - `category` (enum, required) — Product category - Allowed values: `ADAPTER`, `CABLE`, `CHAIR`, `CHARGER`, `COMPACT_DESKTOP`, `DESK`, `DESKTOP`, `DESK_RISER`, `DESK_TIDY`, `DOCKING_STATION`, `DONGLE`, `FOOTREST`, `HEADSET`, `KEYBOARD`, `LAPTOP`, `LAPTOP_STAND`, `MICE_TRACKPAD`, `MOBILE_DEVICE`, `MONITOR`, `MONITOR_ARM`, `OTHER`, `PRINTER`, `SHREDDER`, `STANDING_MAT`, `TABLET`, `TASK_LIGHT`, `WEBCAM`, `WELCOME_PACK`, `WIFI_RANGE_EXTENDER` ## Examples **Request** ```json { "data": { "items": [ { "is_accepted": true, "request_item_id": "550e8400-e29b-41d4-a716-446655440000" } ] } } ``` **Response** ```json { "data": { "id": "550e8400-e29b-41d4-a716-446655440000", "status": "PENDING_QUOTE", "public_id": "CLR-550E8400", "created_at": "2025-08-08T09:49:01.000Z", "expires_at": "2025-08-22T09:49:01.000Z", "request_items": [ { "id": "550e8400-e29b-41d4-a716-446655440000", "asset": { "id": "550e8400-e29b-41d4-a716-446655440000", "product": { "id": "550e8400-e29b-41d4-a716-446655440000", "name": "MacBook Pro", "brand": "Apple", "category": "LAPTOP" }, "public_id": "ITM-550E8400", "serial_number": "SN123456" }, "status": "PENDING_QUOTE", "quote_price": { "amount": "1999.99", "currency": "EUR" } } ], "cancelled_reason": "REQUESTED_BY_CUSTOMER" } } ``` **SDK Code** ```python import requests url = "https://api.letsdeel.com/rest/it/clearance-requests/550e8400-e29b-41d4-a716-446655440000/decide" payload = { "data": { "items": [ { "is_accepted": True, "request_item_id": "550e8400-e29b-41d4-a716-446655440000" } ] } } headers = { "X-Beta": "true", "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://api.letsdeel.com/rest/it/clearance-requests/550e8400-e29b-41d4-a716-446655440000/decide'; const options = { method: 'POST', headers: { 'X-Beta': 'true', Authorization: 'Bearer ', 'Content-Type': 'application/json' }, body: '{"data":{"items":[{"is_accepted":true,"request_item_id":"550e8400-e29b-41d4-a716-446655440000"}]}}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.letsdeel.com/rest/it/clearance-requests/550e8400-e29b-41d4-a716-446655440000/decide" payload := strings.NewReader("{\n \"data\": {\n \"items\": [\n {\n \"is_accepted\": true,\n \"request_item_id\": \"550e8400-e29b-41d4-a716-446655440000\"\n }\n ]\n }\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("X-Beta", "true") req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://api.letsdeel.com/rest/it/clearance-requests/550e8400-e29b-41d4-a716-446655440000/decide") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["X-Beta"] = 'true' request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"data\": {\n \"items\": [\n {\n \"is_accepted\": true,\n \"request_item_id\": \"550e8400-e29b-41d4-a716-446655440000\"\n }\n ]\n }\n}" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.letsdeel.com/rest/it/clearance-requests/550e8400-e29b-41d4-a716-446655440000/decide") .header("X-Beta", "true") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"data\": {\n \"items\": [\n {\n \"is_accepted\": true,\n \"request_item_id\": \"550e8400-e29b-41d4-a716-446655440000\"\n }\n ]\n }\n}") .asString(); ``` ```php request('POST', 'https://api.letsdeel.com/rest/it/clearance-requests/550e8400-e29b-41d4-a716-446655440000/decide', [ 'body' => '{ "data": { "items": [ { "is_accepted": true, "request_item_id": "550e8400-e29b-41d4-a716-446655440000" } ] } }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', 'X-Beta' => 'true', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.letsdeel.com/rest/it/clearance-requests/550e8400-e29b-41d4-a716-446655440000/decide"); var request = new RestRequest(Method.POST); request.AddHeader("X-Beta", "true"); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"data\": {\n \"items\": [\n {\n \"is_accepted\": true,\n \"request_item_id\": \"550e8400-e29b-41d4-a716-446655440000\"\n }\n ]\n }\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = [ "X-Beta": "true", "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = ["data": ["items": [ [ "is_accepted": true, "request_item_id": "550e8400-e29b-41d4-a716-446655440000" ] ]]] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.letsdeel.com/rest/it/clearance-requests/550e8400-e29b-41d4-a716-446655440000/decide")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```