Quality Collaboration API

Integrate your external quality management systems to collaborate on quality inspections.

Quality Collaboration allows you to use Coupa as the central collaboration point for quality inspections, particularly supplier-performed inspections.

This API enables you to:

Import or trigger new quality inspection requests.
Receive the final inspection results and status after the buyer and supplier collaboration process is complete.
Manage attachments related to the inspection and its characteristics.

The quality inspection process uses APIs for both inbound and outbound data flow:

Send a POST request to create a new, open Quality Inspection in Coupa.
Buyers and and suppliers collaborate using the Coupa UI and CSP, exchanging comments, filling results, and uploading attachments.
Once the buyer accepts or rejects the inspection, use a GET request to read the final status and resolution.

Note:

This API is available only for customers that participate in the Early Access Program (EAP). If you want to be an EAP customer, contact your Coupa representative.

Actions


Verb	Path	Description
GET	`/api/quality_inspections`	Get all quality inspections
GET	`/api/quality_inspections/{id}`	Get details of a quality inspection
POST	`/api/v1/quality_inspections`	Create a new quality inspection
POST	`api/quality_inspections/{id}/exported`	Mark a quality inspection as exported
POST	`/api/quality_inspections/{id}/reset-exported`	Reset exported flag of a quality inspection
GET	`/api/quality_inspections/{inspection_id}/attachments`	Get all attachments for an inspection (Header)
POST	`/api/quality-inspections/{inspection_id}/attachments`	Add a new attachment at the inspection level (Header)
GET	`/api/quality_inspections/{inspection_id}/characteristics/{characteristic_id}/attachments/{attachment_id}`	Get a specific attachment for a characteristic
GET	`/api/quality_inspections/{inspection_id}/attachments/{attachment_id}`	Get a specific attachment of a quality inspection
DELETE	`/api/quality_inspections/{inspection_id}/attachments/{attachment_id}`	Delete an attachment at the inspection level (Header)
GET	`/api/quality_inspections/{inspection_id}/characteristics/{characteristic_id}/attachments`	Get all attachments for a characteristic (Line)
POST	`/api/v1/quality_inspections/{inspection_id}/characteristics/{characteristic_id}/attachments`	Add a new attachment at the characteristic level (Line)
DELETE	`/api/quality_inspections/{inspection_id}/characteristics/{characteristic_id}/attachments/{attachment_id}`	Delete an attachment at the characteristic level (Line)

Scopes

This API requires the following scopes:

quality_collaboration.quality_inspection.read
quality_collaboration.quality_inspection.write

Elements


Element	Description	Req'd	Unique	Allowable Value	In	Out	Data Type
id	Inspection ID.	no	no		no	yes	integer
type	Type of inspection.	no		Inspection	yes	yes	string
status	Status of the inspection.	no		Open In Buyer Review In Progress Closed	no	yes	string
reviewDecision	Decision made in the review.	no		Accepted Rejected	no	yes	string
resolutionReasonText	Resolution reason text.	no			no	yes	string
resolutionReasonType	Resolution reason type.	no			no	yes	string
resolutionReasonCode	Resolution reason code.	no			no	yes	string
requestDate	Date of the request.	no			yes	yes	datetime
dueDate	Due date.	yes			yes	yes	datetime
supplierId	ID of the supplier.	yes			yes	yes	integer
itemId	ID of the item.	no			yes	yes	integer
itemName	Name of the item.	no			yes	yes	string
itemDescription	Item description.	no			yes	yes	string
warehouseId	Warehouse ID.	no			no	yes	integer
buyerBatchNumber	Buyer batch number.	no			yes	yes	string
supplierPartNumber	Supplier part number.	no			yes	yes	string
buyerPartNumber	Buyer part number.	no			yes	yes	string
itemQuantity	Item quantity.	yes			yes	yes	integer
sampleSize	Sample size.	no			yes	yes	integer
uom	Unit of measure.	yes			yes	yes	integer
requestedBy	User who requested the inspection.	yes			yes	yes	integer
refDocumentType	Document type.	no		Purchase Order	yes	yes	string
refDocumentId	Document ID.	no			yes	yes	string
refDocumentItem	Document item.	no			yes	yes	string
reviewedDate	Date of the review	no			no	yes	datetime
reviewedBy	User who reviewed.	no			no	yes	string
submittedDate	Date submitted.	no			no	yes	datetime
submittedBy	User who submitted.	no			no	yes	string
externalInspectionId	ID of the external inspection.	no			yes	yes	string
createdAt	When the inspection was created.	no			no	yes	datetime
createdBy	User who created the inspection.	no			no	yes	integer
modifiedAt	Date modified.	no			no	yes	datetime
modifiedBy	User who modified.	no			no	yes	integer
exported	Whether the record is exported.	no			no	yes	boolean
characteristics	Characteristic records associated with the inspection.	no			yes	yes	Characteristic

