Delivery Confirmation

Carriers allow you to set the confirmation level of a package, these vary from carrier to carrier. The majority of carriers support at least the following delivery confirmations.

Common Confirmation Types

Confirmation Type Description
none No confirmation requested.
delivery Delivery confirmation is requested.
signature Signature is required for the shipment to be delivered; this signature may be a neighbor, building manager, or the recipient can authorize the release of the package (without being present).
adult_signature An adult signature is required for the shipment to be delivered.
direct_signature A signature of somebody at the address is required. This confirmation is only supported by FedEx.
delivery_mailed Receive a delivery confirmation via mail. Currently only supported for UPS. There's a $2 charge for this service.

Tip

Check Your Carrier

Some carriers have special confirmations or don't support all confirmations; make sure you check the carrier documentation to make sure the carrier supports the confirmation you're requesting.

The confirmation property can be set while creating a label, or while requesting shipping rates.

Examples

POST /v1/labels
In the examples below, we've set the confirmation field to signature

Example Request
POST /v1/labels HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json

{
  "shipment": {
    "service_code": "usps_priority_mail",
    "ship_to": {
      "name": "Amanda Miller",
      "phone": "555-555-5555",
      "address_line1": "525 S Winchester Blvd",
      "city_locality": "San Jose",
      "state_province": "CA",
      "postal_code": "95128",
      "country_code": "US",
      "address_residential_indicator": "yes"
    },
    "ship_from": {
      "company_name": "Example Corp.",
      "name": "John Doe",
      "phone": "111-111-1111",
      "address_line1": "4009 Marathon Blvd",
      "address_line2": "Suite 300",
      "city_locality": "Austin",
      "state_province": "TX",
      "postal_code": "78756",
      "country_code": "US",
      "address_residential_indicator": "no"
    },
    "confirmation": "signature",
    "packages": [
      {
        "weight": {
          "value": 1.0,
          "unit": "ounce"
        }
      }
    ]
  }
}
Example Response
{
  "label_id": "se-test-202906976",
  "status": "processing",
  "shipment_id": "se-202906976",
  "ship_date": "2019-07-25T05:00:00.000Z",
  "created_at": "2019-07-25T15:24:46.657Z",
  "shipment_cost": {
    "currency": "usd",
    "amount": 0.0
  },
  "insurance_cost": {
    "currency": "usd",
    "amount": 0.0
  },
  "tracking_number": "9999999999999",
  "is_return_label": false,
  "is_international": false,
  "batch_id": "",
  "carrier_id": "se-0",
  "service_code": "usps_priority_mail",
  "package_code": "package",
  "voided": false,
  "voided_at": null,
  "label_format": "pdf",
  "label_layout": "4x6",
  "trackable": true,
  "carrier_code": "stamps_com",
  "tracking_status": "unknown",
  "label_download": {
    "pdf": "https://api.shipengine.com/v1/downloads/6/Q2OLdnGaqk-UzkN6pFH0lg/testlabel-202923521.pdf",
    "png": "https://api.shipengine.com/v1/downloads/6/Q2OLdnGaqk-UzkN6pFH0lg/testlabel-202923521.png",
    "zpl": "https://api.shipengine.com/v1/downloads/6/Q2OLdnGaqk-UzkN6pFH0lg/testlabel-202923521.zpl",
    "href": "https://api.shipengine.com/v1/downloads/6/Q2OLdnGaqk-UzkN6pFH0lg/testlabel-202923521.pdf"
  },
  "form_download": null,
  "insurance_claim": null
}

Info

Price Check Your Rate

The type of confirmation you request may change the price of your label.