Deliveries

Product Types

View as Markdown

The product_types object is included in the Create Delivery request body to declare whether the shipment contains regulated, restricted, or high-value goods. These flags are passed to downstream carriers and used by Rendr to enforce carrier eligibility, handling protocols, and compliance requirements at the point of booking.

Endpoint

POST {{domain}}/{{tenant_id}}/deliveries

Authentication: Bearer token required via the Authorization header.

Payload

product_types object
1{
2    "product_types": {
3        "alcohol": true,
4        "tobacco": true,
5        "cannabis": true,
6        "prescription_meds_s2": true,
7        "prescription_meds_s4": true,
8        "prescription_meds_s8": true,
9        "secure_documents": true,
10        "high_value": true,
11        "item_schedule_class": 2
12    }
13}

Field Definitions

FieldTypeDescription
alcoholBooleanIndicates the delivery contains alcoholic products. Rendr will only allocate carriers that hold an applicable liquor licence. Age verification at the point of delivery is enforced and passed to the carrier as a handling requirement.
tobaccoBooleanIndicates the delivery contains tobacco products. Carriers must satisfy applicable state and federal regulatory requirements for tobacco delivery. This flag is passed to downstream providers to trigger appropriate handling.
cannabisBooleanIndicates the delivery contains cannabis products, including medicinal cannabis. Allocation is restricted to carriers authorised to handle scheduled substances. Additional compliance and chain-of-custody requirements apply.
prescription_meds_s2BooleanIndicates the delivery contains Schedule 2 (Pharmacy Medicine) items — medicines available from a pharmacist without a prescription but subject to restrictions. Sets the applicable handling attributes with downstream providers.
prescription_meds_s4BooleanIndicates the delivery contains Schedule 4 (Prescription Only Medicine) items. Carriers must meet additional handling requirements and signature-on-delivery is typically enforced.
prescription_meds_s8BooleanIndicates the delivery contains Schedule 8 (Controlled Drug) items. Strict chain-of-custody requirements apply, including confirmed delivery and carrier-level compliance with controlled substance regulations.
secure_documentsBooleanIndicates the delivery contains sensitive or legally significant documents. Secure handling, confirmed delivery, and signature requirements are enforced to ensure the documents reach the intended recipient.
high_valueBooleanIndicates the delivery contains high-value items. Rendr will prioritise carriers with appropriate insurance coverage and enforce signature-on-delivery. The price_cents values on line_items are used to calculate the insured value of the shipment.
item_schedule_classNumberAn alternative to using the individual prescription_meds_s* boolean flags. Set this to the highest schedule classification number present in the delivery — e.g. 2 for S2, 4 for S4, 8 for S8. Rendr uses this value to apply the correct handling attributes with downstream providers.

item_schedule_class vs prescription_meds_s* flags

You can declare scheduled medications using either approach:

  • prescription_meds_s2 / prescription_meds_s4 / prescription_meds_s8 — set the individual boolean for each schedule class present in the delivery.
  • item_schedule_class — set a single numeric value representing the highest schedule class in the delivery.

Both approaches produce the same outcome. item_schedule_class is useful when your system already tracks schedule class as a numeric value, avoiding the need to map to boolean flags. If both are provided, item_schedule_class takes precedence.

If your delivery contains regulated goods and the appropriate product_types flags are not set, Rendr may allocate a carrier that is not authorised to handle those items. Always ensure these flags accurately reflect the contents of the delivery before submitting.