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

Chilkat2 Java
import com.chilkatsoft.chilkat2.ChilkatException;
import com.chilkatsoft.chilkat2.Http;
import com.chilkatsoft.chilkat2.HttpResponse;
import com.chilkatsoft.chilkat2.JsonObject;
import com.chilkatsoft.chilkat2.StringBuilder;

public class ChilkatExample {

    public static void main(String[] args) {
        // This example assumes the Chilkat API to have been previously unlocked.
        // See Global Unlock Sample for sample code.

        Http http = new Http();

        // 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"
        // }

        JsonObject json = new JsonObject();
        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");

        HttpResponse resp = new HttpResponse();
        try {
            http.httpJson("POST", "https://api.goshippo.com/transactions/", json, "application/json", resp);
        } catch (ChilkatException e) {
            System.out.println(e.getLastErrorText());
            return;
        }

        StringBuilder sbResponseBody = new StringBuilder();
        resp.getBodySb(sbResponseBody);
        JsonObject jResp = new JsonObject();
        jResp.loadSb(sbResponseBody);
        jResp.setEmitCompact(false);

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

        int respStatusCode = resp.getStatusCode();
        System.out.println("Response Status Code = " + respStatusCode);
        if (respStatusCode >= 400) {
            System.out.println("Response Header:");
            System.out.println(resp.getHeader());
            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.setI(i);
            i = i + 1;
        }
    }
}