Decline an IT order

POST

/it/orders/:order_id/decline

POST

/rest/it/orders/:order_id/decline

curl -X POST https://api.letsdeel.com/rest/it/orders/123e4567-e89b-12d3-a456-426614174000/decline \
     -H "Authorization: Bearer <token>"

{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "user": {
      "emails": [
        "bruce.wayne@wayne-enterprise.com",
        "batman@gotham.com"
      ],
      "address": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "city": "Gotham",
        "type": "DELIVERY",
        "line1": "1007 Mountain Drive",
        "line2": "Stately Wayne Manor",
        "state": "New Jersey",
        "country": "US",
        "is_valid": true,
        "post_code": "12345",
        "phone_number": "+1-212-456-7890",
        "date_of_birth": "1997-12-18",
        "tax_id_number": "BAT123456",
        "passport_number": "P123456789",
        "delivery_instructions": "Use the Bat-Signal if urgent"
      },
      "last_name": "Wayne",
      "first_name": "Bruce",
      "hris_profile_id": "550e8400-e29b-41d4-a716-446655440000"
    },
    "status": "REQUESTED",
    "public_id": "ORD-550E8400",
    "created_at": "2025-08-08T09:49:01.000Z",
    "updated_at": "2025-08-08T09:49:01.000Z",
    "order_items": [
      {
        "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "status": "SHIPPED",
        "product": {
          "id": "550e8400-e29b-41d4-a716-446655440000",
          "name": "MacBook Pro",
          "brand": "Apple",
          "category": "LAPTOP"
        },
        "created_at": "2025-08-08T09:49:01.000Z",
        "is_approved": false,
        "pricing_details": {
          "asset_price": {
            "amount": "1999.99",
            "currency": "EUR"
          },
          "storefront_fee": {
            "amount": "1999.99",
            "currency": "EUR"
          },
          "acquisition_type": "PURCHASE"
        },
        "is_express_delivery_requested": true
      }
    ],
    "delivery_address": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "city": "Gotham",
      "type": "DELIVERY",
      "line1": "1007 Mountain Drive",
      "line2": "Stately Wayne Manor",
      "state": "New Jersey",
      "country": "US",
      "is_valid": true,
      "post_code": "12345",
      "phone_number": "+1-212-456-7890",
      "date_of_birth": "1997-12-18",
      "tax_id_number": "BAT123456",
      "passport_number": "P123456789",
      "delivery_instructions": "Use the Bat-Signal if urgent"
    }
  }
}

Declines an order that is awaiting approval (REQUESTED). On success the order moves to DECLINED, every item on it is marked as not approved, and no assignment or fulfilment is started. Declining is rejected with 409 when the order is not in REQUESTED status. The decision is final — a declined order cannot be approved afterwards.

Token scopes: it-orders:write

Declines an order that is awaiting approval (`REQUESTED`). On success the order moves to `DECLINED`, every item on it is marked as not approved, and no assignment or fulfilment is started. Declining is rejected with `409` when the order is not in `REQUESTED` status. The decision is final — a declined order cannot be approved afterwards. **Token scopes**: `it-orders:write`

Authentication

AuthorizationBearer

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 -X GET 'https://api.deel.training/rest/v2/contracts' \
  -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

## 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.deel.training/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/authentication)

AuthorizationBearer

Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Path parameters

order_idstringRequiredformat: "uuid"

Unique identifier of the IT order

Response

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

500

Internal Server Error