Verify Item

Developing

POST

https://app.gotreek.com/api/orders/{order}/items/{item}/verify

Last modified:2026-01-04 14:10:14

Verify a single order item by comparing its stored SKU with a scanned or typed SKU. Returns a rich payload with item status, per‑order verification summary and a can_confirm flag indicating if the order can be fully confirmed.

💡

Authentication

Bearer token authentication is required.

💡

Behavior

Validates that the given item belongs to the given order; otherwise returns a 404 error.

Compares the provided order_item_sku with the item’s stored sku (case‑insensitive).

Updates the item verification status (verified or mismatch), verification metadata and wrong attempt counter.

Returns a summary of all items’ verification statuses for the order and a can_confirm flag (true only if the order is pending and there are no pending or mismatch items).

Request

Authorization

OAuth 2.0

Client Credentials

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Token URL: https://app.gotreek.com/api/auth/login

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Body

🟢202

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://app.gotreek.com/api/orders//items//verify' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "order_item_sku": "string"
}'

Response Example

200 - Success

{
    "data": {
        "order_id": 50173,
        "item_id": 72896,
        "match": true,
        "item": {
            "id": 72896,
            "order_id": 50173,
            "name": "غطاء أيفون 15",
            "sku": "sk0111",
            "quantity": 2,
            "weight": 0,
            "weight_unit": null,
            "price": 7550,
            "total_price": null,
            "tax": null,
            "currency": "SAR",
            "created_at": "2025-12-26T09:18:05.000000Z",
            "updated_at": "2025-12-26T09:30:13.000000Z",
            "verification_status": "verified",
            "verified_at": "2025-12-26T09:30:13.644736Z",
            "verified_by": 33,
            "wrong_attempts": 1,
            "verification_note": null
        },
        "summary": {
            "total": 2,
            "verified": 1,
            "pending": 1,
            "mismatch": 0
        },
        "can_confirm": false
    },
    "message": "تم تأكيد العنصر."
}

Modified at 2026-01-04 14:10:14

Get Statuses

Verify Order