Supplier Detail Guide

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

Use this API to retrieve full details for a specific supplier.

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

Endpoint

GET https://ppapi.qima.com/user/v2/{userId}/supplier/{supplierId}

Prerequisites

In addition to the required headers and authentication setup:

Permission to view suppliers for the target client
A supplierId obtained from Create a Supplier or Search Suppliers

Path Parameters

Parameter	Required	Description
`userId`	Yes	QIMA client user login ID.
`supplierId`	Yes	Supplier ID.

Request Example

curl --location --request GET 'https://ppapi.qima.com/user/v2/<qima-user-id>/supplier/<supplier-id>' \
  --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

Same shape as Create a Supplier's response.

{
    "message": null,
    "content": {
        "id": "A7B918B5222D4B0F98061168865EAF17",
        "entityName": "JiXieChang-Supplier2",
        "chineseName": "机械厂",
        "continent": "24865671",
        "country": "23424781",
        "province": "12578016",
        "city": "12687656",
        "district": null,
        "address": "NO.1, A ROAD, B STREET, C DISTRICT",
        "postcode": "518000",
        "nearestOffice": "Shenzhen office",
        "website": "https://www.example-supplier.com",
        "salesTurnover": "5000000",
        "noOfEmployees": "10",
        "userId": "4C6E94072DFC4918B60752F701DE544A",
        "type": "SUPPLIER",
        "businessLicenseNo": "91440300MA5XXXXXXX",
        "title": "Mr.",
        "addressCn": "深圳市南山区某路1号",
        "identificationCode": "CLIENT-SUP-002",
        "cityName": "Shenzhen",
        "districtName": null,
        "countryName": "China",
        "mainProductLines": ["bigCat1_s2", "bigCat1_s3"],
        "contactInfo": {
            "main": {
                "name": "Bill Gates",
                "department": "Quality",
                "title": "Quality Manager",
                "phone": "+86 0755 81112222",
                "mobile": "13811112222",
                "email": "aaa@bbb.com;ccc@ddd.com"
            },
            "alternate": {
                "name": "Jane Doe",
                "department": "Sales",
                "title": "Sales Manager",
                "phone": "+86 0755 83334444",
                "mobile": "13922223333",
                "email": "jane.doe@example.com"
            }
        },
        "accessMaps": [],
        "qualityDocs": [
            { "id": null, "docType": "", "fileName": null, "fileSize": 0, "url": null }
        ],
        "createBy": "",
        "updateBy": ""
    }
}

Response Field Notes

See Create a Supplier — this API returns the same SupplierDetailBean shape.

Common Errors

See common authentication errors for 401 and 403 responses.

Status	Meaning	Recommended Action
`404 Not Found`	No supplier found for the given `supplierId`.	Confirm `supplierId` is correct and belongs to the authenticated client.

Next Steps

Use Update a Supplier to change any of the returned fields.

Documents