Sample code for 30+ languages & platforms
Java

Shippo Label Purchase

See more Shippo Examples

Demonstrates how to create a shipping label in one API call through Shippo.

Chilkat Java Downloads

Java
import com.chilkatsoft.*;

public class ChilkatExample {

  static {
    try {
        System.loadLibrary("chilkat");
    } catch (UnsatisfiedLinkError e) {
      System.err.println("Native code library failed to load.\n" + e);
      System.exit(1);
    }
  }

  public static void main(String argv[])
  {
    boolean success = false;

    // This example assumes the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    CkHttp http = new CkHttp();

    // Implements the following CURL command:

    // curl https://api.goshippo.com/transactions/  \
    //     -H "Authorization: ShippoToken <API_Token>" \
    //     -H "Content-Type: application/json"  \
    //     -d '{
    //         "shipment": {
    //             "address_from": {
    //                 "name": "Mr. Hippo",
    //                 "street1": "215 Clayton St.",
    //                 "city": "San Francisco",
    //                 "state": "CA",
    //                 "zip": "94117",
    //                 "country": "US",
    //                 "phone": "+1 555 341 9393",
    //                 "email": "support@goshippo.com"
    //             },
    //             "address_to": {
    //                 "name": "Mrs. Hippo",
    //                 "street1": "965 Mission St.",
    //                 "city": "San Francisco",
    //                 "state": "CA",
    //                 "zip": "94105",
    //                 "country": "US",
    //                 "phone": "+1 555 341 9393",
    //                 "email": "support@goshippo.com"
    //             },
    //             "parcels": [{
    //                 "length": "5",
    //                 "width": "5",
    //                 "height": "5",
    //                 "distance_unit": "in",
    //                 "weight": "2",
    //                 "mass_unit": "lb"
    //             }]
    //         },
    //         "carrier_account": "b741b99f95e841639b54272834bc478c",
    //         "servicelevel_token": "usps_priority"
    //         }'

    // Use this online tool to generate code from sample JSON:
    // Generate Code to Create JSON

    // The following JSON is sent in the request body.

    // {
    //   "shipment": {
    //     "address_from": {
    //       "name": "Mr. Hippo",
    //       "street1": "215 Clayton St.",
    //       "city": "San Francisco",
    //       "state": "CA",
    //       "zip": "94117",
    //       "country": "US",
    //       "phone": "+1 555 341 9393",
    //       "email": "support@goshippo.com"
    //     },
    //     "address_to": {
    //       "name": "Mrs. Hippo",
    //       "street1": "965 Mission St.",
    //       "city": "San Francisco",
    //       "state": "CA",
    //       "zip": "94105",
    //       "country": "US",
    //       "phone": "+1 555 341 9393",
    //       "email": "support@goshippo.com"
    //     },
    //     "parcels": [
    //       {
    //         "length": "5",
    //         "width": "5",
    //         "height": "5",
    //         "distance_unit": "in",
    //         "weight": "2",
    //         "mass_unit": "lb"
    //       }
    //     ]
    //   },
    //   "carrier_account": "b741b99f95e841639b54272834bc478c",
    //   "servicelevel_token": "usps_priority"
    // }

    CkJsonObject json = new CkJsonObject();
    json.UpdateString("shipment.address_from.name","Mr. Hippo");
    json.UpdateString("shipment.address_from.street1","215 Clayton St.");
    json.UpdateString("shipment.address_from.city","San Francisco");
    json.UpdateString("shipment.address_from.state","CA");
    json.UpdateString("shipment.address_from.zip","94117");
    json.UpdateString("shipment.address_from.country","US");
    json.UpdateString("shipment.address_from.phone","+1 555 341 9393");
    json.UpdateString("shipment.address_from.email","support@goshippo.com");
    json.UpdateString("shipment.address_to.name","Mrs. Hippo");
    json.UpdateString("shipment.address_to.street1","965 Mission St.");
    json.UpdateString("shipment.address_to.city","San Francisco");
    json.UpdateString("shipment.address_to.state","CA");
    json.UpdateString("shipment.address_to.zip","94105");
    json.UpdateString("shipment.address_to.country","US");
    json.UpdateString("shipment.address_to.phone","+1 555 341 9393");
    json.UpdateString("shipment.address_to.email","support@goshippo.com");
    json.UpdateString("shipment.parcels[0].length","5");
    json.UpdateString("shipment.parcels[0].width","5");
    json.UpdateString("shipment.parcels[0].height","5");
    json.UpdateString("shipment.parcels[0].distance_unit","in");
    json.UpdateString("shipment.parcels[0].weight","2");
    json.UpdateString("shipment.parcels[0].mass_unit","lb");
    json.UpdateString("carrier_account","b741b99f95e841639b54272834bc478c");
    json.UpdateString("servicelevel_token","usps_priority");

    http.SetRequestHeader("Authorization","ShippoToken <API_Token>");
    http.SetRequestHeader("Content-Type","application/json");

    CkHttpResponse resp = new CkHttpResponse();
    success = http.HttpJson("POST","https://api.goshippo.com/transactions/",json,"application/json",resp);
    if (success == false) {
        System.out.println(http.lastErrorText());
        return;
        }

    CkStringBuilder sbResponseBody = new CkStringBuilder();
    resp.GetBodySb(sbResponseBody);
    CkJsonObject jResp = new CkJsonObject();
    jResp.LoadSb(sbResponseBody);
    jResp.put_EmitCompact(false);

    System.out.println("Response Body:");
    System.out.println(jResp.emit());

    int respStatusCode = resp.get_StatusCode();
    System.out.println("Response Status Code = " + respStatusCode);
    if (respStatusCode >= 400) {
        System.out.println("Response Header:");
        System.out.println(resp.header());
        System.out.println("Failed.");
        return;
        }

    // Sample JSON response:
    // (Sample code for parsing the JSON response is shown below)

    // {
    //   "object_state": "VALID",
    //   "status": "SUCCESS",
    //   "object_created": "2013-12-27T19:14:48.273Z",
    //   "object_updated": "2013-12-27T19:14:48.273Z",
    //   "object_id": "64bba01845ef40d29374032599f22588",
    //   "object_owner": "shippotle@goshippo.com",
    //   "was_test": false,
    //   "rate": {
    //     "object_id": "cf6fea899f1848b494d9568e8266e076",
    //     "amount": "5.50",
    //     "currency": "USD",
    //     "amount_local": "5.50",
    //     "currency_local": "USD",
    //     "provider": "USPS",
    //     "servicelevel_name": "Priority Mail",
    //     "servicelevel_token": "usps_priority",
    //     "carrier_account": "078870331023437cb917f5187429b093"
    //   },
    //   "tracking_number": "ZW70QJC",
    //   "tracking_status": {
    //     "object_created": "2013-12-27T23:17:41.411Z",
    //     "object_id": "a21b3d6831c14ceaba6730179ce6e784",
    //     "status": "UNKNOWN",
    //     "status_details": "",
    //     "status_date": "2013-12-28T12:04:04.214Z"
    //   },
    //   "tracking_url_provider": "https://tools.usps.com/go/TrackConfirmAction.action?tLabels=ZW70QJC",
    //   "eta": "2013-12-30T12:00:00.000Z",
    //   "label_url": "https://shippo-delivery.s3.amazonaws.com/96.pdf?Signature=PEdWrp0mFWAGwJp7FW3b%2FeA2eyY%3D&Expires=1385930652&AWSAccessKeyId=AKIAJTHP3LLFMYAWALIA",
    //   "commercial_invoice_url": "",
    //   "metadata": "",
    //   "messages": [
    //   ]
    // }

    // Sample code for parsing the JSON response...
    // Use the following online tool to generate parsing code from sample JSON:
    // Generate Parsing Code from JSON

    String object_state = jResp.stringOf("object_state");
    String status = jResp.stringOf("status");
    String object_created = jResp.stringOf("object_created");
    String object_updated = jResp.stringOf("object_updated");
    String object_id = jResp.stringOf("object_id");
    String object_owner = jResp.stringOf("object_owner");
    boolean was_test = jResp.BoolOf("was_test");
    String rateObject_id = jResp.stringOf("rate.object_id");
    String rateAmount = jResp.stringOf("rate.amount");
    String rateCurrency = jResp.stringOf("rate.currency");
    String rateAmount_local = jResp.stringOf("rate.amount_local");
    String rateCurrency_local = jResp.stringOf("rate.currency_local");
    String rateProvider = jResp.stringOf("rate.provider");
    String rateServicelevel_name = jResp.stringOf("rate.servicelevel_name");
    String rateServicelevel_token = jResp.stringOf("rate.servicelevel_token");
    String rateCarrier_account = jResp.stringOf("rate.carrier_account");
    String tracking_number = jResp.stringOf("tracking_number");
    String tracking_statusObject_created = jResp.stringOf("tracking_status.object_created");
    String tracking_statusObject_id = jResp.stringOf("tracking_status.object_id");
    String tracking_statusStatus = jResp.stringOf("tracking_status.status");
    String tracking_statusStatus_details = jResp.stringOf("tracking_status.status_details");
    String tracking_statusStatus_date = jResp.stringOf("tracking_status.status_date");
    String tracking_url_provider = jResp.stringOf("tracking_url_provider");
    String eta = jResp.stringOf("eta");
    String label_url = jResp.stringOf("label_url");
    String commercial_invoice_url = jResp.stringOf("commercial_invoice_url");
    String metadata = jResp.stringOf("metadata");
    int i = 0;
    int count_i = jResp.SizeOfArray("messages");
    while (i < count_i) {
        jResp.put_I(i);
        i = i+1;
        }
  }
}