Claim

Use our API to mark trackings as claimed or unclaimed.

Details of how the Tracking Claim API can be used to mark trackings in the parcelLab system as claimed or unclaimed are described below.

Update trackings for claim status

post

Mark trackings as claimed or unclaimed through the parcelLab App to manage the claim status for shipments.

Authorizations

BearerAuthUserTokenAuthBasicAuth

AuthorizationstringRequired

JWT Bearer token authentication (preferred)

Query parameters

tracking_numberstringOptional

The tracking number (required if value is not passed in the request body)

courierstringOptional

Carrier code (required if value is not passed in the request body)

Header parameters

Content-Typestring · enumRequired

Must be application/json

Possible values:

Body

application/json

or

Responses

200

Request successful

application/json

400

Bad request

application/json

401

Unauthorized request

application/json

403

Insufficient permissions

application/json

post

/tracking-edit/claim

HTTPcURLJavaScriptPython

POST /tracking-edit/claim HTTP/1.1
Host: api.parcellab.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 88

{
  "tracking_number": "PCL10003456",
  "courier": "dhl",
  "claimed": true,
  "claimReason": "Damaged"
}

Mark tracking as claimedRemove claim status

{
  "message": "Accepted."
}

Claim Reasons

This section describes the global claim reason codes supported by the system. Custom values can also be used after they are added to your account.

Claim Reason	Description
RerouteFraud	Fraud claim for parcel rerouting.
ReturnsFraud	Fraud claim for abusing returns.
DeliveredButNotReceivedFraud	Fraud claim for parcels that were delivered but not received.
MissingItems	The parcel had missing items.
Damaged	The packaging or items were damaged.
NotReceived	The parcel was delivered but not received.
LostInTransit	The parcel was lost in transit.