Supplier Delete Guide

Latest Update Time: 2026-07-02 00:00:00

Use this API to permanently delete one or more suppliers.

See the Supplier Introduction for base URL, authentication, and required headers.

Endpoint

DELETE https://ppapi.qima.com/user/v2/{userId}/suppliers/{supplierIds}

Prerequisites

In addition to the required headers and authentication setup:

Permission to delete suppliers for the target client
The supplier must not be in use by any existing order (see Common Errors below)

Path Parameters

Parameter	Required	Description
`userId`	Yes	QIMA client user login ID.
`supplierIds`	Yes	One or more supplier IDs to delete, comma-separated (e.g. `id_1,id_2,id_3`).

Request Example

curl --location --request DELETE 'https://ppapi.qima.com/user/v2/<qima-user-id>/suppliers/<supplier-id-1>,<supplier-id-2>' \
  --header 'Ai-Api-Access-Token: {your api access token}' \
  --header 'Ai-User-Id: {your user ID}' \
  --header 'Authorization: Bearer {your token}' \
  --header 'Referer: https://preprodmy.qima.com/'

Successful Response

HTTP 200 OK with content: true means all given suppliers were deleted.

{
    "message": null,
    "content": true
}

Supplier In Use

If any of the given suppliers is referenced by an existing order, the deletion is rejected — note this is still an HTTP 200 response, not an error status:

{
    "message": "SUPPLIER_IN_USE",
    "content": false
}

Always check content (not just the HTTP status) to confirm the deletion actually succeeded.

Common Errors

See common authentication errors for 401 and 403 responses.

Next Steps

Use Search Suppliers to confirm the supplier(s) were removed.

Documents