GET /declarations/prohibited-items
Every booking and ship run must confirm { accepted: true, version } for the current version, after your shop has shown it to whoever books. A changed version makes older confirmations fail with 409 PROHIBITED_ITEMS_DECLARATION_REQUIRED. Any valid key; no scope.
Node.js cURL PHP Python
Copy Request
import { QoeneDelivery } from '@qoene/delivery' ;
const qoene = new QoeneDelivery({ apiKey: process.env.QOENE_API_KEY! });
const { declaration } = await qoene.declarations.prohibitedItems();curl https://api.qoenedelivery.com/v1/declarations/prohibited-items \
-H "Authorization: Bearer $QOENE_API_KEY" <?php
require 'vendor/autoload.php' ; // composer require guzzlehttp/guzzle
$client = new GuzzleHttp\Client([
'base_uri' => 'https://api.qoenedelivery.com/v1/' ,
'headers' => ['Authorization' => 'Bearer ' . getenv('QOENE_API_KEY' )],
'timeout' => 30 ,
]);
$response = $client ->get('declarations/prohibited-items' );
$data = json_decode((string) $response ->getBody(), true )['data' ];import os
import requests
response = requests.get(
"https://api.qoenedelivery.com/v1/declarations/prohibited-items" ,
headers={
"Authorization" : f"Bearer {os.environ['QOENE_API_KEY']}" ,
},
timeout=30 ,
)
response.raise_for_status()
data = response.json()["data" ]Response 200 Copy {
"status" : "success" ,
"data" : {
"declaration" : {
"version" : "2026-10-v1" ,
"title" : "Prohibited and restricted items" ,
"body" : "I confirm this parcel contains no prohibited items…" ,
"publishedAt" : "2026-10-01T00:00:00.000Z"
}
}
}# RequestNo parameters.
# ResponseSuccess responses Status Meaning 200The declaration in force
The body is { "status": "success", "data": … }. Fields of data (DeclarationResult ):
Response data Field Type Description declarationRequired object↳ versionRequired stringSend this as prohibitedItemsDeclaration.version. ↳ titleRequired string↳ bodyRequired stringThe text to show before confirming. ↳ publishedAtOptional string (date-time)
# ErrorsErrors use the error envelope { "status": "error", "message", "code"?, "details"? }.
Error responses Status When 401Missing, invalid, expired or revoked API key. The API key is missing, invalid, expired or revoked. 429Too many requests. See the RateLimit headers. Too many requests. Wait for Retry-After, then retry with the same idempotency key.