Back to Collection Items
#include <C_CkHttp.h>
#include <C_CkJsonObject.h>
#include <C_CkHttpResponse.h>
#include <C_CkStringBuilder.h>
void ChilkatSample(void)
{
HCkHttp http;
BOOL success;
HCkJsonObject json;
HCkHttpResponse resp;
HCkStringBuilder sbResponseBody;
HCkJsonObject jResp;
int respStatusCode;
const char *Status;
const char *Name;
const char *Phone;
const char *Company_name;
const char *Address_line1;
const char *Address_line2;
const char *Address_line3;
const char *City_locality;
const char *State_province;
const char *Postal_code;
const char *Country_code;
const char *Address_residential_indicator;
const char *Matched_addressName;
const char *Matched_addressPhone;
const char *Matched_addressCompany_name;
const char *Matched_addressAddress_line1;
const char *Matched_addressAddress_line2;
const char *Matched_addressAddress_line3;
const char *Matched_addressCity_locality;
const char *Matched_addressState_province;
const char *Matched_addressPostal_code;
const char *Matched_addressCountry_code;
const char *Matched_addressAddress_residential_indicator;
const char *shipment_id;
const char *carrier_id;
const char *service_code;
const char *external_shipment_id;
const char *ship_date;
const char *created_at;
const char *modified_at;
const char *shipment_status;
const char *ship_toName;
const char *ship_toPhone;
const char *ship_toCompany_name;
const char *ship_toAddress_line1;
const char *ship_toAddress_line2;
const char *ship_toAddress_line3;
const char *ship_toCity_locality;
const char *ship_toState_province;
const char *ship_toPostal_code;
const char *ship_toCountry_code;
const char *ship_toAddress_residential_indicator;
const char *ship_fromName;
const char *ship_fromPhone;
const char *ship_fromCompany_name;
const char *ship_fromAddress_line1;
const char *ship_fromAddress_line2;
const char *ship_fromAddress_line3;
const char *ship_fromCity_locality;
const char *ship_fromState_province;
const char *ship_fromPostal_code;
const char *ship_fromCountry_code;
const char *ship_fromAddress_residential_indicator;
const char *warehouse_id;
const char *return_toName;
const char *return_toPhone;
const char *return_toCompany_name;
const char *return_toAddress_line1;
const char *return_toAddress_line2;
const char *return_toAddress_line3;
const char *return_toCity_locality;
const char *return_toState_province;
const char *return_toPostal_code;
const char *return_toCountry_code;
const char *return_toAddress_residential_indicator;
const char *confirmation;
const char *customs;
const char *external_order_id;
const char *order_source_code;
const char *Bill_to_account;
const char *Bill_to_country_code;
const char *Bill_to_party;
const char *Bill_to_postal_code;
BOOL Contains_alcohol;
BOOL Delivered_duty_paid;
BOOL Non_machinable;
BOOL Saturday_delivery;
BOOL Dry_ice;
const char *Dry_ice_weight;
const char *Freight_class;
const char *Custom_field1;
const char *Custom_field2;
const char *Custom_field3;
const char *insurance_provider;
int Value;
const char *Unit;
int j;
int count_j;
const char *package_code;
int weightValue;
const char *weightUnit;
const char *dimensionsUnit;
int Length;
int Width;
int Height;
const char *v_Currency;
int Amount;
const char *Reference1;
const char *Reference2;
const char *Reference3;
const char *external_package_id;
BOOL has_errors;
int i;
int count_i;
// This example assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.
http = CkHttp_Create();
// Use this online tool to generate code from sample JSON: Generate Code to Create JSON
// The following JSON is sent in the request body.
// {
// "shipments": [
// {
// "validate_address": "validate_and_clean",
// "service_code": "usps_priority_mail",
// "ship_from": {
// "name": "John Doe",
// "company_name": "Example Corp.",
// "address_line1": "4009 Marathon Blvd",
// "city_locality": "Austin",
// "state_province": "TX",
// "postal_code": "78756",
// "country_code": "US",
// "phone": "512-555-5555"
// },
// "ship_to": {
// "name": "Amanda Miller",
// "address_line1": "525 Winchester",
// "postal_code": "95128",
// "country_code": "US"
// },
// "packages": [
// {
// "weight": {
// "value": 17,
// "unit": "pound"
// },
// "dimensions": {
// "length": 36,
// "width": 12,
// "height": 24,
// "unit": "inch"
// }
// }
// ]
// }
// ]
// }
json = CkJsonObject_Create();
CkJsonObject_UpdateString(json,"shipments[0].validate_address","validate_and_clean");
CkJsonObject_UpdateString(json,"shipments[0].service_code","usps_priority_mail");
CkJsonObject_UpdateString(json,"shipments[0].ship_from.name","John Doe");
CkJsonObject_UpdateString(json,"shipments[0].ship_from.company_name","Example Corp.");
CkJsonObject_UpdateString(json,"shipments[0].ship_from.address_line1","4009 Marathon Blvd");
CkJsonObject_UpdateString(json,"shipments[0].ship_from.city_locality","Austin");
CkJsonObject_UpdateString(json,"shipments[0].ship_from.state_province","TX");
CkJsonObject_UpdateString(json,"shipments[0].ship_from.postal_code","78756");
CkJsonObject_UpdateString(json,"shipments[0].ship_from.country_code","US");
CkJsonObject_UpdateString(json,"shipments[0].ship_from.phone","512-555-5555");
CkJsonObject_UpdateString(json,"shipments[0].ship_to.name","Amanda Miller");
CkJsonObject_UpdateString(json,"shipments[0].ship_to.address_line1","525 Winchester");
CkJsonObject_UpdateString(json,"shipments[0].ship_to.postal_code","95128");
CkJsonObject_UpdateString(json,"shipments[0].ship_to.country_code","US");
CkJsonObject_UpdateInt(json,"shipments[0].packages[0].weight.value",17);
CkJsonObject_UpdateString(json,"shipments[0].packages[0].weight.unit","pound");
CkJsonObject_UpdateInt(json,"shipments[0].packages[0].dimensions.length",36);
CkJsonObject_UpdateInt(json,"shipments[0].packages[0].dimensions.width",12);
CkJsonObject_UpdateInt(json,"shipments[0].packages[0].dimensions.height",24);
CkJsonObject_UpdateString(json,"shipments[0].packages[0].dimensions.unit","inch");
CkHttp_SetRequestHeader(http,"API-Key","{{API_KEY}}");
CkHttp_SetRequestHeader(http,"Content-Type","application/json");
resp = CkHttp_PostJson3(http,"https://api.shipengine.com/v1/shipments","application/json",json);
if (CkHttp_getLastMethodSuccess(http) == FALSE) {
printf("%s\n",CkHttp_lastErrorText(http));
CkHttp_Dispose(http);
CkJsonObject_Dispose(json);
return;
}
sbResponseBody = CkStringBuilder_Create();
CkHttpResponse_GetBodySb(resp,sbResponseBody);
jResp = CkJsonObject_Create();
CkJsonObject_LoadSb(jResp,sbResponseBody);
CkJsonObject_putEmitCompact(jResp,FALSE);
printf("Response Body:\n");
printf("%s\n",CkJsonObject_emit(jResp));
respStatusCode = CkHttpResponse_getStatusCode(resp);
printf("Response Status Code = %d\n",respStatusCode);
if (respStatusCode >= 400) {
printf("Response Header:\n");
printf("%s\n",CkHttpResponse_header(resp));
printf("Failed.\n");
CkHttpResponse_Dispose(resp);
CkHttp_Dispose(http);
CkJsonObject_Dispose(json);
CkStringBuilder_Dispose(sbResponseBody);
CkJsonObject_Dispose(jResp);
return;
}
CkHttpResponse_Dispose(resp);
// Sample JSON response:
// (Sample code for parsing the JSON response is shown below)
// {
// "has_errors": false,
// "shipments": [
// {
// "errors": [
// ],
// "address_validation": {
// "status": "verified",
// "original_address": {
// "name": "Amanda Miller",
// "phone": null,
// "company_name": null,
// "address_line1": "525 Winchester",
// "address_line2": null,
// "address_line3": null,
// "city_locality": null,
// "state_province": null,
// "postal_code": "95128",
// "country_code": "US",
// "address_residential_indicator": "unknown"
// },
// "matched_address": {
// "name": "AMANDA MILLER",
// "phone": null,
// "company_name": null,
// "address_line1": "525 S WINCHESTER BLVD",
// "address_line2": "",
// "address_line3": null,
// "city_locality": "SAN JOSE",
// "state_province": "CA",
// "postal_code": "95128-2537",
// "country_code": "US",
// "address_residential_indicator": "no"
// },
// "messages": [
// ]
// },
// "shipment_id": "se-4159801",
// "carrier_id": "se-121861",
// "service_code": "usps_priority_mail",
// "external_shipment_id": null,
// "ship_date": "2019-09-18T00:00:00Z",
// "created_at": "2019-09-18T16:01:54.9171198Z",
// "modified_at": "2019-09-18T16:01:54.9171198Z",
// "shipment_status": "pending",
// "ship_to": {
// "name": "AMANDA MILLER",
// "phone": null,
// "company_name": null,
// "address_line1": "525 S WINCHESTER BLVD",
// "address_line2": "",
// "address_line3": null,
// "city_locality": "SAN JOSE",
// "state_province": "CA",
// "postal_code": "95128-2537",
// "country_code": "US",
// "address_residential_indicator": "no"
// },
// "ship_from": {
// "name": "John Doe",
// "phone": "512-555-5555",
// "company_name": "Example Corp.",
// "address_line1": "4009 Marathon Blvd",
// "address_line2": null,
// "address_line3": null,
// "city_locality": "Austin",
// "state_province": "TX",
// "postal_code": "78756",
// "country_code": "US",
// "address_residential_indicator": "unknown"
// },
// "warehouse_id": null,
// "return_to": {
// "name": "John Doe",
// "phone": "512-555-5555",
// "company_name": "Example Corp.",
// "address_line1": "4009 Marathon Blvd",
// "address_line2": null,
// "address_line3": null,
// "city_locality": "Austin",
// "state_province": "TX",
// "postal_code": "78756",
// "country_code": "US",
// "address_residential_indicator": "unknown"
// },
// "confirmation": "none",
// "customs": null,
// "external_order_id": null,
// "order_source_code": null,
// "advanced_options": {
// "bill_to_account": null,
// "bill_to_country_code": null,
// "bill_to_party": null,
// "bill_to_postal_code": null,
// "contains_alcohol": false,
// "delivered_duty_paid": false,
// "non_machinable": false,
// "saturday_delivery": false,
// "dry_ice": false,
// "dry_ice_weight": null,
// "freight_class": null,
// "custom_field1": null,
// "custom_field2": null,
// "custom_field3": null
// },
// "insurance_provider": "none",
// "tags": [
// ],
// "packages": [
// {
// "package_code": "package",
// "weight": {
// "value": 17,
// "unit": "pound"
// },
// "dimensions": {
// "unit": "inch",
// "length": 36,
// "width": 12,
// "height": 24
// },
// "insured_value": {
// "currency": "usd",
// "amount": 0
// },
// "label_messages": {
// "reference1": null,
// "reference2": null,
// "reference3": null
// },
// "external_package_id": null
// }
// ],
// "total_weight": {
// "value": 17,
// "unit": "pound"
// },
// "items": [
// ]
// }
// ]
// }
// Sample code for parsing the JSON response...
// Use this online tool to generate parsing code from sample JSON: Generate JSON Parsing Code
// Chilkat functions returning "const char *" return a pointer to temporary internal memory owned and managed by Chilkat.
has_errors = CkJsonObject_BoolOf(jResp,"has_errors");
i = 0;
count_i = CkJsonObject_SizeOfArray(jResp,"shipments");
while (i < count_i) {
CkJsonObject_putI(jResp,i);
Status = CkJsonObject_stringOf(jResp,"shipments[i].address_validation.status");
Name = CkJsonObject_stringOf(jResp,"shipments[i].address_validation.original_address.name");
Phone = CkJsonObject_stringOf(jResp,"shipments[i].address_validation.original_address.phone");
Company_name = CkJsonObject_stringOf(jResp,"shipments[i].address_validation.original_address.company_name");
Address_line1 = CkJsonObject_stringOf(jResp,"shipments[i].address_validation.original_address.address_line1");
Address_line2 = CkJsonObject_stringOf(jResp,"shipments[i].address_validation.original_address.address_line2");
Address_line3 = CkJsonObject_stringOf(jResp,"shipments[i].address_validation.original_address.address_line3");
City_locality = CkJsonObject_stringOf(jResp,"shipments[i].address_validation.original_address.city_locality");
State_province = CkJsonObject_stringOf(jResp,"shipments[i].address_validation.original_address.state_province");
Postal_code = CkJsonObject_stringOf(jResp,"shipments[i].address_validation.original_address.postal_code");
Country_code = CkJsonObject_stringOf(jResp,"shipments[i].address_validation.original_address.country_code");
Address_residential_indicator = CkJsonObject_stringOf(jResp,"shipments[i].address_validation.original_address.address_residential_indicator");
Matched_addressName = CkJsonObject_stringOf(jResp,"shipments[i].address_validation.matched_address.name");
Matched_addressPhone = CkJsonObject_stringOf(jResp,"shipments[i].address_validation.matched_address.phone");
Matched_addressCompany_name = CkJsonObject_stringOf(jResp,"shipments[i].address_validation.matched_address.company_name");
Matched_addressAddress_line1 = CkJsonObject_stringOf(jResp,"shipments[i].address_validation.matched_address.address_line1");
Matched_addressAddress_line2 = CkJsonObject_stringOf(jResp,"shipments[i].address_validation.matched_address.address_line2");
Matched_addressAddress_line3 = CkJsonObject_stringOf(jResp,"shipments[i].address_validation.matched_address.address_line3");
Matched_addressCity_locality = CkJsonObject_stringOf(jResp,"shipments[i].address_validation.matched_address.city_locality");
Matched_addressState_province = CkJsonObject_stringOf(jResp,"shipments[i].address_validation.matched_address.state_province");
Matched_addressPostal_code = CkJsonObject_stringOf(jResp,"shipments[i].address_validation.matched_address.postal_code");
Matched_addressCountry_code = CkJsonObject_stringOf(jResp,"shipments[i].address_validation.matched_address.country_code");
Matched_addressAddress_residential_indicator = CkJsonObject_stringOf(jResp,"shipments[i].address_validation.matched_address.address_residential_indicator");
shipment_id = CkJsonObject_stringOf(jResp,"shipments[i].shipment_id");
carrier_id = CkJsonObject_stringOf(jResp,"shipments[i].carrier_id");
service_code = CkJsonObject_stringOf(jResp,"shipments[i].service_code");
external_shipment_id = CkJsonObject_stringOf(jResp,"shipments[i].external_shipment_id");
ship_date = CkJsonObject_stringOf(jResp,"shipments[i].ship_date");
created_at = CkJsonObject_stringOf(jResp,"shipments[i].created_at");
modified_at = CkJsonObject_stringOf(jResp,"shipments[i].modified_at");
shipment_status = CkJsonObject_stringOf(jResp,"shipments[i].shipment_status");
ship_toName = CkJsonObject_stringOf(jResp,"shipments[i].ship_to.name");
ship_toPhone = CkJsonObject_stringOf(jResp,"shipments[i].ship_to.phone");
ship_toCompany_name = CkJsonObject_stringOf(jResp,"shipments[i].ship_to.company_name");
ship_toAddress_line1 = CkJsonObject_stringOf(jResp,"shipments[i].ship_to.address_line1");
ship_toAddress_line2 = CkJsonObject_stringOf(jResp,"shipments[i].ship_to.address_line2");
ship_toAddress_line3 = CkJsonObject_stringOf(jResp,"shipments[i].ship_to.address_line3");
ship_toCity_locality = CkJsonObject_stringOf(jResp,"shipments[i].ship_to.city_locality");
ship_toState_province = CkJsonObject_stringOf(jResp,"shipments[i].ship_to.state_province");
ship_toPostal_code = CkJsonObject_stringOf(jResp,"shipments[i].ship_to.postal_code");
ship_toCountry_code = CkJsonObject_stringOf(jResp,"shipments[i].ship_to.country_code");
ship_toAddress_residential_indicator = CkJsonObject_stringOf(jResp,"shipments[i].ship_to.address_residential_indicator");
ship_fromName = CkJsonObject_stringOf(jResp,"shipments[i].ship_from.name");
ship_fromPhone = CkJsonObject_stringOf(jResp,"shipments[i].ship_from.phone");
ship_fromCompany_name = CkJsonObject_stringOf(jResp,"shipments[i].ship_from.company_name");
ship_fromAddress_line1 = CkJsonObject_stringOf(jResp,"shipments[i].ship_from.address_line1");
ship_fromAddress_line2 = CkJsonObject_stringOf(jResp,"shipments[i].ship_from.address_line2");
ship_fromAddress_line3 = CkJsonObject_stringOf(jResp,"shipments[i].ship_from.address_line3");
ship_fromCity_locality = CkJsonObject_stringOf(jResp,"shipments[i].ship_from.city_locality");
ship_fromState_province = CkJsonObject_stringOf(jResp,"shipments[i].ship_from.state_province");
ship_fromPostal_code = CkJsonObject_stringOf(jResp,"shipments[i].ship_from.postal_code");
ship_fromCountry_code = CkJsonObject_stringOf(jResp,"shipments[i].ship_from.country_code");
ship_fromAddress_residential_indicator = CkJsonObject_stringOf(jResp,"shipments[i].ship_from.address_residential_indicator");
warehouse_id = CkJsonObject_stringOf(jResp,"shipments[i].warehouse_id");
return_toName = CkJsonObject_stringOf(jResp,"shipments[i].return_to.name");
return_toPhone = CkJsonObject_stringOf(jResp,"shipments[i].return_to.phone");
return_toCompany_name = CkJsonObject_stringOf(jResp,"shipments[i].return_to.company_name");
return_toAddress_line1 = CkJsonObject_stringOf(jResp,"shipments[i].return_to.address_line1");
return_toAddress_line2 = CkJsonObject_stringOf(jResp,"shipments[i].return_to.address_line2");
return_toAddress_line3 = CkJsonObject_stringOf(jResp,"shipments[i].return_to.address_line3");
return_toCity_locality = CkJsonObject_stringOf(jResp,"shipments[i].return_to.city_locality");
return_toState_province = CkJsonObject_stringOf(jResp,"shipments[i].return_to.state_province");
return_toPostal_code = CkJsonObject_stringOf(jResp,"shipments[i].return_to.postal_code");
return_toCountry_code = CkJsonObject_stringOf(jResp,"shipments[i].return_to.country_code");
return_toAddress_residential_indicator = CkJsonObject_stringOf(jResp,"shipments[i].return_to.address_residential_indicator");
confirmation = CkJsonObject_stringOf(jResp,"shipments[i].confirmation");
customs = CkJsonObject_stringOf(jResp,"shipments[i].customs");
external_order_id = CkJsonObject_stringOf(jResp,"shipments[i].external_order_id");
order_source_code = CkJsonObject_stringOf(jResp,"shipments[i].order_source_code");
Bill_to_account = CkJsonObject_stringOf(jResp,"shipments[i].advanced_options.bill_to_account");
Bill_to_country_code = CkJsonObject_stringOf(jResp,"shipments[i].advanced_options.bill_to_country_code");
Bill_to_party = CkJsonObject_stringOf(jResp,"shipments[i].advanced_options.bill_to_party");
Bill_to_postal_code = CkJsonObject_stringOf(jResp,"shipments[i].advanced_options.bill_to_postal_code");
Contains_alcohol = CkJsonObject_BoolOf(jResp,"shipments[i].advanced_options.contains_alcohol");
Delivered_duty_paid = CkJsonObject_BoolOf(jResp,"shipments[i].advanced_options.delivered_duty_paid");
Non_machinable = CkJsonObject_BoolOf(jResp,"shipments[i].advanced_options.non_machinable");
Saturday_delivery = CkJsonObject_BoolOf(jResp,"shipments[i].advanced_options.saturday_delivery");
Dry_ice = CkJsonObject_BoolOf(jResp,"shipments[i].advanced_options.dry_ice");
Dry_ice_weight = CkJsonObject_stringOf(jResp,"shipments[i].advanced_options.dry_ice_weight");
Freight_class = CkJsonObject_stringOf(jResp,"shipments[i].advanced_options.freight_class");
Custom_field1 = CkJsonObject_stringOf(jResp,"shipments[i].advanced_options.custom_field1");
Custom_field2 = CkJsonObject_stringOf(jResp,"shipments[i].advanced_options.custom_field2");
Custom_field3 = CkJsonObject_stringOf(jResp,"shipments[i].advanced_options.custom_field3");
insurance_provider = CkJsonObject_stringOf(jResp,"shipments[i].insurance_provider");
Value = CkJsonObject_IntOf(jResp,"shipments[i].total_weight.value");
Unit = CkJsonObject_stringOf(jResp,"shipments[i].total_weight.unit");
j = 0;
count_j = CkJsonObject_SizeOfArray(jResp,"shipments[i].errors");
while (j < count_j) {
CkJsonObject_putJ(jResp,j);
j = j + 1;
}
j = 0;
count_j = CkJsonObject_SizeOfArray(jResp,"shipments[i].address_validation.messages");
while (j < count_j) {
CkJsonObject_putJ(jResp,j);
j = j + 1;
}
j = 0;
count_j = CkJsonObject_SizeOfArray(jResp,"shipments[i].tags");
while (j < count_j) {
CkJsonObject_putJ(jResp,j);
j = j + 1;
}
j = 0;
count_j = CkJsonObject_SizeOfArray(jResp,"shipments[i].packages");
while (j < count_j) {
CkJsonObject_putJ(jResp,j);
package_code = CkJsonObject_stringOf(jResp,"shipments[i].packages[j].package_code");
weightValue = CkJsonObject_IntOf(jResp,"shipments[i].packages[j].weight.value");
weightUnit = CkJsonObject_stringOf(jResp,"shipments[i].packages[j].weight.unit");
dimensionsUnit = CkJsonObject_stringOf(jResp,"shipments[i].packages[j].dimensions.unit");
Length = CkJsonObject_IntOf(jResp,"shipments[i].packages[j].dimensions.length");
Width = CkJsonObject_IntOf(jResp,"shipments[i].packages[j].dimensions.width");
Height = CkJsonObject_IntOf(jResp,"shipments[i].packages[j].dimensions.height");
v_Currency = CkJsonObject_stringOf(jResp,"shipments[i].packages[j].insured_value.currency");
Amount = CkJsonObject_IntOf(jResp,"shipments[i].packages[j].insured_value.amount");
Reference1 = CkJsonObject_stringOf(jResp,"shipments[i].packages[j].label_messages.reference1");
Reference2 = CkJsonObject_stringOf(jResp,"shipments[i].packages[j].label_messages.reference2");
Reference3 = CkJsonObject_stringOf(jResp,"shipments[i].packages[j].label_messages.reference3");
external_package_id = CkJsonObject_stringOf(jResp,"shipments[i].packages[j].external_package_id");
j = j + 1;
}
j = 0;
count_j = CkJsonObject_SizeOfArray(jResp,"shipments[i].items");
while (j < count_j) {
CkJsonObject_putJ(jResp,j);
j = j + 1;
}
i = i + 1;
}
CkHttp_Dispose(http);
CkJsonObject_Dispose(json);
CkStringBuilder_Dispose(sbResponseBody);
CkJsonObject_Dispose(jResp);
}
Curl Command
curl -X POST
-H "API-Key: {{API_KEY}}"
-H "Content-Type: application/json"
-d '{
"shipments": [{
"validate_address": "validate_and_clean",
"service_code": "usps_priority_mail",
"ship_from": {
"name": "John Doe",
"company_name": "Example Corp.",
"address_line1": "4009 Marathon Blvd",
"city_locality": "Austin",
"state_province": "TX",
"postal_code": "78756",
"country_code": "US",
"phone": "512-555-5555"
},
"ship_to": {
"name": "Amanda Miller",
"address_line1": "525 Winchester",
"postal_code": "95128",
"country_code": "US"
},
"packages": [
{
"weight": {
"value": 17,
"unit": "pound"
},
"dimensions": {
"length": 36,
"width": 12,
"height": 24,
"unit": "inch"
}
}
]
}]
}'
https://api.shipengine.com/v1/shipments
Postman Collection Item JSON
{
"name": "Validate when creating a shipment",
"event": [
{
"listen": "test",
"script": {
"exec": [
"let response = pm.response.json();",
"",
"if (response.shipments.length > 0) {",
" pm.collectionVariables.set(\"shipment_id\", response.shipments[0].shipment_id);",
"}"
],
"type": "text/javascript"
}
}
],
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"type": "text",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n\t\"shipments\": [{\n\t\t\"validate_address\": \"validate_and_clean\",\n\t\t\"service_code\": \"usps_priority_mail\",\n\t\t\"ship_from\": {\n\t\t\t\"name\": \"John Doe\",\n\t\t\t\"company_name\": \"Example Corp.\",\n\t\t\t\"address_line1\": \"4009 Marathon Blvd\",\n\t\t\t\"city_locality\": \"Austin\",\n\t\t\t\"state_province\": \"TX\",\n\t\t\t\"postal_code\": \"78756\",\n\t\t\t\"country_code\": \"US\",\n\t\t\t\"phone\": \"512-555-5555\"\n\t\t},\n\t\t\"ship_to\": {\n\t\t\t\"name\": \"Amanda Miller\",\n\t\t\t\"address_line1\": \"525 Winchester\",\n\t\t\t\"postal_code\": \"95128\",\n\t\t\t\"country_code\": \"US\"\n\t\t},\n\t\t\"packages\": [\n\t\t\t{\n\t\t\t\t\"weight\": {\n\t\t\t\t\t\"value\": 17,\n\t\t\t\t\t\"unit\": \"pound\"\n\t\t\t\t},\n\t\t\t\t\"dimensions\": {\n\t\t\t\t\t\"length\": 36,\n\t\t\t\t\t\"width\": 12,\n\t\t\t\t\t\"height\": 24,\n\t\t\t\t\t\"unit\": \"inch\"\n\t\t\t\t}\n\t\t\t}\n\t\t]\n\t}]\n}"
},
"url": {
"raw": "https://api.shipengine.com/v1/shipments",
"protocol": "https",
"host": [
"api",
"shipengine",
"com"
],
"path": [
"v1",
"shipments"
]
},
"description": "You can validate the address at the same time as creating a shipment in ShipEngine by setting the `validate_address` field to either `validate_only` or `validate_and_clean`."
},
"response": [
{
"name": "Validate when creating a shipment",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"type": "text",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n\t\"shipments\": [{\n\t\t\"validate_address\": \"validate_and_clean\",\n\t\t\"service_code\": \"usps_priority_mail\",\n\t\t\"ship_from\": {\n\t\t\t\"name\": \"John Doe\",\n\t\t\t\"company_name\": \"Example Corp.\",\n\t\t\t\"address_line1\": \"4009 Marathon Blvd\",\n\t\t\t\"city_locality\": \"Austin\",\n\t\t\t\"state_province\": \"TX\",\n\t\t\t\"postal_code\": \"78756\",\n\t\t\t\"country_code\": \"US\",\n\t\t\t\"phone\": \"512-555-5555\"\n\t\t},\n\t\t\"ship_to\": {\n\t\t\t\"name\": \"Amanda Miller\",\n\t\t\t\"address_line1\": \"525 Winchester\",\n\t\t\t\"postal_code\": \"95128\",\n\t\t\t\"country_code\": \"US\"\n\t\t},\n\t\t\"packages\": [\n\t\t\t{\n\t\t\t\t\"weight\": {\n\t\t\t\t\t\"value\": 17,\n\t\t\t\t\t\"unit\": \"pound\"\n\t\t\t\t},\n\t\t\t\t\"dimensions\": {\n\t\t\t\t\t\"length\": 36,\n\t\t\t\t\t\"width\": 12,\n\t\t\t\t\t\"height\": 24,\n\t\t\t\t\t\"unit\": \"inch\"\n\t\t\t\t}\n\t\t\t}\n\t\t]\n\t}]\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.shipengine.com/v1/shipments",
"protocol": "https",
"host": [
"api",
"shipengine",
"com"
],
"path": [
"v1",
"shipments"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Date",
"value": "Wed, 18 Sep 2019 16:01:54 GMT"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Content-Length",
"value": "4156"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Access-Control-Allow-Origin",
"value": "https://www.shipengine.com"
},
{
"key": "Vary",
"value": "Origin"
},
{
"key": "x-shipengine-requestid",
"value": "9b4734c7-f7d7-4ce9-8597-e9e6696d0053"
}
],
"cookie": [
],
"body": "{\n \"has_errors\": false,\n \"shipments\": [\n {\n \"errors\": [],\n \"address_validation\": {\n \"status\": \"verified\",\n \"original_address\": {\n \"name\": \"Amanda Miller\",\n \"phone\": null,\n \"company_name\": null,\n \"address_line1\": \"525 Winchester\",\n \"address_line2\": null,\n \"address_line3\": null,\n \"city_locality\": null,\n \"state_province\": null,\n \"postal_code\": \"95128\",\n \"country_code\": \"US\",\n \"address_residential_indicator\": \"unknown\"\n },\n \"matched_address\": {\n \"name\": \"AMANDA MILLER\",\n \"phone\": null,\n \"company_name\": null,\n \"address_line1\": \"525 S WINCHESTER BLVD\",\n \"address_line2\": \"\",\n \"address_line3\": null,\n \"city_locality\": \"SAN JOSE\",\n \"state_province\": \"CA\",\n \"postal_code\": \"95128-2537\",\n \"country_code\": \"US\",\n \"address_residential_indicator\": \"no\"\n },\n \"messages\": []\n },\n \"shipment_id\": \"se-4159801\",\n \"carrier_id\": \"se-121861\",\n \"service_code\": \"usps_priority_mail\",\n \"external_shipment_id\": null,\n \"ship_date\": \"2019-09-18T00:00:00Z\",\n \"created_at\": \"2019-09-18T16:01:54.9171198Z\",\n \"modified_at\": \"2019-09-18T16:01:54.9171198Z\",\n \"shipment_status\": \"pending\",\n \"ship_to\": {\n \"name\": \"AMANDA MILLER\",\n \"phone\": null,\n \"company_name\": null,\n \"address_line1\": \"525 S WINCHESTER BLVD\",\n \"address_line2\": \"\",\n \"address_line3\": null,\n \"city_locality\": \"SAN JOSE\",\n \"state_province\": \"CA\",\n \"postal_code\": \"95128-2537\",\n \"country_code\": \"US\",\n \"address_residential_indicator\": \"no\"\n },\n \"ship_from\": {\n \"name\": \"John Doe\",\n \"phone\": \"512-555-5555\",\n \"company_name\": \"Example Corp.\",\n \"address_line1\": \"4009 Marathon Blvd\",\n \"address_line2\": null,\n \"address_line3\": null,\n \"city_locality\": \"Austin\",\n \"state_province\": \"TX\",\n \"postal_code\": \"78756\",\n \"country_code\": \"US\",\n \"address_residential_indicator\": \"unknown\"\n },\n \"warehouse_id\": null,\n \"return_to\": {\n \"name\": \"John Doe\",\n \"phone\": \"512-555-5555\",\n \"company_name\": \"Example Corp.\",\n \"address_line1\": \"4009 Marathon Blvd\",\n \"address_line2\": null,\n \"address_line3\": null,\n \"city_locality\": \"Austin\",\n \"state_province\": \"TX\",\n \"postal_code\": \"78756\",\n \"country_code\": \"US\",\n \"address_residential_indicator\": \"unknown\"\n },\n \"confirmation\": \"none\",\n \"customs\": null,\n \"external_order_id\": null,\n \"order_source_code\": null,\n \"advanced_options\": {\n \"bill_to_account\": null,\n \"bill_to_country_code\": null,\n \"bill_to_party\": null,\n \"bill_to_postal_code\": null,\n \"contains_alcohol\": false,\n \"delivered_duty_paid\": false,\n \"non_machinable\": false,\n \"saturday_delivery\": false,\n \"dry_ice\": false,\n \"dry_ice_weight\": null,\n \"freight_class\": null,\n \"custom_field1\": null,\n \"custom_field2\": null,\n \"custom_field3\": null\n },\n \"insurance_provider\": \"none\",\n \"tags\": [],\n \"packages\": [\n {\n \"package_code\": \"package\",\n \"weight\": {\n \"value\": 17,\n \"unit\": \"pound\"\n },\n \"dimensions\": {\n \"unit\": \"inch\",\n \"length\": 36,\n \"width\": 12,\n \"height\": 24\n },\n \"insured_value\": {\n \"currency\": \"usd\",\n \"amount\": 0\n },\n \"label_messages\": {\n \"reference1\": null,\n \"reference2\": null,\n \"reference3\": null\n },\n \"external_package_id\": null\n }\n ],\n \"total_weight\": {\n \"value\": 17,\n \"unit\": \"pound\"\n },\n \"items\": []\n }\n ]\n}"
}
]
}
