# USPS API The USPS Developer Portal is for software developers who would like to integrate Postal Service functionality into their ecommerce, shipping, or logistics systems. Access and use USPS tools and resources conveniently within your site or application. You have the ability to try out the APIs in our Test environment.
To use the USPS APIs in the Test Environment you must be a registered user.
To use the USPS APIs you must be a registered user.
All USPS APIs listed below are Production URL. To use the API in Test Environment you need to change the URL from https://api.usps.com to https://api-cat.usps.com.
Your exclusive access to USPS APIs is protected using OAuth 2.0 industry standards. All USPS APIs require an OAuth 2.0 access token to be conveyed in the Authorization header, using the Bearer token scheme. Once you sign-in to the API developer portal, you may get the OAuth credentials you will need to register your application Add App. See "Getting Started" for further information about signing-in, registering your application, and additional USPS account credentials you will need to integrate your application with USPS APIs. You are responsible for securing the application credentials once issued. Please contact USPS if your credentials have been disclosed to external parties and we will issue new credentials.
OAuth 2.0 API
OAuth access tokens are used to grant authorized access to USPS APIs. Access tokens will expire, requiring applications to periodically check the expiration time and get new ones. The OAuth 2.0 client credentials grant type is the only OAuth flow presently supported. Other OAuth flows will become supported in future releases. You will need to add an app in the API Developer Portal to get Consumer Key and Consumer Secret values. You will need a valid customer registration ID (CRID) and mailer ID (MID) in order to get an access token. Contact your USPS Business Customer Gateway Business System Administrator (BSA) for this information.
Prepare your credentials for use in the following examples:
CLIENT_ID=XXXX
CLIENT_SECRET=XXXX
CUSTOMER_REGISTRATION_ID=XXXX
MAILER_ID=XXXXcurl -X 'POST' 'https://api.usps.com/oauth2/v3/token' \
--header 'Content-Type: application/json' \
--data '{
"client_id": "{{CLIENT_ID}}",
"client_secret": "{{CLIENT_SECRET}}",
"grant_type": "client_credentials"
}'{
"access_token": "XXXXXXXXXXXXXXXXX",
"token_type": "Bearer",
"issued_at": "1111111111111",
"expires_in": "11111",
"status": "approved",
"scope": "addresses service-delivery-standards locations prices tracking labels",
"issuer": "api.usps.com",
"client_id": "XXXXXXXXXXXXXXXXXXXXXXXXXX",
"application_name": "XXXXXX-XXXX-XXXX-XXX-XXXXXXXXXXXX",
"api_products": "[XXXXXXX]",
"public_key": "XXXXXXXXXXXXXXXXX"
}Set your access token to an environment variable for use in subsequent requests.
export $TOKEN=<access_token>curl -X 'POST' 'https://api.usps.com/oauth2/v3/token' \
--header 'Content-Type: application/json' \
--data '{
"client_id": "{{CLIENT_ID}}",
"client_secret": "{{CLIENT_SECRET}}",
"code": "{{CODE}}",
"redirect_uri": "https://mycompany.com/authorize",
"scope": "prices labels tracking",
"state": "nonce=abscdefg#",
"grant_type": "authorization_code"
}'{
"access_token": "XXXXXXXXXXXXXXXXX",
"token_type": "Bearer",
"issued_at": "1111111111111",
"expires_in": "11111",
"status": "approved",
"scope": "prices labels tracking",
"issuer": "api.usps.com",
"refresh_token": "XXXXXXXXXXXXXXXXX",
"refresh_token_issued_at": 1111111111111,
"refresh_token_status": "approved",
"refresh_token_expires_in": 11111,
"refresh_count": 0,
"client_id": "XXXXXXXXXXXXXXXXXXXXXXXXXX",
"application_name": "XXXXXX-XXXX-XXXX-XXX-XXXXXXXXXXXX",
"api_products": "[XXXXXXX]",
"public_key": "XXXXXXXXXXXXXXXXX"
}curl -X 'POST' 'https://api.usps.com/oauth2/v3/token' \
--header 'Content-Type: application/json' \
--data '{
"client_id": "{{CLIENT_ID}}",
"client_secret": "{{CLIENT_SECRET}}",
"grant_type": "refresh_token",
"refresh_token": "XXXXXXXXXXXXXXXXX"
}'{
"access_token": "XXXXXXXXXXXXXXXXX",
"token_type": "Bearer",
"issued_at": "1111111111111",
"expires_in": "11111",
"status": "approved",
"scope": "prices labels tracking",
"issuer": "api.usps.com",
"refresh_token": "XXXXXXXXXXXXXXXXX",
"refresh_token_issued_at": 1111111111111,
"refresh_token_status": "approved",
"refresh_token_expires_in": 11111,
"refresh_count": 1,
"client_id": "XXXXXXXXXXXXXXXXXXXXXXXXXX",
"application_name": "XXXXXX-XXXX-XXXX-XXX-XXXXXXXXXXXX",
"api_products": "[XXXXXXX]",
"public_key": "XXXXXXXXXXXXXXXXX"
}curl -X 'POST' 'https://api.usps.com/oauth2/v3/revoke' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $TOKEN' \
--data '{
"token": "ExDTmpomcDt6pTbFVvSgQ1km39YmX8Oy",
"token_type_hint": "refresh_token"
}' 200 OKThe Address API provides validation and standardization of USPS domestic addresses, city and state names, and ZIP Codes. When a valid address, city, and state are provided, for instance, the API will return the standardized address along with the 11-digit delivery point ZIP Code. This API also supports lookups of city and state names by ZIP Code or ZIP Code by city and state names. This functionality enables shippers to validate and standardize address information during order entry. Thus, saving time and money by reducing shipping delays and errors due to incorrect or improper address information.
This API supports ZIP Code and City/State lookups and validates and standardizes USPS domestic addresses, city and state names, and ZIP Codes in accordance with USPS addressing standards. This API supports USPS standardized addresses including the ZIP+4, signifying a USPS delivery point, given a street address, a city, and a state.
curl -X 'GET' 'https://api.usps.com/addresses/v3/address?streetAddress=3120%20M%20St&secondaryAddress=NW&city=Washington&state=DC&ZIPCode=20027&ZIPPlus4=3704' \
--header 'accept: application/json' \
--header 'x-user-id: XXXXXXXXXXXX' \
--header 'authorization: Bearer $TOKEN' \Response:
{
"firm": null,
"address": {
"streetAddress": "3120 M ST NW",
"streetAddressAbbreviation": null,
"secondaryAddress": null,
"city": "WASHINGTON",
"cityAbbreviation": null,
"state": "DC",
"postalCode": null,
"province": null,
"ZIPCode": "20007",
"ZIPPlus4": "3704",
"urbanization": null,
"country": null,
"countryISOCode": null
},
"addressAdditionalInfo": {
"deliveryPoint": "20",
"carrierRoute": "C036",
"DPVConfirmation": "Y",
"DPVCMRA": "N",
"business": "Y",
"centralDeliveryPoint": "N",
"vacant": "N"
},
"addressCorrections": null,
"addressMatches": null
}Returns city and state corresponding to a given ZIP code.
curl -X 'GET' 'https://api.usps.com/addresses/v3/city-state?ZIPCode=30022' \
--header 'accept: application/json' \
--header 'X-User-Id: XXXXXXXXXXX' \
--header 'Authorization: Bearer $TOKEN' \Response:
{
"city": "ALPHARETTA",
"state": "GA"
} Returns the ZIP Code and ZIP Code + 4 corresponding to the given address, city, and state (use USPS state abbreviations).
curl -X 'GET' 'https://api.usps.com/addresses/v3/zipcode?streetAddress=1273%20Pale%20San%20Vitores%20RD&city=Tamuning&state=GU' \
--header 'accept: application/json' \
--header 'x-user-id: XXXXXXXXXXXX' \
--header 'authorization: Bearer $TOKEN' \Response:
{
"firm": null,
"address": {
"streetAddress": "1273 PALE SAN VITORES RD",
"streetAddressAbbreviation": null,
"secondaryAddress": null,
"city": "TAMUNING",
"cityAbbreviation": null,
"state": "GU",
"postalCode": null,
"province": null,
"ZIPCode": "96913",
"ZIPPlus4": "4208",
"urbanization": null,
"country": null,
"countryISOCode": null
}
}The API supports customers scheduling a carrier to pick up your packages on the next USPS delivery day (Monday through Saturday, excluding holidays) for free. Carrier Pickup is available for sending packages using Priority Mail Express, Priority Mail, First Class Package Service Commercial, international delivery services, or for returned merchandise. You are able check availability, schedule, change, cancel and inquire on a carrier pickup.
Check carrier pickup service availability at the specified address. Either the city and state or the ZIP code is required, in addition to the street address. Responds with a 200 HTTP status code and includes the USPS standardized address when this location is eligible for carrier pickup.
curl -X 'GET' 'https://api.usps.com/pickup/v3/carrier-pickup/eligibility?streetAddress=4120%20Bingham%20Ave&city=Saint%20Louis&state=MO&ZIPCode=63116' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer $TOKEN' \
--data ''Response:
{
"pickupAddress": {
"firstName": null,
"lastName": null,
"firm": null,
"address": {
"streetAddress": "4120 BINGHAM AVE",
"secondaryAddress": null,
"city": "SAINT LOUIS",
"state": "MO",
"ZIPCode": "63116",
"ZIPPlus4": "2520",
"urbanization": null
},
"contact": [
{
"eMail": null
},
{
"phone": null,
"extension": null
}
]
}
}Schedule a carrier pickup on a specified date. If the address is eligible for carrier pickup, then any future date is possible. Scheduling a same-day pickup is limited and based on the time of day for the request.
curl -X 'POST' 'https://api.usps.com/pickup/v3/carrier-pickup' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $TOKEN' \
--data-raw '{
"pickupDate": "2023-04-21",
"pickupAddress": {
"firstName": "John",
"lastName": "Smith",
"firm": "FIRM",
"address": {
"streetAddress": "4120 Bingham",
"streetAddressAbbreviation": "Ave",
"secondaryAddress": null,
"city": "Saint Louis",
"cityAbbreviation": "",
"state": "MO",
"postalCode": "63116",
"province": "",
"ZIPCode": "63116",
"ZIPPlus4": "2520",
"urbanization": ""
},
"contact": [
{"email":"john.smith@firm.com"},
{"phone": "3333333333"}
]
},
"packages": [
{
"packageType": "FIRST-CLASS_PACKAGE_SERVICE",
"packageCount": 1
}
],
"estimatedWeight": 5,
"pickupLocation": {
"packageLocation": "OFFICE",
"specialInstructions": "Have a nice day"
}
}' Response:
{
"confirmationNumber": "{Confirmation Number}",
"pickupAddress": {
"firstName": "JOHN",
"lastName": "SMITH",
"firm": "FIRM",
"address": {
"streetAddress": "4120 BINGHAM AVE",
"secondaryAddress": null,
"city": "SAINT LOUIS",
"state": "MO",
"ZIPCode": "63116",
"ZIPPlus4": "2520",
"urbanization": null
},
"contact": [
{
"email": "JOHN.SMITH@FIRM.COM"
},
{
"phone": "3333333333",
"extension": null
}
]
},
"packages": [
{
"packageType": "FIRST-CLASS_PACKAGE_SERVICE",
"packageCount": "1"
},
{
"packageType": "PRIORITY_MAIL_EXPRESS",
"packageCount": "0"
},
{
"packageType": "PRIORITY_MAIL",
"packageCount": "0"
},
{
"packageType": "RETURNS",
"packageCount": "0"
},
{
"packageType": "INTERNATIONAL",
"packageCount": "0"
},
{
"packageType": "OTHER",
"packageCount": "0"
}
],
"estimatedWeight": "5",
"pickupLocation": {
"packageLocation": "OFFICE",
"specialInstructions": "HAVE A NICE DAY"
},
"pickupDate": "2023-04-20"
}Get the previously scheduled carrier pickup by confirmation number. Responds with the entity tag (ETag) to use when updating or cancelling this pickup.
curl -X 'GET' 'https://api.usps.com/pickup/v3/carrier-pickup/{Confirmation Number}' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer $TOKEN' \Response:
{
"confirmationNumber": "{Confirmation Number}",
"pickupAddress": {
"firstName": "JOHN",
"lastName": "SMITH",
"firm": "FIRM",
"address": {
"streetAddress": "4120 BINGHAM AVE",
"secondaryAddress": null,
"city": "SAINT LOUIS",
"state": "MO",
"ZIPCode": "63116",
"ZIPPlus4": "2520",
"urbanization": null
},
"contact": [
{
"email": "JOHN.SMITH@FIRM.COM"
},
{
"phone": "3333333333",
"extension": null
}
]
},
"packages": [
{
"packageType": "FIRST-CLASS_PACKAGE_SERVICE",
"packageCount": "1"
},
{
"packageType": "PRIORITY_MAIL_EXPRESS",
"packageCount": "0"
},
{
"packageType": "PRIORITY_MAIL",
"packageCount": "0"
},
{
"packageType": "RETURNS",
"packageCount": "0"
},
{
"packageType": "INTERNATIONAL",
"packageCount": "0"
},
{
"packageType": "OTHER",
"packageCount": "0"
}
],
"estimatedWeight": "5",
"pickupLocation": {
"packageLocation": "OFFICE",
"specialInstructions": "HAVE A NICE DAY"
},
"pickupDate": "2023-04-20"
}Update information contained in a previously scheduled carrier pickup such as the pickup date, the types and counts of packages for the carrier to pick up, the weight or the pickup location.
curl --request PUT 'https://api.usps.com/pickup/v3/carrier-pickup/{Confirmation Number}' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'If-Match: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX' \
--header 'Authorization: Bearer $TOKEN' \
--data-raw '{
"confirmationNumber": "{Confirmation Number}",
"pickupDate": "2023-04-22",
"pickupAddress": {
"firstName": "Smith",
"lastName": "John",
"firm": "FIRM",
"address": {
"streetAddress": "4120 Bingham",
"streetAddressAbbreviation": "Ave",
"secondaryAddress": null,
"city": "Saint Louis",
"cityAbbreviation": "",
"state": "MO",
"postalCode": "63116",
"province": "",
"ZIPCode": "63116",
"ZIPPlus4": "",
"urbanization": ""
},
"contact": [
{"email":"smith.john@firm.com"},
{"phone": "3333333333"}
]
},
"packages": [
{
"packageType": "FIRST-CLASS_PACKAGE_SERVICE",
"packageCount": 5
}
],
"estimatedWeight": 15,
"pickupLocation": {
"packageLocation": "OFFICE",
"specialInstructions": "Have a nice day after carrier pickup updated 2"
}
}' Response:
{
"confirmationNumber": "{Confirmation Number}",
"pickupAddress": {
"firstName": "SMITH",
"lastName": "JOHN",
"firm": "FIRM",
"address": {
"streetAdress": "4120 BINGHAM AVE",
"secondaryAddress": null,
"city": "SAINT LOUIS",
"state": "MO",
"ZIPCode": "63116",
"ZIPLus4": "2520",
"urbanization": null
},
"contact": [
{
"email": "SMITH.JOHN@FIRM.COM"
},
{
"phone": "3333333333",
"extension": null
}
]
},
"packages": [
{
"packageType": "FIRST-CLASS_PACKAGE_SERVICE",
"packageCount": "5"
},
{
"packageType": "PRIORITY_MAIL_EXPRESS",
"packageCount": "0"
},
{
"packageType": "PRIORITY_MAIL",
"packageCount": "0"
},
{
"packageType": "RETURNS",
"packageCount": "0"
},
{
"packageType": "INTERNATIONAL",
"packageCount": "0"
},
{
"packageType": "OTHER",
"packageCount": "0"
}
],
"estimatedWeight": "15",
"pickupLocation": {
"packageLocation": "OFFICE",
"specialInstructions": "HAVE A NICE DAY AFTER CARRIER PICKUP UPDATED 2"
},
"pickupDate": "2023-04-22"
}Cancel a previously scheduled carrier pick up. A carrier pickup can no longer be updated or cancelled once cancelled. Responds with a 200 HTTP status code when the carrier pickup has been cancelled.
curl --request DELETE 'https://api.usps.com/pickup/v3/carrier-pickup/{Confirmation Number}' \
--header 'Accept: application/json' \
--header 'If-Match: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX' \
--header 'Authorization: Bearer $TOKEN' \
--data ''Response: 200 OK if successful
The Intelligent Mail Container barcode (IMcb) provides visibility at the mail aggregate level. It is used on mailer-generated pallet labels to uniquely identify pallets and similar containers (i.e. All Purpose Containers, hampers, pallet boxes, etc.) in addition to identifying the mail owner and, it provides a link between the electronic mailing record and the physical mail aggregate.
When a user creates a container, the container can be updated with additional tracking numbers with this endpoint.
curl -X 'POST' 'https://api.usps.com/containers/v3/containers/99M900066875EMA000051/packages' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $TOKEN' \
--data '{
"trackingNumbers": [
"9261212345678900017627"
]
}'Response:
{
"containerID": "99M900066875EMA000051",
"sortType": "SACK",
"destinationEntryFacilityType": "DESTINATION_DELIVERY_UNIT",
"destinationZIPCode": "06701",
"mailClass": "PARCEL_SELECT",
"originAddress": {
"streetAddress": "900 BRENTWOOD RD NE",
"secondaryAddress": null,
"city": "Washington",
"state": "DC",
"urbanization": "",
"ZIPCode": "20018",
"ZIPPlus4": "0000"
},
"mailerName": "John Smith AC.",
"processingCategory": "MACHINABLE",
"containerTopology": "NESTED",
"warnings": [],
"MID": "XXXXXXXXX"
}Allows the caller to get a container label and associate packages to that container.
curl -X 'POST' 'https://api.usps.com/containers/v3/containers' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $TOKEN' \
--data '{
"imageInfo": {
"imageType": "PDF",
"labelType": "6X4LABEL"
},
"trackingNumbers":[
"9261212345678900017634"
],
"sortType": "SACK",
"destinationEntryFacilityType": "DESTINATION_DELIVERY_UNIT",
"destinationZIPCode": "06701",
"mailClass": "PARCEL_SELECT",
"originAddress": {
"streetAddress": "900 BRENTWOOD RD NE",
"secondaryAddress": "",
"city": "Washington",
"state": "DC",
"ZIPCode": "20018",
"ZIPPlus4": "0000",
"urbanization": ""
},
"mailerName": "John Smith AC.",
"processingCategory": "MACHINABLE",
"containerTopology": "NESTED",
"MID": "XXXXXXXXX"
}' Response:
--XkxytuhvSSXDz-aV1q2YverB
Content-Type: application/json
Content-Disposition: form-data; name="containerMetadata"
{
"containerID": "99M900066875EMA000052",
"sortType": "SACK",
"destinationEntryFacilityType": "DESTINATION_DELIVERY_UNIT",
"destinationZIPCode": "06701",
"mailClass": "PARCEL_SELECT",
"originAddress": {
"streetAddress": "900 BRENTWOOD RD NE",
"secondaryAddress": "",
"city": "Washington",
"state": "DC",
"urbanization": "",
"ZIPCode": "20018",
"ZIPPlus4": "0000"
},
"mailerName": "John Smith AC.",
"processingCategory": "MACHINABLE",
"containerTopology": "NESTED",
"warnings": [],
"MID": "XXXXXXXXX"
}
--XkxytuhvSSXDz-aV1q2YverB
Content-Type: application/pdf
Content-Disposition: form-data; filename="labelImage.pdf"; name="labelImage"
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Pj4KZW5kb2JqCjExIDAgb2JqCjw8IC9UeXBlIC9QYWdlcwovQ291bnQgMQovS2lkcyBbOSAwIFIgXSA+PgplbmRvYmoKMTQgMCBvYmoKPDwKICAvVHlwZSAvQ2F0YWxvZwogIC9QYWdlcyAxMSAwIFIKICAvTGFuZyAoeC11bmtub3duKQo+PgplbmRvYmoKMTAgMCBvYmoKPDwKICAvRm9udCA8PCAvRjEgMTIgMCBSIC9GMyAxMyAwIFIgPj4KICAvUHJvY1NldCBbL1BERiAvSW1hZ2VCIC9JbWFnZUMgL1RleHRdCiAgL1hPYmplY3QgPDwgL0ltMSA1IDAgUiA+PgogIC9Db2xvclNwYWNlIDw8IC9JQ0MyIDQgMCBSID4+Cj4+CmVuZG9iagp4cmVmCjAgMTUKMDAwMDAwMDAwMCA2NTUzNSBmIAowMDAwMDAwMDE1IDAwMDAwIG4gCjAwMDAwMDAxMzEgMDAwMDAgbiAKMDAwMDAwMjY4OCAwMDAwMCBuIAowMDAwMDAyNzA4IDAwMDAwIG4gCjAwMDAwMDI3NDEgMDAwMDAgbiAKMDAwMDAwMzE3MiAwMDAwMCBuIAowMDAwMDAzMTkxIDAwMDAwIG4gCjAwMDAwMDQ3ODAgMDAwMDAgbiAKMDAwMDAwNDgwMCAwMDAwMCBuIAowMDAwMDA1MzQzIDAwMDAwIG4gCjAwMDAwMDUyMDkgMDAwMDAgbiAKMDAwMDAwNDk5MiAwMDAwMCBuIAowMDAwMDA1MDk4IDAwMDAwIG4gCjAwMDAwMDUyNjggMDAwMDAgbiAKdHJhaWxlcgo8PAogIC9Sb290IDE0IDAgUgogIC9JbmZvIDEgMCBSCiAgL0lEIFs8Mjc2NDQ2ODg1RjA5NTgyMEZDMUIyOUIwQjdDMTg1OTI+IDwyNzY0NDY4ODVGMDk1ODIwRkMxQjI5QjBCN0MxODU5Mj5dCiAgL1NpemUgMTUKPj4Kc3RhcnR4cmVmCjU1MDEKJSVFT0YK
--XkxytuhvSSXDz-aV1q2YverB--The USPS Labels API allows you to digitally create mailing labels for Parcel Select Ground, Parcel Select Destination Entry, Parcel Select Lightweight, Connect Local, Connect Regional, Priority Mail, Priority Mail Express, First-Class Package Services, Bound Printed Matter, Library Mail, and Media Mail mail classes. To use this API, the caller must establish an Enterprise Payment Account to pay for the Label transactions being generated during each API Call. You can find details on how to establish your Enterprise Payment Account at Fact Sheet. The USPS Labels API uses a token to authorize use of an Enterprise Payment. The specification to generate the token is in the payments API.
The following fields are used to assure that a label is generated:
curl -X 'POST' 'https://api.usps.com/payments/v3/payment-authorization' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $TOKEN' \
--data '{
"roles": [
{
"roleName": "PAYER",
"CRID": "XXXXXXXX",
"MID": "XXXXXXXXX",
"manifestMID": "XXXXXXXXX",
"accountType": "EPS",
"accountNumber": "XXXXXXXXXX"
},
{
"roleName": "LABEL_OWNER",
"CRID": "XXXXXXXX",
"MID": "XXXXXXXXX",
"manifestMID": "XXXXXXXXX",
"accountType": "EPS",
"accountNumber": "XXXXXXXXXX"
}
]
}'Response:
{
"paymentAuthorizationToken": "XXXXXXXXXXXXXXXXXXXXXX",
"roles": [
{
"roleName": "PAYER",
"CRID": "XXXXXXXX",
"MID": "XXXXXXXXX",
"manifestMID": "XXXXXXXXX",
"accountType": "EPS",
"accountNumber": "XXXXXXXXXX"
},
{
"roleName": "LABEL_OWNER",
"CRID": "XXXXXXXX",
"MID": "XXXXXXXXX",
"manifestMID": "XXXXXXXXX",
"accountType": "EPS",
"accountNumber": "XXXXXXXXXX"
}
]
} Set your access token to an environment variable for use in subsequent requests.
export $PAYMENTTOKEN=<paymentAuthorizationToken>Save the example request body to a file: domesticlabel-v3-request.json
curl -X 'POST' 'https://api.usps.com/labels/v3/label' \
--header 'X-Payment-Authorization-Token: $PAYMENTTOKEN'\
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $TOKEN' \
--data @domesticlabel-v3-request \
Response: domesticlabel-v3-response.json
Allow customers to edit package attributes for previously created labels including weight, dimensions, rate indicator, processing category and containers. These fields eligible for editing will not impact label images, so previous label images can still be used. Changing these rate ingredients may effect the prices of the label. Therefore, the Payment Authorization token is required.
Note: Label edits will not be supported for the following scenarios, instead unused label refunds should be requested and new labels should be created.
- All label edits are disallowed if the original label was created with a suppressPostage = false
- No dimensional updates are supported for Cubic Softpack Labels
- Cubic labels can not be edited to non-cubic rate indicatorscurl -X 'PATCH' 'https://api.usps.com/labels/v3/label/1234567890123456789012' \
--header 'X-Payment-Authorization-Token: $PAYMENTTOKEN'\
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $TOKEN' \
--data '{
{
"op": "replace",
"path": "/packageDescription/weight",
"value": 1
},
{
"op": "replace",
"path": "/packageDescription/length",
"value": 10
},
{
"op": "replace",
"path": "/packageDescription/height",
"value": 7
},
{
"op": "replace",
"path": "/packageDescription/width",
"value": 4.5
},
{
"op": "replace",
"path": "/packageDescription/girth",
"value": 0.50
},
{
"op": "replace",
"path": "/packageDescription/processingCategory",
"value": "NON_MACHINABLE"
},
{
"op": "replace",
"path": "/packageDescription/containers",
"value": [
{
"containerID": "123456789012345",
"sortType": "PALLET"
}
]
},
{
"op": "replace",
"path": "/packageDescription/rateIndicator",
"value": "CP"
}
}'Response:
{
"labelAddress": {
"streetAddress": "1100 WYOMING ST",
"secondaryAddress": "STE 150",
"city": "SAINT LOUIS",
"state": "MO",
"ZIPCode": "63118",
"ZIPPlus4": "2628",
"firstName": "JOE",
"lastName": "DOE",
"ignoreBadAddress": false
},
"routingInformation": "123456789102",
"trackingNumber": "{{trackingNumber}}",
"postage": 7.05,
"extraServices": [
{
"name": "USPS Tracking",
"price": 0.0,
"SKU": "XXXXXXXXXXXXX"
}
],
"zone": "01",
"commitment": {
"name": "6 Days",
"scheduleDeliveryDate": "2024-06-22"
},
"weightUOM": "LB",
"weight": 1.0,
"fees": [],
"labelBrokerID": "",
"constructCode": "C01",
"SKU": "XXXXXXXXXXXXX"
}Generate a First-Class indicia for use on letter and flat mailings.
Only supported for 'PAYER' Roles with an EPS accountType.
curl -X 'PATCH' 'https://api.usps.com/labels/v3/indicia' \
--header 'X-Payment-Authorization-Token: $PAYMENTTOKEN'\
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $TOKEN' \
--data '{
"indiciaDescription": {
"processingCategory": "LETTERS",
"weight": 3.5,
"mailingDate": "2024-07-11",
"length": 6.0,
"height": 4.0,
"thickness": 0.25,
"nonMachinableIndicators": {
"polybagged": true,
"closureDevices": true,
"looseItems": true,
"rigid": true,
"selfMailer": true,
"booklet": true
}
},
"imageInfo": {
"imageType": "PDF",
"receiptOption": "SEPARATE_PAGE"
}
}'Response:
--Ah2SYTymfbGnSStJLSpLScnK
Content-Type: application/json
Content-Disposition: form-data; name="indiciaMetadata"
{
"SKU": "DFLL0XXXXR00035",
"postage": 1.36,
"fees": [
{
"name": "Nonmachinable letter fee",
"SKU": "N/A",
"price": 0.4
}
],
"weight": 3.5
}
--Ah2SYTymfbGnSStJLSpLScnK
Content-Type: application/pdf
Content-Disposition: form-data; filename="receiptImage.pdf"; name="receiptImage"
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0cyAyIDAgUgo+PgplbmRvYmoKNyAwIG9iago8PAogIC9UeXBlIC9Gb250CiAgL1N1YnR5cGUgL1R5cGUxCiAgL0Jhc2VGb250IC9IZWx2ZXRpY2EKICAvRW5jb2RpbmcgL1dpbkFuc2lFbmNvZGluZwo+PgplbmRvYmoKNiAwIG9iago8PCAvVHlwZSAvUGFnZXMKL0NvdW50IDEKL0tpZHMgWzQgMCBSIF0gPj4KZW5kb2JqCjggMCBvYmoKPDwKICAvVHlwZSAvQ2F0YWxvZwogIC9QYWdlcyA2IDAgUgogIC9MYW5nICh4LXVua25vd24pCj4+CmVuZG9iago1IDAgb2JqCjw8IC9Gb250IDw8IC9GMSA3IDAgUiA+PiAvUHJvY1NldCBbL1BERiAvSW1hZ2VCIC9JbWFnZUMgL1RleHRdID4+CmVuZG9iagp4cmVmCjAgOQowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMTUgMDAwMDAgbiAKMDAwMDAwMDEzMSAwMDAwMCBuIAowMDAwMDA2NDU5IDAwMDAwIG4gCjAwMDAwMDY0NzkgMDAwMDAgbiAKMDAwMDAwNjkwNSAwMDAwMCBuIAowMDAwMDA2Nzc0IDAwMDAwIG4gCjAwMDAwMDY2NjkgMDAwMDAgbiAKMDAwMDAwNjgzMiAwMDAwMCBuIAp0cmFpbGVyCjw8CiAgL1Jvb3QgOCAwIFIKICAvSW5mbyAxIDAgUgogIC9JRCBbPDg5N0Q4MUE5RUVDMkY5RDI4MTNGNTY1MDkxMTA2NEFDPiA8ODk3RDgxQTlFRUMyRjlEMjgxM0Y1NjUwOTExMDY0QUM+XQogIC9TaXplIDkKPj4Kc3RhcnR4cmVmCjY5ODYKJSVFT0YK
--Ah2SYTymfbGnSStJLSpLScnK
Content-Type: application/pdf
Content-Disposition: form-data; filename="indiciaImage.pdf"; name="indiciaImage"
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cGUgL0NhdGFsb2cKICAvUGFnZXMgMTEgMCBSCiAgL0xhbmcgKHgtdW5rbm93bikKPj4KZW5kb2JqCjEwIDAgb2JqCjw8CiAgL0ZvbnQgPDwgL0YxIDEyIDAgUiAvRjMgMTMgMCBSID4+CiAgL1Byb2NTZXQgWy9QREYgL0ltYWdlQiAvSW1hZ2VDIC9UZXh0XQogIC9YT2JqZWN0IDw8IC9JbTEgNSAwIFIgPj4KICAvQ29sb3JTcGFjZSA8PCAvSUNDMiA0IDAgUiA+Pgo+PgplbmRvYmoKeHJlZgowIDE1CjAwMDAwMDAwMDAgNjU1MzUgZiAKMDAwMDAwMDAxNSAwMDAwMCBuIAowMDAwMDAwMTMxIDAwMDAwIG4gCjAwMDAwMDI2ODggMDAwMDAgbiAKMDAwMDAwMjcwOCAwMDAwMCBuIAowMDAwMDAyNzQxIDAwMDAwIG4gCjAwMDAwMDMyNzEgMDAwMDAgbiAKMDAwMDAwMzI5MCAwMDAwMCBuIAowMDAwMDA0ODk1IDAwMDAwIG4gCjAwMDAwMDQ5MTUgMDAwMDAgbiAKMDAwMDAwNTQ1OCAwMDAwMCBuIAowMDAwMDA1MzI0IDAwMDAwIG4gCjAwMDAwMDUxMDcgMDAwMDAgbiAKMDAwMDAwNTIxMyAwMDAwMCBuIAowMDAwMDA1MzgzIDAwMDAwIG4gCnRyYWlsZXIKPDwKICAvUm9vdCAxNCAwIFIKICAvSW5mbyAxIDAgUgogIC9JRCBbPDAyQTdFNTE4QjY3Qjg3MTRDMUM3ODQ1MkRGOTc1RUY4PiA8MDJBN0U1MThCNjdCODcxNEMxQzc4NDUyREY5NzVFRjg+XQogIC9TaXplIDE1Cj4+CnN0YXJ0eHJlZgo1NjE2CiUlRU9GCg==
--Ah2SYTymfbGnSStJLSpLScnK--The Prices API can be used to look-up postage rates for domestic packages:
For specifications such as package dimensions, delivery information, etc., please refer to the Domestic Mail Manual (DMM). For a list of published rates please refer to the USPS Price List. To discover the rate ingredients for this API, look at Publication 205.
curl -X 'POST' 'https://api.usps.com/prices/v3/base-rates/search' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $TOKEN' \
--data '{
"originZIPCode": "78664",
"destinationZIPCode": "78665",
"weight": 7,
"length": 9,
"width": 0.25,
"height": 6,
"mailClass": "PARCEL_SELECT",
"processingCategory": "MACHINABLE",
"destinationEntryFacilityType": "NONE",
"rateIndicator": "DR",
"priceType": "COMMERCIAL",
"accountType": "EPS",
"accountNumber": "XXXXXXXXXX",
"mailingDate": "2023-05-25"
}'Response:
{
"totalBasePrice": 8.02,
"rates": [
{
"SKU": "DVXR0XXXXC01070",
"description": "Parcel Select Ground Machinable Dimensional Rectangular",
"priceType": "COMMERCIAL",
"price": 8.02,
"weight": 7,
"dimWeight": 0,
"fees": [],
"startDate": "2023-01-22",
"endDate": "",
"warnings": [],
"mailClass": "PARCEL_SELECT",
"zone": "01"
}
]
}Returns eligible extra service prices, descriptions, and SKUs given a set of package rate ingredients.
curl -X 'POST' 'https://api.usps.com/prices/v3/extra-service-rates/search' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $TOKEN' \
--data '{
"extraService": 415,
"mailClass": "PARCEL_SELECT",
"priceType": "RETAIL",
"itemValue": 0,
"weight": 5,
"mailingDate": "2023-05-25",
"accountType": "EPS",
"accountNumber": "XXXXXXXXXX"
}'Response:
{
"extraService": "415",
"name": "Label Delivery",
"sku": "DXQX0XXXXCX0000",
"priceType": "RETAIL",
"price": 1.25,
"warnings": []
}Returns an eligible price given a set of package rate ingredients.
curl -X 'POST' 'https://api.usps.com/prices/v3/total-rates/search' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $TOKEN' \
--data '{
"originZIPCode": "36105",
"destinationZIPCode": "78207",
"weight": 7,
"length": 9,
"width": 0.25,
"height": 6,
"mailClass": "PARCEL_SELECT",
"priceType": "COMMERCIAL",
"mailingDate": "2023-07-28",
"accountType": "EPS",
"accountNumber": "XXXXXXXXXX",
"itemValue": 500,
"extraServices": [
415
]
}'Response:
{
"rateOptions": [
{
"totalBasePrice": 4.59,
"totalPrice": 5.84,
"rates": [
{
"description": "Parcel Select Machinable DDU Single-piece",
"priceType": "COMMERCIAL",
"price": 4.59,
"weight": 7.0,
"dimWeight": 0.0,
"fees": [],
"startDate": "2023-07-09",
"endDate": "",
"mailClass": "PARCEL_SELECT",
"zone": "00",
"SKU": "DVXP0XXUXC00070"
}
],
"extraServices": [
{
"extraService": "415",
"name": "Label Delivery",
"priceType": "COMMERCIAL",
"price": 1.25,
"warnings": [],
"SKU": "DXQX0XXXXCX0000"
}
]
},
{
"totalBasePrice": 7.86,
"totalPrice": 9.11,
"rates": [
{
"description": "Parcel Select Machinable DNDC Single-piece",
"priceType": "COMMERCIAL",
"price": 7.86,
"weight": 7.0,
"dimWeight": 0.0,
"fees": [],
"startDate": "2023-07-09",
"endDate": "",
"mailClass": "PARCEL_SELECT",
"zone": "00",
"SKU": "DVXP0XXCXC00070"
}
],
"extraServices": [
{
"extraService": "415",
"name": "Label Delivery",
"priceType": "COMMERCIAL",
"price": 1.25,
"warnings": [],
"SKU": "DXQX0XXXXCX0000"
}
]
},
{
"totalBasePrice": 6.79,
"totalPrice": 8.04,
"rates": [
{
"description": "Parcel Select Machinable DSCF SCF",
"priceType": "COMMERCIAL",
"price": 6.79,
"weight": 7.0,
"dimWeight": 0.0,
"fees": [],
"startDate": "2023-07-09",
"endDate": "",
"mailClass": "PARCEL_SELECT",
"zone": "00",
"SKU": "DVXP0XXFTC00070"
}
],
"extraServices": [
{
"extraService": "415",
"name": "Label Delivery",
"priceType": "COMMERCIAL",
"price": 1.25,
"warnings": [],
"SKU": "DXQX0XXXXCX0000"
}
]
},
{
"totalBasePrice": 5.74,
"totalPrice": 6.99,
"rates": [
{
"description": "Parcel Select Machinable Single-piece",
"priceType": "COMMERCIAL",
"price": 5.74,
"weight": 7.0,
"dimWeight": 0.0,
"fees": [],
"startDate": "2023-07-09",
"endDate": "",
"mailClass": "PARCEL_SELECT",
"zone": "00",
"SKU": "DVXP0XXBXC00070"
}
],
"extraServices": [
{
"extraService": "415",
"name": "Label Delivery",
"priceType": "COMMERCIAL",
"price": 1.25,
"warnings": [],
"SKU": "DXQX0XXXXCX0000"
}
]
}
]
}Performs a search for letter prices using the submitted rate ingredients.
curl -X 'POST' 'https://api.usps.com/prices/v3/letter-rates/search' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $TOKEN' \
--data '{
"weight": 3.5,
"length": 4.0,
"height": 5.0,
"thickness": 0.25,
"processingCategory": "LETTERS",
"mailingDate": "2023-11-29",
"nonMachinableIndicators": {
"isPolybagged": true,
"hasClosureDevices": true,
"hasLooseItems": true,
"isRigid": true,
"isSelfMailer": true,
"isBooklet": true
}
}'Response:
{
"totalBasePrice": 1.75,
"rates": [
{
"SKU": "DFLL0XXXXR00035",
"description": "First Class Letter Metered",
"priceType": "RETAIL",
"price": 1.35,
"weight": 3.5,
"dimWeight": null,
"fees": [
{
"name": "Nonmachinable letter fee",
"SKU": "N/A",
"price": 0.4
}
],
"startDate": "2023-07-09",
"endDate": "",
"warnings": [],
"mailClass": "USPS_GROUND_ADVANTAGE",
"zone": null
}
]
}The International Prices API can be used to look-up postage rates for international packages:
For specifications such as package dimensions, delivery information, etc., please refer to the International Mail Manual (IMM). For a list of published rates please refer to the USPS Price List. To discover the rate ingredients for this API, look at Publication 205.
curl -X 'POST' 'https://api.usps.com/international-prices/v3/base-rates/search' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $TOKEN' \
--data '{
"originZIPCode": "22407",
"foreignPostalCode": "10109",
"destinationCountryCode": "CA",
"destinationEntryFacilityType": "NONE",
"weight": 0.5,
"length": 9,
"width": 15,
"height": 6,
"mailClass": "FIRST-CLASS_PACKAGE_INTERNATIONAL_SERVICE",
"processingCategory": "NON_MACHINABLE",
"rateIndicator": "SP",
"priceType": "COMMERCIAL",
"accountType": "EPS",
"accountNumber": "XXXXXXXXXX",
"mailingDate": "2023-05-25"
}'{
"rates": [
{
"SKU": "IFXP0XXXXB01080",
"description": "First-Class Package International Service Nonmachinable Single-piece",
"mailClass": "FIRST-CLASS_PACKAGE_INTERNATIONAL_SERVICE",
"priceType": "COMMERCIAL",
"zone": "01",
"dimWeight": 0,
"weight": 0.5,
"fees": [],
"price": 14.96,
"startDate": "2023-01-22",
"endDate": "",
"warnings": []
}
],
"totalBasePrice": 14.96
}Given a set of rate ingredients, returns international extra service rates. If contractId and productId are present, include contract-based rates in the results.
curl -X 'POST' 'https://api.usps.com/international-prices/v3/extra-service-rates/search' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $TOKEN' \
--data '{
"extraService": 930,
"mailClass": "PRIORITY_MAIL_INTERNATIONAL",
"priceType": "RETAIL",
"itemValue": "500",
"weight": 4,
"mailingDate": "2023-05-25",
"rateIndicator": "SP",
"destinationCountryCode": "CR",
"accountType": "EPS",
"accountNumber": "XXXXXXXXXX"
}'Response:
{
"SKU": "IXIP0XXXXCX0500",
"priceType": "COMMERCIAL",
"price": 19.55,
"extraService": "930",
"name": "Insurance <= $500",
"warnings": []
}Given size/weight/destination of pieces, returns a list of potential rates. Can also search for contract rates by providing mailer id, EPS, permit number or vendor number and account. If searching for contract rates, then a specified mail class is required.
curl -X 'POST' 'https://api.usps.com/international-prices/v3/base-rates-list/search' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $TOKEN' \
--data '{
"originZIPCode": "22407",
"foreignPostalCode": "10109",
"destinationCountryCode": "CA",
"weight": 4,
"mailingDate": "2024-02-29",
"length": 6,
"width": 0.25,
"height": 3,
"mailClass": "PRIORITY_MAIL_INTERNATIONAL",
"accountType": "EPS",
"accountNumber": "XXXXXXXXXX"
}'Response:
{
"rateOptions": [
{
"rates": [
{
"mailClass": "PRIORITY_MAIL_INTERNATIONAL",
"priceType": "COMMERCIAL_BASE",
"dimWeight": 0,
"zone": "01",
"fees": [],
"startDate": "2024-01-21",
"endDate": "",
"SKU": "IPFE0XXXXB01040",
"price": 29.66,
"weight": 4,
"description": "Priority Mail International ISC Flat Rate Envelope"
}
],
"totalBasePrice": 29.66
},
{
"rates": [
{
"mailClass": "PRIORITY_MAIL_INTERNATIONAL",
"priceType": "COMMERCIAL_BASE",
"dimWeight": 0,
"zone": "01",
"fees": [],
"startDate": "2024-01-21",
"endDate": "",
"SKU": "IPFB2XXXXB01040",
"price": 30.67,
"weight": 4,
"description": "Priority Mail International Machinable ISC Small Flat Rate Box"
}
],
"totalBasePrice": 30.67
},
{
"rates": [
{
"mailClass": "PRIORITY_MAIL_INTERNATIONAL",
"priceType": "COMMERCIAL_BASE",
"dimWeight": 0,
"zone": "01",
"fees": [],
"startDate": "2024-01-21",
"endDate": "",
"SKU": "IPFB0XXXXB01200",
"price": 70.55,
"weight": 4,
"description": "Priority Mail International Machinable ISC Large Flat Rate Box"
}
],
"totalBasePrice": 70.55
},
{
"rates": [
{
"mailClass": "PRIORITY_MAIL_INTERNATIONAL",
"priceType": "COMMERCIAL_BASE",
"dimWeight": 0,
"zone": "01",
"fees": [],
"startDate": "2024-01-21",
"endDate": "",
"SKU": "IPFB1XXXXB01200",
"price": 58.06,
"weight": 4,
"description": "Priority Mail International Machinable ISC Medium Flat Rate Box"
}
],
"totalBasePrice": 58.06
},
{
"rates": [
{
"mailClass": "PRIORITY_MAIL_INTERNATIONAL",
"priceType": "COMMERCIAL_BASE",
"dimWeight": 0,
"zone": "01",
"fees": [],
"startDate": "2024-01-21",
"endDate": "",
"SKU": "IPFE2XXXXB01040",
"price": 29.66,
"weight": 4,
"description": "Priority Mail International Machinable ISC Padded Flat Rate Envelope"
}
],
"totalBasePrice": 29.66
},
{
"rates": [
{
"mailClass": "PRIORITY_MAIL_INTERNATIONAL",
"priceType": "COMMERCIAL_BASE",
"dimWeight": 0,
"zone": "01",
"fees": [],
"startDate": "2024-01-21",
"endDate": "",
"SKU": "IPXX0XXXXB01040",
"price": 50.6,
"weight": 4,
"description": "Priority Mail International ISC Single-piece"
}
],
"totalBasePrice": 50.6
},
{
"rates": [
{
"mailClass": "PRIORITY_MAIL_INTERNATIONAL",
"priceType": "COMMERCIAL_BASE",
"dimWeight": 0,
"zone": "01",
"fees": [],
"startDate": "2024-01-21",
"endDate": "",
"SKU": "IPXX0XXXXB01040",
"price": 50.6,
"weight": 4,
"description": "Priority Mail International Machinable ISC Single-piece"
}
],
"totalBasePrice": 50.6
},
{
"rates": [
{
"mailClass": "PRIORITY_MAIL_INTERNATIONAL",
"priceType": "COMMERCIAL_BASE",
"dimWeight": 0,
"zone": "01",
"fees": [],
"startDate": "2024-01-21",
"endDate": "",
"SKU": "IPFE1XXXXB01040",
"price": 29.66,
"weight": 4,
"description": "Priority Mail International ISC Legal Flat Rate Envelope"
}
],
"totalBasePrice": 29.66
}
]
}Performs a search for base price and extraServices using the submitted rate ingredients. If itemValue is not included the response will not include insurance, registered mail, and collect on delivery extra services. If the extraService array is not specified then all eligible extra services will be included.
curl -X 'POST' 'https://api.usps.com/international-prices/v3/total-rates/search' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $TOKEN' \
--data '{
"originZIPCode": "22407",
"foreignPostalCode": "63118",
"destinationCountryCode": "CA",
"weight": 1.2,
"length": 6,
"width": 6,
"height": 6,
"mailClass": "PRIORITY_MAIL_EXPRESS_INTERNATIONAL",
"priceType": "COMMERCIAL",
"mailingDate": "2024-02-29",
"accountType": "EPS",
"accountNumber": "XXXXXXXXXX",
"itemValue": 300,
"extraServices": [
955
]
}'Response:
{
"rateOptions": [
{
"totalBasePrice": 65.64,
"totalPrice": 71.44,
"rates": [
{
"description": "Priority Mail Express International ISC Single-piece",
"priceType": "COMMERCIAL_BASE",
"price": 65.64,
"weight": 1.2,
"dimWeight": 0.0,
"fees": [],
"startDate": "2024-01-21",
"endDate": "",
"mailClass": "PRIORITY_MAIL_EXPRESS_INTERNATIONAL",
"zone": "01",
"SKU": "IEXX0XXXXB01020"
}
],
"extraServices": [
{
"extraService": "955",
"name": "Return Receipt",
"priceType": "COMMERCIAL",
"price": 5.80,
"warnings": [],
"SKU": "IXRX0XXXXCX0000"
}
]
},
{
"totalBasePrice": 55.49,
"totalPrice": 61.29,
"rates": [
{
"description": "Priority Mail Express International ISC Padded Flat Rate Envelope",
"priceType": "COMMERCIAL_BASE",
"price": 55.49,
"weight": 1.2,
"dimWeight": 0.0,
"fees": [],
"startDate": "2024-01-21",
"endDate": "",
"mailClass": "PRIORITY_MAIL_EXPRESS_INTERNATIONAL",
"zone": "01",
"SKU": "IEFE2XXXXB01040"
}
],
"extraServices": [
{
"extraService": "955",
"name": "Return Receipt",
"priceType": "COMMERCIAL",
"price": 5.80,
"warnings": [],
"SKU": "IXRX0XXXXCX0000"
}
]
}
]
}The Locations APIs can be used to find USPS facility addresses, hours of operations, available services and more. The purpose of this API is for users to lookup eligible entry locations to receive destination entry rates. USPS has specific rules for these entry types where the volume is only accepted at specific locations. With that in mind the idea is before a mailer submits a label request they may want to check what the acceptable entry locations are for the different rates. So, they could call the API with a destination ZIP Code of 29601 and we would respond with one facility for the DDU entry, one for SCF, & one for NDC (all of which could be unique facilities).
curl -X 'GET' 'https://api.usps.com/locations/v3/dropoff-locations?mailClass=PARCEL_SELECT&destinationZIPCode=30343' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer $TOKEN'Response: dropoff-location-v3-response.json
curl -X 'GET' 'https://api.usps.com/locations/v3/post-office-locations?radius=1&ZIPCode=10463' \
--header 'Authorization: Bearer $TOKEN' \Response: postoffice-locator-v3-response.json
This API supports the service standards for the number of days between the acceptance and delivery of a piece of mail that the Postal Service™ considers to be timely delivery. Service standards are delivery benchmarks for how long customers can expect for the Postal Service to deliver different types of mail from origin to destination — Point A to Point B. Service standards are not necessarily the same as the actual service performance.
Allows customers to get estimates on delivery standards between 3 or 5 digit ZIP Codes for the selected mail classes.
curl -X 'GET' 'https://api.usps.com/service-standards/v3/estimates?originZIPCode=10018&destinationZIPCode=95823&acceptanceDate=2023-05-26&mailClass=PRIORITY_MAIL&destinationType=HOLD_FOR_PICKUP&serviceTypeCodes=925' \
--header 'Authorization: Bearer $TOKEN' \Response:
[
{
"mailClass": "PRIORITY_MAIL",
"destinationType": "HOLD_FOR_PICKUP",
"acceptanceDateTime": "2023-05-26T12:00:00Z",
"effectiveAcceptanceDate": "2023-05-26",
"cutOffTime": 1700,
"serviceStandard": 2,
"serviceStandardMessage": "2-Day",
"acceptanceLocations": {
"facilityType": "POST OFFICE",
"streetAddress": "223 W 38TH ST",
"city": "NEW YORK",
"state": "NY",
"ZIPCode": 10018,
"ZIPPlus4": 9998
},
"delivery": {
"scheduledDeliveryDateTime": "2023-05-30",
"holdForPickupLocation": {
"facilityName": "PARKWAY",
"streetAddress": "4301 BROOKFIELD DR",
"city": "SACRAMENTO",
"state": "CA",
"ZIPCode": 95823,
"ZIPPlus4": 9998,
"closeTimes": {
"Monday": 1700,
"Tuesday": 1700,
"Wednesday": 1700,
"Thursday": 1700,
"Friday": 1700,
"Saturday": 1500,
"Sunday": "0000",
"holidays": "0000"
}
}
}
}
]Returns the average number of days it will take a package to arrive at its destination for the selected mail class.
curl -X 'GET' 'https://api.usps.com/service-standards/v3/standards?originZIPCode=10018&destinationZIPCode=95823&mailClass=PRIORITY_MAIL&destinationType=HOLD_FOR_PICKUP&serviceTypeCodes=925' \
--header 'Authorization: Bearer $TOKEN' \Response:
[
{
"mailClass": "PRIORITY_MAIL",
"originZIPCode": 10018,
"destinationZIPCode": 95823,
"days": 2,
"effectiveAcceptanceDate": "2023-05-23",
"scheduledDeliveryDate": "2023-05-25"
}
]Shipment Confirmation Acceptance Notice(SCAN) form allows integrators to link multiple domestic and international labels through one Electronic File Number (EFN) and physical SCAN Form (PS Form 5630 or 3152). The USPS scans this form at mailing acceptance to generate an acceptance tracking event for each linked label.
Save the example request body to a file: SCANForm-LabelShipment-request.json
curl -X 'POST' 'https://api.usps.com/scan-forms/v3/scan-form' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $TOKEN' \
--data @SCANForm-LabelShipment-request.json \
Response: SCANForm-LabelShipment-response.json
Save the example request body to a file: SCANForm-MIDShipment-request.json
curl -X 'POST' 'https://api.usps.com/scan-forms/v3/scan-form' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $TOKEN' \
--data @SCANForm-MIDShipment-request.json \
Response: SCANForm-MIDShipment-response.json
Save the example request body to a file: SCANForm-ManifestMIDShipment-request.json
curl -X 'POST' 'https://api.usps.com/scan-forms/v3/scan-form' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $TOKEN' \
--data @SCANForm-ManifestMIDShipment-request.json \
Response: SCANForm-ManifestMIDShipment-response.json
Receive a comprehensive list of pricing, service standards, and shipping options for USPS products within a single API call.
Allows users to generate a comprehensive list of shipping options that comply with USPS Shipping Standards, all within a single request.
curl -X 'POST' 'https://api.usps.com/shipments/v3/options/search' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer $TOKEN' \
--data '{
"pricingOptions": [
{
"priceType": "COMMERCIAL",
"paymentAccount": {
"accountType": "EPS",
"accountNumber": "XXXXXXXXXX"
}
}
],
"originZIPCode": "05485-8016",
"destinationZIPCode": "38746 0230",
"packageDescription": {
"weight": 1,
"length": 1,
"height": 1,
"width": 1,
"girth": 1,
"mailClass": "PARCEL_SELECT",
"extraServices": [
365
],
"mailingDate": "2024-05-01",
"packageValue": 35
}
}'Response:
{
"originZIPCode": "05485-8016",
"destinationZIPCode": "38746-0230",
"pricingOptions": [
{
"shippingOptions": [
{
"mailClass": "PARCEL_SELECT",
"rateOptions": [
{
"commitment": {
"name": "3 Days",
"scheduleDeliveryDate": "2024-05-04"
},
"totalPrice": 3.40,
"totalBasePrice": 3.40,
"rates": [
{
"description": "Parcel Select Nonmachinable DDU Single-piece",
"startDate": "2024-01-21",
"endDate": "",
"price": 3.4,
"zone": "00",
"weight": 1.0,
"dimensionalWeight": 0.0,
"fees": [],
"SKU": "DVXP0XXUXC00010"
}
],
"extraServices": [
{
"name": "Global Direct Entry",
"price": 0.00,
"SKU": "NA"
}
]
},
{
"commitment": {
"name": "3 Days",
"scheduleDeliveryDate": "2024-05-04"
},
"totalPrice": 5.48,
"totalBasePrice": 5.48,
"rates": [
{
"description": "Parcel Select Nonmachinable DNDC Single-piece",
"startDate": "2024-01-21",
"endDate": "",
"price": 5.48,
"zone": "00",
"weight": 1.0,
"dimensionalWeight": 0.0,
"fees": [],
"SKU": "DVXP0XXCXC00010"
}
],
"extraServices": [
{
"name": "Global Direct Entry",
"price": 0.00,
"SKU": "NA"
}
]
},
{
"commitment": {
"name": "3 Days",
"scheduleDeliveryDate": "2024-05-04"
},
"totalPrice": 5.29,
"totalBasePrice": 5.29,
"rates": [
{
"description": "Parcel Select Nonmachinable DSCF SCF",
"startDate": "2024-01-21",
"endDate": "",
"price": 5.29,
"zone": "00",
"weight": 1.0,
"dimensionalWeight": 0.0,
"fees": [],
"SKU": "DVXP0XXFXC00010"
}
],
"extraServices": [
{
"name": "Global Direct Entry",
"price": 0.00,
"SKU": "NA"
}
]
},
{
"commitment": {
"name": "3 Days",
"scheduleDeliveryDate": "2024-05-04"
},
"totalPrice": 4.17,
"totalBasePrice": 4.17,
"rates": [
{
"description": "Parcel Select Nonmachinable DHUB Single-piece",
"startDate": "2024-01-21",
"endDate": "",
"price": 4.17,
"zone": "00",
"weight": 1.0,
"dimensionalWeight": 0.0,
"fees": [],
"SKU": "DVXP0XXBXC00010"
}
],
"extraServices": [
{
"name": "Global Direct Entry",
"price": 0.00,
"SKU": "NA"
}
]
}
]
}
],
"priceType": "COMMERCIAL",
"paymentAccount": {
"accountType": "EPS",
"accountNumber": "XXXXXXXXXX"
}
}
]
}This API returns tracking status and related details for a given USPS package, including scan events and their date, time, and location. The Tracking APIs allow you to integrate the status of your shipment into your customer-facing experience and internal fulfillment processes that will benefit your company by:
Gets the tracking summary about a single USPS package. The USPS Tracking Request displays the delivery status on such mail items as Priority Mail, Priority Mail Express, and Package Services (Parcel Post, Bound Printed Matter, Library Mail, and Media Mail) packages with USPS Tracking. USPS Tracking collects mail class and service information on the mail piece from Product Tracking Systems and provides it to the user. USPS Tracking displays/Returns the summarized delivery status of single Priority Mail and Package Service Parcels with Delivery Confirmation by supplying the Tracking number.
curl -X 'GET' 'https://api.usps.com/tracking/v3/tracking/{Tracking Number}?expand=summary' \
--header 'Authorization: Bearer $TOKEN' \
--data '' Response:
{
"TrackResults": {
"RequestSeqNumber": null,
"TrackInfo": {
"@ID": "XXXXXXXXXXXXXXXXXXXX",
"TrackSummary": "USPS is now in possession of your item as of 7:31 am on February 15, 2023 in RICHMOND, VA 23227."
}
}
}Gets the detailed tracking information about a single USPS package. The USPS Tracking Request displays the delivery status on such mail items as Priority Mail, Priority Mail Express, and Package Services (Parcel Post, Bound Printed Matter, Library Mail, and Media Mail) packages with USPS Tracking. USPS Tracking collects mail class and service information on the mail piece from Product Tracking Systems and provides it to the user. USPS Tracking displays/Returns the detailed delivery status of single Priority Mail and Package Service Parcels with Delivery Confirmation by supplying the Tracking number.
curl -X 'GET' 'https://api.usps.com/tracking/v3/tracking/{Tracking Number}?expand=detail' \
--header 'Authorization: Bearer $TOKEN' \
--data ''Response:
{
"destinationCity": "CEDAR RAPIDS",
"destinationState": "IA",
"destinationZIP": "52404",
"emailEnabled": "true",
"kahalaIndicator": "false",
"mailClass": "Priority Mail<SUP>®</SUP>",
"mailType": "DM",
"originCity": "RICHMOND",
"originState": "VA",
"originZIP": "23227",
"proofOfDeliveryEnabled": "false",
"restoreEnabled": "false",
"RRAMEnabled": "false",
"RREEnabled": "false",
"services": "USPS Tracking<SUP>®</SUP>",
"serviceTypeCode": "14",
"status": "USPS in possession of item",
"statusCategory": "Accepted",
"statusSummary": "USPS is now in possession of your item as of 7:31 am on August 2, 2023 in RICHMOND, VA 23227.",
"trackingEvents": [
{
"eventType": "USPS in possession of item",
"eventTimestamp": "2023-08-02T07:31:00Z",
"eventCountry": null,
"eventCity": "RICHMOND",
"eventState": "VA",
"eventZIP": "23227",
"firm": null,
"name": null,
"authorizedAgent": "false",
"eventCode": "03",
"additionalProp": null
}
],
"trackingNumber": "XXXXXXXXXXXXXXXXXXXX"
}Please review the Error Inventory for an exhaustive list of error messages.
Here is a Postman Collection of the above curl commands above that you can utilize to help in getting a jump start of using USPS APIs.
Example postman collection file: Example postman collection.json