curl --request POST \
--url https://panel.sendcloud.sc/api/v3/dsf/tickets/unjust-return \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"tracking_number": "3SABCD1234567",
"carrier_contract_id": 123,
"is_parcel_returned": true,
"additional_details": "The parcel was unjustly returned"
}
'import requests
url = "https://panel.sendcloud.sc/api/v3/dsf/tickets/unjust-return"
payload = {
"tracking_number": "3SABCD1234567",
"carrier_contract_id": 123,
"is_parcel_returned": True,
"additional_details": "The parcel was unjustly returned"
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
tracking_number: '3SABCD1234567',
carrier_contract_id: 123,
is_parcel_returned: true,
additional_details: 'The parcel was unjustly returned'
})
};
fetch('https://panel.sendcloud.sc/api/v3/dsf/tickets/unjust-return', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://panel.sendcloud.sc/api/v3/dsf/tickets/unjust-return",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'tracking_number' => '3SABCD1234567',
'carrier_contract_id' => 123,
'is_parcel_returned' => true,
'additional_details' => 'The parcel was unjustly returned'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://panel.sendcloud.sc/api/v3/dsf/tickets/unjust-return"
payload := strings.NewReader("{\n \"tracking_number\": \"3SABCD1234567\",\n \"carrier_contract_id\": 123,\n \"is_parcel_returned\": true,\n \"additional_details\": \"The parcel was unjustly returned\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Basic <encoded-value>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://panel.sendcloud.sc/api/v3/dsf/tickets/unjust-return")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"tracking_number\": \"3SABCD1234567\",\n \"carrier_contract_id\": 123,\n \"is_parcel_returned\": true,\n \"additional_details\": \"The parcel was unjustly returned\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://panel.sendcloud.sc/api/v3/dsf/tickets/unjust-return")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"tracking_number\": \"3SABCD1234567\",\n \"carrier_contract_id\": 123,\n \"is_parcel_returned\": true,\n \"additional_details\": \"The parcel was unjustly returned\"\n}"
response = http.request(request)
puts response.read_bodyCreate a ticket for an unjustly returned parcel
Create a ticket for an unjustly returned parcel. It works with both your own contract and parcels created using Sendcloud rates.
curl --request POST \
--url https://panel.sendcloud.sc/api/v3/dsf/tickets/unjust-return \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"tracking_number": "3SABCD1234567",
"carrier_contract_id": 123,
"is_parcel_returned": true,
"additional_details": "The parcel was unjustly returned"
}
'import requests
url = "https://panel.sendcloud.sc/api/v3/dsf/tickets/unjust-return"
payload = {
"tracking_number": "3SABCD1234567",
"carrier_contract_id": 123,
"is_parcel_returned": True,
"additional_details": "The parcel was unjustly returned"
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
tracking_number: '3SABCD1234567',
carrier_contract_id: 123,
is_parcel_returned: true,
additional_details: 'The parcel was unjustly returned'
})
};
fetch('https://panel.sendcloud.sc/api/v3/dsf/tickets/unjust-return', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://panel.sendcloud.sc/api/v3/dsf/tickets/unjust-return",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'tracking_number' => '3SABCD1234567',
'carrier_contract_id' => 123,
'is_parcel_returned' => true,
'additional_details' => 'The parcel was unjustly returned'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://panel.sendcloud.sc/api/v3/dsf/tickets/unjust-return"
payload := strings.NewReader("{\n \"tracking_number\": \"3SABCD1234567\",\n \"carrier_contract_id\": 123,\n \"is_parcel_returned\": true,\n \"additional_details\": \"The parcel was unjustly returned\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Basic <encoded-value>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://panel.sendcloud.sc/api/v3/dsf/tickets/unjust-return")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"tracking_number\": \"3SABCD1234567\",\n \"carrier_contract_id\": 123,\n \"is_parcel_returned\": true,\n \"additional_details\": \"The parcel was unjustly returned\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://panel.sendcloud.sc/api/v3/dsf/tickets/unjust-return")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"tracking_number\": \"3SABCD1234567\",\n \"carrier_contract_id\": 123,\n \"is_parcel_returned\": true,\n \"additional_details\": \"The parcel was unjustly returned\"\n}"
response = http.request(request)
puts response.read_bodyAuthorizations
Basic Authentication using API key and secrets is currently the main authentication mechanism.
Query Parameters
Set to true to force a portal claim. Supported for Colissimo, Chronopost, Colis Privé, Mondial Relay, InPost ES, and DHL Express carriers only. Requires a carrier contract setup.
Body
Data that is needed for creation of a ticket for own contract parcel and parcels created using Sendcloud rates is different. Please refer to relevant examples below.
- Own contract parcel
- Sendcloud rates parcel
Parcel tracking number
"3SABCD1234567"
The ID of the carrier contract associated with the parcel. Required when creating a ticket for a support only parcel that is not tracked in the Sendcloud system. The contract must belong to the authenticated user.
123
Has the returned parcel been received?
true
Description of the issue and additional information
"The parcel was unjustly returned"
Response
Accepted
Create ticket response