Get a quality inspection

Method

GET /api/quality_inspections/{id}

Example cURL request

curl --location 'https://<your-instance>.com/api/quality_inspections/1' \
--header 'Accept: application/json' \
--header 'Accept: application/xml' \
--header 'Authorization: ••••••'

Example response

{
    "id": 1,
    "type": "Inspection",
    "status": "Closed",
    "resolutionReasonText": "accepted",
    "dueDate": "2025-11-20T10:00:00Z",
    "supplierId": 1,
    "itemId": 1,
    "itemName": "Inspection Material",
    "itemDescription": "Inspection material",
    "supplierPartNumber": "SLNG-123",
    "buyerPartNumber": "BLNG-123",
    "itemQuantity": 50.000000,
    "uom": 1,
    "requestedBy": 10,
    "refDocumentType": "Purchase Order",
    "refDocumentId": "EXTPO_003",
    "refDocumentItem": "0010",
    "createdAt": "2025-11-04T16:07:02Z",
    "modifiedAt": "2025-11-04T16:17:49Z",
    "exported": false,
    "characteristics": [
        {
            "id": 1,
            "lineNum": 1,
            "inspectionId": 1,
            "name": "Color",
            "type": "required",
            "isQuantitative": false,
            "specification": "Clear colourless ",
            "valueType": "choice",
            "characteristicValues": [
                {
                    "id": 1,
                    "characteristicId": 1,
                    "code": "1",
                    "domain": "COLOR",
                    "value": "Yellow"
                },
                {
                    "id": 2,
                    "characteristicId": 1,
                    "code": "2",
                    "domain": "COLOR",
                    "value": "light yellow"
                },
                {
                    "id": 3,
                    "characteristicId": 1,
                    "code": "3",
                    "domain": "COLOR",
                    "value": "No colour"
                }
            ],
            "expectedResults": {
                "id": 1,
                "characteristicId": 1,
                "numericValue": 3.000000000
            },
            "expectedLimits": [],
            "recordedCharacteristic": {
                "id": 1,
                "characteristicId": 1,
                "code": "1"
            }
        },
        {
            "id": 2,
            "lineNum": 2,
            "inspectionId": 1,
            "name": "Non-volatile residue",
            "type": "required",
            "isQuantitative": true,
            "specification": "Not more than 0.1%",
            "valueType": "numeric",
            "characteristicValues": [],
            "expectedResults": {
                "id": 2,
                "characteristicId": 2,
                "numericValue": 0.320000000,
                "valuePrecision": 2
            },
            "expectedLimits": [
                {
                    "id": 1,
                    "characteristicId": 2,
                    "limitType": "min",
                    "comparisonOperator": "gt",
                    "comparisonValue": 0.000000
                },
                {
                    "id": 2,
                    "characteristicId": 2,
                    "limitType": "max",
                    "comparisonOperator": "lt",
                    "comparisonValue": 0.100000
                }
            ],
            "recordedCharacteristic": {
                "id": 2,
                "characteristicId": 2,
                "numericValue": 0.050000000
            }
        },
        {
            "id": 3,
            "lineNum": 3,
            "inspectionId": 1,
            "name": "Reducing substances",
            "type": "required",
            "isQuantitative": true,
            "specification": "Not more than 70 mg/kg as sulfur dioxide",
            "valueType": "numeric",
            "characteristicValues": [],
            "expectedResults": {
                "id": 3,
                "characteristicId": 3,
                "numericValue": 55.000000000,
                "valuePrecision": 2
            },
            "expectedLimits": [
                {
                    "id": 3,
                    "characteristicId": 3,
                    "limitType": "min",
                    "comparisonOperator": "gt",
                    "comparisonValue": 0.000000
                },
                {
                    "id": 4,
                    "characteristicId": 3,
                    "limitType": "max",
                    "comparisonOperator": "lt",
                    "comparisonValue": 70.000000
                }
            ],
            "recordedCharacteristic": {
                "id": 3,
                "characteristicId": 3,
                "numericValue": 69.000000000
            }
        }
    ]
}

Create a quality inspection