├── .github └── ISSUE_TEMPLATE │ ├── bug_report.md │ └── feature_request.md ├── Error Inventory └── API Error Consolidated List.xlsx ├── Example-Postman.postman_collection.json ├── README.md ├── SCANForm-LabelShipment-request.json ├── SCANForm-LabelShipment-response.json ├── SCANForm-MIDShipment-request.json ├── SCANForm-MIDShipment-response.json ├── SCANForm-ManifestMIDShipment-request.json ├── SCANForm-ManifestMIDShipment-response.json ├── USPS APIs Domestic Labels API Documentation_2023_0901 Published.pdf ├── dropoff-location-v3-response.json └── postoffice-locator-v3-response.json /.github/ISSUE_TEMPLATE/bug_report.md: -------------------------------------------------------------------------------- 1 | --- 2 | name: Bug report 3 | about: Create a report to help us improve 4 | title: '' 5 | labels: '' 6 | assignees: '' 7 | 8 | --- 9 | 10 | # WARNING: Do not post secrets or personally identifiable information in this form 11 | 12 | **Describe the bug** 13 | A clear and concise description of what the bug is. 14 | 15 | **To Reproduce** 16 | Steps to reproduce the behavior: 17 | 1. Go to '...' 18 | 2. Click on '....' 19 | 3. Scroll down to '....' 20 | 4. See error 21 | 22 | **Expected behavior** 23 | A clear and concise description of what you expected to happen. 24 | 25 | **Screenshots** 26 | If applicable, add screenshots to help explain your problem. 27 | 28 | **Desktop (please complete the following information):** 29 | - OS: [e.g. iOS] 30 | - Browser [e.g. chrome, safari] 31 | - Version [e.g. 22] 32 | 33 | **Smartphone (please complete the following information):** 34 | - Device: [e.g. iPhone6] 35 | - OS: [e.g. iOS8.1] 36 | - Browser [e.g. stock browser, safari] 37 | - Version [e.g. 22] 38 | 39 | **Additional context** 40 | Add any other context about the problem here. 41 | -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/feature_request.md: -------------------------------------------------------------------------------- 1 | --- 2 | name: Feature request 3 | about: Suggest an idea for this project 4 | title: '' 5 | labels: '' 6 | assignees: '' 7 | 8 | --- 9 | # WARNING: Do not post secrets or personally identifiable information in this form 10 | 11 | **Is your feature request related to a problem? Please describe.** 12 | A clear and concise description of what the problem is. Ex. I'm always frustrated when [...] 13 | 14 | **Describe the solution you'd like** 15 | A clear and concise description of what you want to happen. 16 | 17 | **Describe alternatives you've considered** 18 | A clear and concise description of any alternative solutions or features you've considered. 19 | 20 | **Additional context** 21 | Add any other context or screenshots about the feature request here. 22 | -------------------------------------------------------------------------------- /Error Inventory/API Error Consolidated List.xlsx: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/USPS/api-examples/c980c5264781bd4a4e82a878272c9a3a19899250/Error Inventory/API Error Consolidated List.xlsx -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # USPS API 2 | 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. 3 | 4 | ## Getting Started 5 | To use the USPS APIs in Production and the Test Environment you must be a registered user. 6 | 1. Apply for a free USPS.com account. 7 | 2. Access the [Business Customer Gateway](https://gateway.usps.com/eAdmin/view/signin) and follow the prompts to create a USPS.com business account. 8 | 3. Using your USPS account, access the [USPS Developer Portal](https://developers.usps.com) by clicking the Sign Up / Login link. 9 | 4. Registering your application and retrieve your consumer key and consumer secret from the credential section. 10 | 5. Additionally, you will need to have a Customer ID (CRID) and Mailer ID (MID) 11 | 12 | ## Using the APIs in the USPS Test Environment 13 | All USPS APIs listed below are Production URL. To use the API in Test Environment you need to change the URL from https://apis.usps.com to https://apis-tem.usps.com. 14 | 15 | ## OAuth Token 16 | 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. 17 | 18 | OAuth 2.0 API 19 | 20 | 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. 21 | 22 | Prepare your credentials for use in the following examples: 23 | ```sh 24 | CLIENT_ID=XXXX 25 | CLIENT_SECRET=XXXX 26 | CUSTOMER_REGISTRATION_ID=XXXX 27 | MAILER_ID=XXXX 28 | ``` 29 | 30 | ### Example OAuth Client Credentials Token request: 31 | ```sh 32 | curl -X 'POST' 'https://apis.usps.com/oauth2/v3/token' \ 33 | --header 'Content-Type: application/json' \ 34 | --data '{ 35 | "client_id": "{{CLIENT_ID}}", 36 | "client_secret": "{{CLIENT_SECRET}}", 37 | "grant_type": "client_credentials" 38 | }' 39 | ``` 40 | ```json 41 | { 42 | "access_token": "XXXXXXXXXXXXXXXXX", 43 | "token_type": "Bearer", 44 | "issued_at": "1111111111111", 45 | "expires_in": "11111", 46 | "status": "approved", 47 | "scope": "addresses service-delivery-standards locations prices tracking labels", 48 | "issuer": "https://keyc.usps.com/realms/USPS", 49 | "client_id": "XXXXXXXXXXXXXXXXXXXXXXXXXX", 50 | "application_name": "XXXXXX-XXXX-XXXX-XXX-XXXXXXXXXXXX", 51 | "api_products": "[XXXXXXX]", 52 | "public_key": "XXXXXXXXXXXXXXXXX" 53 | } 54 | ``` 55 | 56 | Set your access token to an environment variable for use in subsequent requests. 57 | ```sh 58 | export $TOKEN= 59 | ``` 60 | 61 | ### Example OAuth Authorization Code Token request : 62 | ```sh 63 | curl -X 'POST' 'https://apis.usps.com/oauth2/v3/token' \ 64 | --header 'Content-Type: application/json' \ 65 | --data '{ 66 | "client_id": "{{CLIENT_ID}}", 67 | "client_secret": "{{CLIENT_SECRET}}", 68 | "code": "{{CODE}}", 69 | "redirect_uri": "https://mycompany.com/authorize", 70 | "scope": "prices labels tracking", 71 | "state": "nonce=abscdefg#", 72 | "grant_type": "authorization_code" 73 | }' 74 | ``` 75 | ```json 76 | { 77 | "access_token": "XXXXXXXXXXXXXXXXX", 78 | "token_type": "Bearer", 79 | "issued_at": "1111111111111", 80 | "expires_in": "11111", 81 | "status": "approved", 82 | "scope": "prices labels tracking", 83 | "issuer": "api.usps.com", 84 | "refresh_token": "XXXXXXXXXXXXXXXXX", 85 | "refresh_token_issued_at": 1111111111111, 86 | "refresh_token_status": "approved", 87 | "refresh_token_expires_in": 11111, 88 | "refresh_count": 0, 89 | "client_id": "XXXXXXXXXXXXXXXXXXXXXXXXXX", 90 | "application_name": "XXXXXX-XXXX-XXXX-XXX-XXXXXXXXXXXX", 91 | "api_products": "[XXXXXXX]", 92 | "public_key": "XXXXXXXXXXXXXXXXX" 93 | } 94 | ``` 95 | 96 | ### Example OAuth Refresh Token request : 97 | ```sh 98 | curl -X 'POST' 'https://apis.usps.com/oauth2/v3/token' \ 99 | --header 'Content-Type: application/json' \ 100 | --data '{ 101 | "client_id": "{{CLIENT_ID}}", 102 | "client_secret": "{{CLIENT_SECRET}}", 103 | "grant_type": "refresh_token", 104 | "refresh_token": "XXXXXXXXXXXXXXXXX" 105 | }' 106 | ``` 107 | ```json 108 | { 109 | "access_token": "XXXXXXXXXXXXXXXXX", 110 | "token_type": "Bearer", 111 | "issued_at": "1111111111111", 112 | "expires_in": "11111", 113 | "status": "approved", 114 | "scope": "prices labels tracking", 115 | "issuer": "api.usps.com", 116 | "refresh_token": "XXXXXXXXXXXXXXXXX", 117 | "refresh_token_issued_at": 1111111111111, 118 | "refresh_token_status": "approved", 119 | "refresh_token_expires_in": 11111, 120 | "refresh_count": 1, 121 | "client_id": "XXXXXXXXXXXXXXXXXXXXXXXXXX", 122 | "application_name": "XXXXXX-XXXX-XXXX-XXX-XXXXXXXXXXXX", 123 | "api_products": "[XXXXXXX]", 124 | "public_key": "XXXXXXXXXXXXXXXXX" 125 | } 126 | ``` 127 | 128 | ### Example Revoke OAuth Token request : 129 | ```sh 130 | curl -X 'POST' 'https://apis.usps.com/oauth2/v3/revoke' \ 131 | --header 'Content-Type: application/json' \ 132 | --header 'Authorization: Bearer $TOKEN' \ 133 | --data '{ 134 | "token": "ExDTmpomcDt6pTbFVvSgQ1km39YmX8Oy", 135 | "token_type_hint": "refresh_token" 136 | }' 137 | ``` 138 | ``` 139 | 200 OK 140 | ``` 141 | 142 | 143 | ## Addresses 144 | The 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. 145 | 146 | ### Address 147 | 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. 148 | ```sh 149 | curl -X 'GET' 'https://apis.usps.com/addresses/v3/address?streetAddress=3120%20M%20St&secondaryAddress=NW&city=Washington&state=DC&ZIPCode=20027&ZIPPlus4=3704' \ 150 | --header 'accept: application/json' \ 151 | --header 'authorization: Bearer $TOKEN' \ 152 | ``` 153 | Response: 154 | ```json 155 | { 156 | "firm": null, 157 | "address": { 158 | "streetAddress": "3120 M ST NW", 159 | "streetAddressAbbreviation": null, 160 | "secondaryAddress": null, 161 | "city": "WASHINGTON", 162 | "cityAbbreviation": null, 163 | "state": "DC", 164 | "postalCode": null, 165 | "province": null, 166 | "ZIPCode": "20007", 167 | "ZIPPlus4": "3704", 168 | "urbanization": null, 169 | "country": null, 170 | "countryISOCode": null 171 | }, 172 | "addressAdditionalInfo": { 173 | "deliveryPoint": "20", 174 | "carrierRoute": "C036", 175 | "DPVConfirmation": "Y", 176 | "DPVCMRA": "N", 177 | "business": "Y", 178 | "centralDeliveryPoint": "N", 179 | "vacant": "N" 180 | }, 181 | "addressCorrections": null, 182 | "addressMatches": null 183 | } 184 | ``` 185 | ### City and State 186 | Returns city and state corresponding to a given ZIP code. 187 | ```sh 188 | curl -X 'GET' 'https://apis.usps.com/addresses/v3/city-state?ZIPCode=30022' \ 189 | --header 'accept: application/json' \ 190 | --header 'Authorization: Bearer $TOKEN' \ 191 | ``` 192 | Response: 193 | ```json 194 | { 195 | "city": "ALPHARETTA", 196 | "state": "GA" 197 | } 198 | ``` 199 | ### ZIPCode 200 | Returns the ZIP Code and ZIP Code + 4 corresponding to the given address, city, and state (use USPS state abbreviations). 201 | ```sh 202 | curl -X 'GET' 'https://apis.usps.com/addresses/v3/zipcode?streetAddress=1273%20Pale%20San%20Vitores%20RD&city=Tamuning&state=GU' \ 203 | --header 'accept: application/json' \ 204 | --header 'authorization: Bearer $TOKEN' \ 205 | ``` 206 | Response: 207 | ```json 208 | { 209 | "firm": null, 210 | "address": { 211 | "streetAddress": "1273 PALE SAN VITORES RD", 212 | "streetAddressAbbreviation": null, 213 | "secondaryAddress": null, 214 | "city": "TAMUNING", 215 | "cityAbbreviation": null, 216 | "state": "GU", 217 | "postalCode": null, 218 | "province": null, 219 | "ZIPCode": "96913", 220 | "ZIPPlus4": "4208", 221 | "urbanization": null, 222 | "country": null, 223 | "countryISOCode": null 224 | } 225 | } 226 | ``` 227 | 228 | ## Carrier Pickup 229 | 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. 230 | 231 | ### Carrier Pickup - Eligibility 232 | 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. 233 | ```sh 234 | curl -X 'GET' 'https://apis.usps.com/pickup/v3/carrier-pickup/eligibility?streetAddress=4120%20Bingham%20Ave&city=Saint%20Louis&state=MO&ZIPCode=63116' \ 235 | --header 'Accept: application/json' \ 236 | --header 'Authorization: Bearer $TOKEN' \ 237 | --data '' 238 | ``` 239 | Response: 240 | ```json 241 | { 242 | "pickupAddress": { 243 | "firstName": null, 244 | "lastName": null, 245 | "firm": null, 246 | "address": { 247 | "streetAddress": "4120 BINGHAM AVE", 248 | "secondaryAddress": null, 249 | "city": "SAINT LOUIS", 250 | "state": "MO", 251 | "ZIPCode": "63116", 252 | "ZIPPlus4": "2520", 253 | "urbanization": null 254 | }, 255 | "contact": [ 256 | { 257 | "eMail": null 258 | }, 259 | { 260 | "phone": null, 261 | "extension": null 262 | } 263 | ] 264 | } 265 | } 266 | ``` 267 | 268 | ### Carrier Pickup - Create 269 | 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. 270 | ```sh 271 | curl -X 'POST' 'https://apis.usps.com/pickup/v3/carrier-pickup' \ 272 | --header 'Accept: application/json' \ 273 | --header 'Content-Type: application/json' \ 274 | --header 'Authorization: Bearer $TOKEN' \ 275 | --data-raw '{ 276 | "pickupDate": "2023-04-21", 277 | "pickupAddress": { 278 | "firstName": "John", 279 | "lastName": "Smith", 280 | "firm": "FIRM", 281 | "address": { 282 | "streetAddress": "4120 Bingham", 283 | "streetAddressAbbreviation": "Ave", 284 | "secondaryAddress": null, 285 | "city": "Saint Louis", 286 | "cityAbbreviation": "", 287 | "state": "MO", 288 | "postalCode": "63116", 289 | "province": "", 290 | "ZIPCode": "63116", 291 | "ZIPPlus4": "2520", 292 | "urbanization": "" 293 | }, 294 | "contact": [ 295 | {"email":"john.smith@firm.com"}, 296 | {"phone": "3333333333"} 297 | ] 298 | }, 299 | "packages": [ 300 | { 301 | "packageType": "FIRST-CLASS_PACKAGE_SERVICE", 302 | "packageCount": 1 303 | } 304 | ], 305 | "estimatedWeight": 5, 306 | "pickupLocation": { 307 | "packageLocation": "OFFICE", 308 | "specialInstructions": "Have a nice day" 309 | } 310 | }' 311 | ``` 312 | Response: 313 | ```json 314 | { 315 | "confirmationNumber": "{Confirmation Number}", 316 | "pickupAddress": { 317 | "firstName": "JOHN", 318 | "lastName": "SMITH", 319 | "firm": "FIRM", 320 | "address": { 321 | "streetAddress": "4120 BINGHAM AVE", 322 | "secondaryAddress": null, 323 | "city": "SAINT LOUIS", 324 | "state": "MO", 325 | "ZIPCode": "63116", 326 | "ZIPPlus4": "2520", 327 | "urbanization": null 328 | }, 329 | "contact": [ 330 | { 331 | "email": "JOHN.SMITH@FIRM.COM" 332 | }, 333 | { 334 | "phone": "3333333333", 335 | "extension": null 336 | } 337 | ] 338 | }, 339 | "packages": [ 340 | { 341 | "packageType": "FIRST-CLASS_PACKAGE_SERVICE", 342 | "packageCount": "1" 343 | }, 344 | { 345 | "packageType": "PRIORITY_MAIL_EXPRESS", 346 | "packageCount": "0" 347 | }, 348 | { 349 | "packageType": "PRIORITY_MAIL", 350 | "packageCount": "0" 351 | }, 352 | { 353 | "packageType": "RETURNS", 354 | "packageCount": "0" 355 | }, 356 | { 357 | "packageType": "INTERNATIONAL", 358 | "packageCount": "0" 359 | }, 360 | { 361 | "packageType": "OTHER", 362 | "packageCount": "0" 363 | } 364 | ], 365 | "estimatedWeight": "5", 366 | "pickupLocation": { 367 | "packageLocation": "OFFICE", 368 | "specialInstructions": "HAVE A NICE DAY" 369 | }, 370 | "pickupDate": "2023-04-20" 371 | } 372 | ``` 373 | 374 | ### Carrier Pickup - Get 375 | Get the previously scheduled carrier pickup by confirmation number. Responds with the entity tag (ETag) to use when updating or cancelling this pickup. 376 | ```sh 377 | curl -X 'GET' 'https://apis.usps.com/pickup/v3/carrier-pickup/{Confirmation Number}' \ 378 | --header 'Accept: application/json' \ 379 | --header 'Authorization: Bearer $TOKEN' \ 380 | ``` 381 | Response: 382 | ```json 383 | { 384 | "confirmationNumber": "{Confirmation Number}", 385 | "pickupAddress": { 386 | "firstName": "JOHN", 387 | "lastName": "SMITH", 388 | "firm": "FIRM", 389 | "address": { 390 | "streetAddress": "4120 BINGHAM AVE", 391 | "secondaryAddress": null, 392 | "city": "SAINT LOUIS", 393 | "state": "MO", 394 | "ZIPCode": "63116", 395 | "ZIPPlus4": "2520", 396 | "urbanization": null 397 | }, 398 | "contact": [ 399 | { 400 | "email": "JOHN.SMITH@FIRM.COM" 401 | }, 402 | { 403 | "phone": "3333333333", 404 | "extension": null 405 | } 406 | ] 407 | }, 408 | "packages": [ 409 | { 410 | "packageType": "FIRST-CLASS_PACKAGE_SERVICE", 411 | "packageCount": "1" 412 | }, 413 | { 414 | "packageType": "PRIORITY_MAIL_EXPRESS", 415 | "packageCount": "0" 416 | }, 417 | { 418 | "packageType": "PRIORITY_MAIL", 419 | "packageCount": "0" 420 | }, 421 | { 422 | "packageType": "RETURNS", 423 | "packageCount": "0" 424 | }, 425 | { 426 | "packageType": "INTERNATIONAL", 427 | "packageCount": "0" 428 | }, 429 | { 430 | "packageType": "OTHER", 431 | "packageCount": "0" 432 | } 433 | ], 434 | "estimatedWeight": "5", 435 | "pickupLocation": { 436 | "packageLocation": "OFFICE", 437 | "specialInstructions": "HAVE A NICE DAY" 438 | }, 439 | "pickupDate": "2023-04-20" 440 | } 441 | ``` 442 | 443 | ### Carrier Pickup - Update 444 | 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. 445 | ```sh 446 | curl --request PUT 'https://apis.usps.com/pickup/v3/carrier-pickup/{Confirmation Number}' \ 447 | --header 'Accept: application/json' \ 448 | --header 'Content-Type: application/json' \ 449 | --header 'If-Match: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX' \ 450 | --header 'Authorization: Bearer $TOKEN' \ 451 | --data-raw '{ 452 | "confirmationNumber": "{Confirmation Number}", 453 | "pickupDate": "2023-04-22", 454 | "pickupAddress": { 455 | "firstName": "Smith", 456 | "lastName": "John", 457 | "firm": "FIRM", 458 | "address": { 459 | "streetAddress": "4120 Bingham", 460 | "streetAddressAbbreviation": "Ave", 461 | "secondaryAddress": null, 462 | "city": "Saint Louis", 463 | "cityAbbreviation": "", 464 | "state": "MO", 465 | "postalCode": "63116", 466 | "province": "", 467 | "ZIPCode": "63116", 468 | "ZIPPlus4": "", 469 | "urbanization": "" 470 | }, 471 | "contact": [ 472 | {"email":"smith.john@firm.com"}, 473 | {"phone": "3333333333"} 474 | ] 475 | }, 476 | "packages": [ 477 | { 478 | "packageType": "FIRST-CLASS_PACKAGE_SERVICE", 479 | "packageCount": 5 480 | } 481 | ], 482 | "estimatedWeight": 15, 483 | "pickupLocation": { 484 | "packageLocation": "OFFICE", 485 | "specialInstructions": "Have a nice day after carrier pickup updated 2" 486 | } 487 | }' 488 | ``` 489 | Response: 490 | ```json 491 | { 492 | "confirmationNumber": "{Confirmation Number}", 493 | "pickupAddress": { 494 | "firstName": "SMITH", 495 | "lastName": "JOHN", 496 | "firm": "FIRM", 497 | "address": { 498 | "streetAdress": "4120 BINGHAM AVE", 499 | "secondaryAddress": null, 500 | "city": "SAINT LOUIS", 501 | "state": "MO", 502 | "ZIPCode": "63116", 503 | "ZIPLus4": "2520", 504 | "urbanization": null 505 | }, 506 | "contact": [ 507 | { 508 | "email": "SMITH.JOHN@FIRM.COM" 509 | }, 510 | { 511 | "phone": "3333333333", 512 | "extension": null 513 | } 514 | ] 515 | }, 516 | "packages": [ 517 | { 518 | "packageType": "FIRST-CLASS_PACKAGE_SERVICE", 519 | "packageCount": "5" 520 | }, 521 | { 522 | "packageType": "PRIORITY_MAIL_EXPRESS", 523 | "packageCount": "0" 524 | }, 525 | { 526 | "packageType": "PRIORITY_MAIL", 527 | "packageCount": "0" 528 | }, 529 | { 530 | "packageType": "RETURNS", 531 | "packageCount": "0" 532 | }, 533 | { 534 | "packageType": "INTERNATIONAL", 535 | "packageCount": "0" 536 | }, 537 | { 538 | "packageType": "OTHER", 539 | "packageCount": "0" 540 | } 541 | ], 542 | "estimatedWeight": "15", 543 | "pickupLocation": { 544 | "packageLocation": "OFFICE", 545 | "specialInstructions": "HAVE A NICE DAY AFTER CARRIER PICKUP UPDATED 2" 546 | }, 547 | "pickupDate": "2023-04-22" 548 | } 549 | ``` 550 | 551 | ### Carrier Pickup - Delete 552 | 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. 553 | ```sh 554 | curl --request DELETE 'https://apis.usps.com/pickup/v3/carrier-pickup/{Confirmation Number}' \ 555 | --header 'Accept: application/json' \ 556 | --header 'If-Match: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX' \ 557 | --header 'Authorization: Bearer $TOKEN' \ 558 | --data '' 559 | ``` 560 | Response: 200 OK if successful 561 | 562 | 563 | ## Containers 564 | 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. 565 | 566 | ### Add Packages or Mail to a Container Manifest 567 | When a user creates a container, the container can be updated with additional tracking numbers with this endpoint. 568 | ```sh 569 | curl -X 'POST' 'https://apis.usps.com/containers/v3/containers/99M900066875EMA000051/packages' \ 570 | --header 'Content-Type: application/json' \ 571 | --header 'Authorization: Bearer $TOKEN' \ 572 | --data '{ 573 | "trackingNumbers": [ 574 | "9261212345678900017627" 575 | ] 576 | }' 577 | ``` 578 | Response: 579 | ```json 580 | { 581 | "containerID": "99M900066875EMA000051", 582 | "sortType": "SACK", 583 | "destinationEntryFacilityType": "DESTINATION_DELIVERY_UNIT", 584 | "destinationZIPCode": "06701", 585 | "mailClass": "PARCEL_SELECT", 586 | "originAddress": { 587 | "streetAddress": "900 BRENTWOOD RD NE", 588 | "secondaryAddress": null, 589 | "city": "Washington", 590 | "state": "DC", 591 | "urbanization": "", 592 | "ZIPCode": "20018", 593 | "ZIPPlus4": "0000" 594 | }, 595 | "mailerName": "John Smith AC.", 596 | "processingCategory": "MACHINABLE", 597 | "containerTopology": "NESTED", 598 | "warnings": [], 599 | "MID": "XXXXXXXXX" 600 | } 601 | ``` 602 | 603 | ### Create a Container Label 604 | Allows the caller to get a container label and associate packages to that container. 605 | ```sh 606 | curl -X 'POST' 'https://apis.usps.com/containers/v3/containers' \ 607 | --header 'Content-Type: application/json' \ 608 | --header 'Authorization: Bearer $TOKEN' \ 609 | --data '{ 610 | "imageInfo": { 611 | "imageType": "PDF", 612 | "labelType": "6X4LABEL" 613 | }, 614 | "trackingNumbers":[ 615 | "9261212345678900017634" 616 | ], 617 | "sortType": "SACK", 618 | "destinationEntryFacilityType": "DESTINATION_DELIVERY_UNIT", 619 | "destinationZIPCode": "06701", 620 | "mailClass": "PARCEL_SELECT", 621 | "originAddress": { 622 | "streetAddress": "900 BRENTWOOD RD NE", 623 | "secondaryAddress": "", 624 | "city": "Washington", 625 | "state": "DC", 626 | "ZIPCode": "20018", 627 | "ZIPPlus4": "0000", 628 | "urbanization": "" 629 | }, 630 | "mailerName": "John Smith AC.", 631 | "processingCategory": "MACHINABLE", 632 | "containerTopology": "NESTED", 633 | "MID": "XXXXXXXXX" 634 | }' 635 | ``` 636 | Response: 637 | ```json 638 | --XkxytuhvSSXDz-aV1q2YverB 639 | Content-Type: application/json 640 | Content-Disposition: form-data; name="containerMetadata" 641 | 642 | { 643 | "containerID": "99M900066875EMA000052", 644 | "sortType": "SACK", 645 | "destinationEntryFacilityType": "DESTINATION_DELIVERY_UNIT", 646 | "destinationZIPCode": "06701", 647 | "mailClass": "PARCEL_SELECT", 648 | "originAddress": { 649 | "streetAddress": "900 BRENTWOOD RD NE", 650 | "secondaryAddress": "", 651 | "city": "Washington", 652 | "state": "DC", 653 | "urbanization": "", 654 | "ZIPCode": "20018", 655 | "ZIPPlus4": "0000" 656 | }, 657 | "mailerName": "John Smith AC.", 658 | "processingCategory": "MACHINABLE", 659 | "containerTopology": "NESTED", 660 | "warnings": [], 661 | "MID": "XXXXXXXXX" 662 | } 663 | --XkxytuhvSSXDz-aV1q2YverB 664 | Content-Type: application/pdf 665 | Content-Disposition: form-data; filename="labelImage.pdf"; name="labelImage" 666 | 667 | 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Pj4KZW5kb2JqCjExIDAgb2JqCjw8IC9UeXBlIC9QYWdlcwovQ291bnQgMQovS2lkcyBbOSAwIFIgXSA+PgplbmRvYmoKMTQgMCBvYmoKPDwKICAvVHlwZSAvQ2F0YWxvZwogIC9QYWdlcyAxMSAwIFIKICAvTGFuZyAoeC11bmtub3duKQo+PgplbmRvYmoKMTAgMCBvYmoKPDwKICAvRm9udCA8PCAvRjEgMTIgMCBSIC9GMyAxMyAwIFIgPj4KICAvUHJvY1NldCBbL1BERiAvSW1hZ2VCIC9JbWFnZUMgL1RleHRdCiAgL1hPYmplY3QgPDwgL0ltMSA1IDAgUiA+PgogIC9Db2xvclNwYWNlIDw8IC9JQ0MyIDQgMCBSID4+Cj4+CmVuZG9iagp4cmVmCjAgMTUKMDAwMDAwMDAwMCA2NTUzNSBmIAowMDAwMDAwMDE1IDAwMDAwIG4gCjAwMDAwMDAxMzEgMDAwMDAgbiAKMDAwMDAwMjY4OCAwMDAwMCBuIAowMDAwMDAyNzA4IDAwMDAwIG4gCjAwMDAwMDI3NDEgMDAwMDAgbiAKMDAwMDAwMzE3MiAwMDAwMCBuIAowMDAwMDAzMTkxIDAwMDAwIG4gCjAwMDAwMDQ3ODAgMDAwMDAgbiAKMDAwMDAwNDgwMCAwMDAwMCBuIAowMDAwMDA1MzQzIDAwMDAwIG4gCjAwMDAwMDUyMDkgMDAwMDAgbiAKMDAwMDAwNDk5MiAwMDAwMCBuIAowMDAwMDA1MDk4IDAwMDAwIG4gCjAwMDAwMDUyNjggMDAwMDAgbiAKdHJhaWxlcgo8PAogIC9Sb290IDE0IDAgUgogIC9JbmZvIDEgMCBSCiAgL0lEIFs8Mjc2NDQ2ODg1RjA5NTgyMEZDMUIyOUIwQjdDMTg1OTI+IDwyNzY0NDY4ODVGMDk1ODIwRkMxQjI5QjBCN0MxODU5Mj5dCiAgL1NpemUgMTUKPj4Kc3RhcnR4cmVmCjU1MDEKJSVFT0YK 668 | --XkxytuhvSSXDz-aV1q2YverB-- 669 | ``` 670 | 671 | 672 | ## Domestic Label 673 | 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. 674 | 675 | The following fields are used to assure that a label is generated: 676 | - Account Type, specify the type of payment account, either EPS or PERMIT; 677 | - Account Number, specify the account number for either the EPS or PERMIT account (e.g., permit number), and 678 | - Permit ZIP Code, specify the permit ZIP code for the PERMIT account. it is not required for an EPS account. 679 | 680 | ### Set the payment account for Domestic Label : 681 | ```sh 682 | curl -X 'POST' 'https://apis.usps.com/payments/v3/payment-authorization' \ 683 | --header 'Content-Type: application/json' \ 684 | --header 'Authorization: Bearer $TOKEN' \ 685 | --data '{ 686 | "roles": [ 687 | { 688 | "roleName": "PAYER", 689 | "CRID": "XXXXXXXX", 690 | "MID": "XXXXXXXXX", 691 | "manifestMID": "XXXXXXXXX", 692 | "accountType": "EPS", 693 | "accountNumber": "XXXXXXXXXX" 694 | }, 695 | { 696 | "roleName": "LABEL_OWNER", 697 | "CRID": "XXXXXXXX", 698 | "MID": "XXXXXXXXX", 699 | "manifestMID": "XXXXXXXXX", 700 | "accountType": "EPS", 701 | "accountNumber": "XXXXXXXXXX" 702 | } 703 | ] 704 | }' 705 | ``` 706 | Response: 707 | ```json 708 | { 709 | "paymentAuthorizationToken": "XXXXXXXXXXXXXXXXXXXXXX", 710 | "roles": [ 711 | { 712 | "roleName": "PAYER", 713 | "CRID": "XXXXXXXX", 714 | "MID": "XXXXXXXXX", 715 | "manifestMID": "XXXXXXXXX", 716 | "accountType": "EPS", 717 | "accountNumber": "XXXXXXXXXX" 718 | }, 719 | { 720 | "roleName": "LABEL_OWNER", 721 | "CRID": "XXXXXXXX", 722 | "MID": "XXXXXXXXX", 723 | "manifestMID": "XXXXXXXXX", 724 | "accountType": "EPS", 725 | "accountNumber": "XXXXXXXXXX" 726 | } 727 | ] 728 | } 729 | ``` 730 | 731 | Set your access token to an environment variable for use in subsequent requests. 732 | ```sh 733 | export $PAYMENTTOKEN= 734 | ``` 735 | 736 | ### Domestic Label Request 737 | ```sh 738 | curl -X 'POST' 'https://apis.usps.com/labels/v3/label' \ 739 | --header 'X-Payment-Authorization-Token: $PAYMENTTOKEN'\ 740 | --header 'Content-Type: application/json' \ 741 | --header 'Authorization: Bearer $TOKEN' \ 742 | --data '{ 743 | "imageInfo": { 744 | "imageType": "PDF", 745 | "labelType": "4X6LABEL", 746 | "receiptOption": "NONE", 747 | "suppressPostage": false, 748 | "suppressMailDate": false, 749 | "returnLabel": false 750 | }, 751 | "toAddress": { 752 | "firstName": "Joe", 753 | "lastName": "Doe", 754 | "streetAddress": "1100 Wyoming", 755 | "secondaryAddress": "Suite 150", 756 | "city": "St. Louis", 757 | "state": "MO", 758 | "ZIPCode": "63118" 759 | }, 760 | "fromAddress": { 761 | "firstName": "John", 762 | "lastName": "Smith", 763 | "streetAddress": "4120 Bingham Ave", 764 | "city": "St. Louis", 765 | "state": "MO", 766 | "ZIPCode": "63116" 767 | }, 768 | "packageDescription": { 769 | "mailClass": "PRIORITY_MAIL", 770 | "rateIndicator": "SP", 771 | "weightUOM": "lb", 772 | "weight": 0.5, 773 | "dimensionsUOM": "in", 774 | "length": 9, 775 | "width": 0.25, 776 | "height": 6, 777 | "processingCategory": "MACHINABLE", 778 | "mailingDate": "2025-05-26", 779 | "extraServices": [ 780 | 920 781 | ], 782 | "destinationEntryFacilityType": "NONE", 783 | "packageOptions": { 784 | "packageValue": 400 785 | } 786 | } 787 | }' 788 | 789 | ``` 790 | Response: 791 | ```json 792 | 793 | Content-Disposition: form-data; name="labelMetadata" 794 | Content-type: application/json 795 | 796 | { 797 | "labelAddress": { 798 | "streetAddress": "1100 WYOMING ST", 799 | "secondaryAddress": "STE 150", 800 | "city": "SAINT LOUIS", 801 | "state": "MO", 802 | "ZIPCode": "63118", 803 | "ZIPPlus4": "2628", 804 | "firstName": "JOE", 805 | "lastName": "DOE", 806 | "ignoreBadAddress": false 807 | }, 808 | "routingInformation": "420631182628", 809 | "trackingNumber": "XXXXXXXXXXXXXXXXXXXXXX", 810 | "postage": 7.99, 811 | "extraServices": [ 812 | { 813 | "name": "USPS Tracking", 814 | "price": 0.0, 815 | "SKU": "XXXXXXXXXXXXX" 816 | } 817 | ], 818 | "zone": "01", 819 | "commitment": { 820 | "name": "2 Days", 821 | "scheduleDeliveryDate": "2025-05-29" 822 | }, 823 | "weightUOM": "LB", 824 | "weight": 0.5, 825 | "dimensionalWeight": 0.0, 826 | "fees": [], 827 | "bannerText": "USPS TRACKING # USPS Ship", 828 | "retailDistributionCode": "03", 829 | "serviceTypeCode": "055", 830 | "constructCode": "C01", 831 | "parcelLockerNumber": "", 832 | "SKU": "XXXXXXXXXXXX", 833 | "links": [ 834 | { 835 | "rel": [ 836 | "Tracking URL" 837 | ], 838 | "href": "https://tools.usps.com/go/TrackConfirmAction_input?origTrackNum=XXXXXXXXXXXXXXXXXXXXXX", 839 | "method": "GET" 840 | } 841 | ] 842 | } 843 | Content-Type: application/pdf 844 | Content-Disposition: form-data; filename="labelImage.pdf"; name="labelImage" 845 | X 846 | ``` 847 | 848 | 849 | ### Edit Label - 850 | 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. 851 | 852 | Note: Label edits will not be supported for the following scenarios, instead unused label refunds should be requested and new labels should be created. 853 | 854 | - All label edits are disallowed if the original label was created with a suppressPostage = false 855 | - No dimensional updates are supported for Cubic Softpack Labels 856 | - Cubic labels can not be edited to non-cubic rate indicators 857 | ```sh 858 | curl -X 'PATCH' 'https://apis.usps.com/labels/v3/label/1234567890123456789012' \ 859 | --header 'X-Payment-Authorization-Token: $PAYMENTTOKEN'\ 860 | --header 'Content-Type: application/json' \ 861 | --header 'Authorization: Bearer $TOKEN' \ 862 | --data '{ 863 | { 864 | "op": "replace", 865 | "path": "/packageDescription/weight", 866 | "value": 1 867 | }, 868 | { 869 | "op": "replace", 870 | "path": "/packageDescription/length", 871 | "value": 10 872 | }, 873 | { 874 | "op": "replace", 875 | "path": "/packageDescription/height", 876 | "value": 7 877 | }, 878 | { 879 | "op": "replace", 880 | "path": "/packageDescription/width", 881 | "value": 4.5 882 | }, 883 | { 884 | "op": "replace", 885 | "path": "/packageDescription/girth", 886 | "value": 0.50 887 | }, 888 | { 889 | "op": "replace", 890 | "path": "/packageDescription/processingCategory", 891 | "value": "NON_MACHINABLE" 892 | }, 893 | { 894 | "op": "replace", 895 | "path": "/packageDescription/containers", 896 | "value": [ 897 | { 898 | "containerID": "123456789012345", 899 | "sortType": "PALLET" 900 | } 901 | ] 902 | }, 903 | { 904 | "op": "replace", 905 | "path": "/packageDescription/rateIndicator", 906 | "value": "CP" 907 | } 908 | }' 909 | ``` 910 | Response: 911 | ```json 912 | { 913 | "labelAddress": { 914 | "streetAddress": "1100 WYOMING ST", 915 | "secondaryAddress": "STE 150", 916 | "city": "SAINT LOUIS", 917 | "state": "MO", 918 | "ZIPCode": "63118", 919 | "ZIPPlus4": "2628", 920 | "firstName": "JOE", 921 | "lastName": "DOE", 922 | "ignoreBadAddress": false 923 | }, 924 | "routingInformation": "123456789102", 925 | "trackingNumber": "{{trackingNumber}}", 926 | "postage": 7.05, 927 | "extraServices": [ 928 | { 929 | "name": "USPS Tracking", 930 | "price": 0.0, 931 | "SKU": "XXXXXXXXXXXXX" 932 | } 933 | ], 934 | "zone": "01", 935 | "commitment": { 936 | "name": "6 Days", 937 | "scheduleDeliveryDate": "2024-06-22" 938 | }, 939 | "weightUOM": "LB", 940 | "weight": 1.0, 941 | "fees": [], 942 | "labelBrokerID": "", 943 | "constructCode": "C01", 944 | "SKU": "XXXXXXXXXXXXX" 945 | } 946 | ``` 947 | 948 | ### First-Class Letter or Flat Indicia - 949 | Generate a First-Class indicia for use on letter and flat mailings. 950 | 951 | Only supported for 'PAYER' Roles with an EPS accountType. 952 | ```sh 953 | curl -X 'PATCH' 'https://apis.usps.com/labels/v3/indicia' \ 954 | --header 'X-Payment-Authorization-Token: $PAYMENTTOKEN'\ 955 | --header 'Content-Type: application/json' \ 956 | --header 'Authorization: Bearer $TOKEN' \ 957 | --data '{ 958 | "indiciaDescription": { 959 | "processingCategory": "LETTERS", 960 | "weight": 3.5, 961 | "mailingDate": "2024-07-11", 962 | "length": 6.0, 963 | "height": 4.0, 964 | "thickness": 0.25, 965 | "nonMachinableIndicators": { 966 | "isPolybagged": true, 967 | "hasClosureDevices": true, 968 | "hasLooseItems": true, 969 | "isRigid": true, 970 | "isSelfMailer": true, 971 | "isBooklet": true 972 | } 973 | }, 974 | "imageInfo": { 975 | "imageType": "PDF", 976 | "receiptOption": "SEPARATE_PAGE" 977 | } 978 | }' 979 | ``` 980 | Response: 981 | ```json 982 | --Ah2SYTymfbGnSStJLSpLScnK 983 | Content-Type: application/json 984 | Content-Disposition: form-data; name="indiciaMetadata" 985 | 986 | { 987 | "SKU": "DFLL0XXXXR00035", 988 | "postage": 1.36, 989 | "fees": [ 990 | { 991 | "name": "Nonmachinable letter fee", 992 | "SKU": "N/A", 993 | "price": 0.4 994 | } 995 | ], 996 | "weight": 3.5 997 | } 998 | --Ah2SYTymfbGnSStJLSpLScnK 999 | Content-Type: application/pdf 1000 | Content-Disposition: form-data; filename="receiptImage.pdf"; name="receiptImage" 1001 | 1002 | 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0cyAyIDAgUgo+PgplbmRvYmoKNyAwIG9iago8PAogIC9UeXBlIC9Gb250CiAgL1N1YnR5cGUgL1R5cGUxCiAgL0Jhc2VGb250IC9IZWx2ZXRpY2EKICAvRW5jb2RpbmcgL1dpbkFuc2lFbmNvZGluZwo+PgplbmRvYmoKNiAwIG9iago8PCAvVHlwZSAvUGFnZXMKL0NvdW50IDEKL0tpZHMgWzQgMCBSIF0gPj4KZW5kb2JqCjggMCBvYmoKPDwKICAvVHlwZSAvQ2F0YWxvZwogIC9QYWdlcyA2IDAgUgogIC9MYW5nICh4LXVua25vd24pCj4+CmVuZG9iago1IDAgb2JqCjw8IC9Gb250IDw8IC9GMSA3IDAgUiA+PiAvUHJvY1NldCBbL1BERiAvSW1hZ2VCIC9JbWFnZUMgL1RleHRdID4+CmVuZG9iagp4cmVmCjAgOQowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMTUgMDAwMDAgbiAKMDAwMDAwMDEzMSAwMDAwMCBuIAowMDAwMDA2NDU5IDAwMDAwIG4gCjAwMDAwMDY0NzkgMDAwMDAgbiAKMDAwMDAwNjkwNSAwMDAwMCBuIAowMDAwMDA2Nzc0IDAwMDAwIG4gCjAwMDAwMDY2NjkgMDAwMDAgbiAKMDAwMDAwNjgzMiAwMDAwMCBuIAp0cmFpbGVyCjw8CiAgL1Jvb3QgOCAwIFIKICAvSW5mbyAxIDAgUgogIC9JRCBbPDg5N0Q4MUE5RUVDMkY5RDI4MTNGNTY1MDkxMTA2NEFDPiA8ODk3RDgxQTlFRUMyRjlEMjgxM0Y1NjUwOTExMDY0QUM+XQogIC9TaXplIDkKPj4Kc3RhcnR4cmVmCjY5ODYKJSVFT0YK 1003 | --Ah2SYTymfbGnSStJLSpLScnK 1004 | Content-Type: application/pdf 1005 | Content-Disposition: form-data; filename="indiciaImage.pdf"; name="indiciaImage" 1006 | 1007 | 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cGUgL0NhdGFsb2cKICAvUGFnZXMgMTEgMCBSCiAgL0xhbmcgKHgtdW5rbm93bikKPj4KZW5kb2JqCjEwIDAgb2JqCjw8CiAgL0ZvbnQgPDwgL0YxIDEyIDAgUiAvRjMgMTMgMCBSID4+CiAgL1Byb2NTZXQgWy9QREYgL0ltYWdlQiAvSW1hZ2VDIC9UZXh0XQogIC9YT2JqZWN0IDw8IC9JbTEgNSAwIFIgPj4KICAvQ29sb3JTcGFjZSA8PCAvSUNDMiA0IDAgUiA+Pgo+PgplbmRvYmoKeHJlZgowIDE1CjAwMDAwMDAwMDAgNjU1MzUgZiAKMDAwMDAwMDAxNSAwMDAwMCBuIAowMDAwMDAwMTMxIDAwMDAwIG4gCjAwMDAwMDI2ODggMDAwMDAgbiAKMDAwMDAwMjcwOCAwMDAwMCBuIAowMDAwMDAyNzQxIDAwMDAwIG4gCjAwMDAwMDMyNzEgMDAwMDAgbiAKMDAwMDAwMzI5MCAwMDAwMCBuIAowMDAwMDA0ODk1IDAwMDAwIG4gCjAwMDAwMDQ5MTUgMDAwMDAgbiAKMDAwMDAwNTQ1OCAwMDAwMCBuIAowMDAwMDA1MzI0IDAwMDAwIG4gCjAwMDAwMDUxMDcgMDAwMDAgbiAKMDAwMDAwNTIxMyAwMDAwMCBuIAowMDAwMDA1MzgzIDAwMDAwIG4gCnRyYWlsZXIKPDwKICAvUm9vdCAxNCAwIFIKICAvSW5mbyAxIDAgUgogIC9JRCBbPDAyQTdFNTE4QjY3Qjg3MTRDMUM3ODQ1MkRGOTc1RUY4PiA8MDJBN0U1MThCNjdCODcxNEMxQzc4NDUyREY5NzVFRjg+XQogIC9TaXplIDE1Cj4+CnN0YXJ0eHJlZgo1NjE2CiUlRU9GCg== 1008 | --Ah2SYTymfbGnSStJLSpLScnK-- 1009 | ``` 1010 | 1011 | 1012 | ## Domestic Prices 1013 | The Prices API can be used to look-up postage rates for domestic packages: 1014 | - Lookup Base Postage based on a set of given package characteristics 1015 | - Lookup Base Postage based on a given SKU 1016 | - Lookup Extra Service Postage based on a given Extra Service Code and Mail Class 1017 | - The USPS has introduced Stock Keeping Units (SKUs), creating unique identifiers for USPS products, and making them available online for mailer download. 1018 | 1019 | 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. 1020 | 1021 | ### Domestic Prices - Base Rates Request 1022 | ```sh 1023 | curl -X 'POST' 'https://apis.usps.com/prices/v3/base-rates/search' \ 1024 | --header 'Content-Type: application/json' \ 1025 | --header 'Authorization: Bearer $TOKEN' \ 1026 | --data '{ 1027 | "originZIPCode": "78664", 1028 | "destinationZIPCode": "78665", 1029 | "weight": 7, 1030 | "length": 9, 1031 | "width": 0.25, 1032 | "height": 6, 1033 | "mailClass": "PARCEL_SELECT", 1034 | "processingCategory": "MACHINABLE", 1035 | "destinationEntryFacilityType": "NONE", 1036 | "rateIndicator": "DR", 1037 | "priceType": "COMMERCIAL", 1038 | "accountType": "EPS", 1039 | "accountNumber": "XXXXXXXXXX", 1040 | "mailingDate": "2023-05-25" 1041 | }' 1042 | ``` 1043 | Response: 1044 | ```json 1045 | { 1046 | "totalBasePrice": 8.02, 1047 | "rates": [ 1048 | { 1049 | "SKU": "DVXR0XXXXC01070", 1050 | "description": "Parcel Select Ground Machinable Dimensional Rectangular", 1051 | "priceType": "COMMERCIAL", 1052 | "price": 8.02, 1053 | "weight": 7, 1054 | "dimWeight": 0, 1055 | "fees": [], 1056 | "startDate": "2023-01-22", 1057 | "endDate": "", 1058 | "warnings": [], 1059 | "mailClass": "PARCEL_SELECT", 1060 | "zone": "01" 1061 | } 1062 | ] 1063 | } 1064 | ``` 1065 | 1066 | ### Domestic Prices - Extra Services Rates Request 1067 | Returns eligible extra service prices, descriptions, and SKUs given a set of package rate ingredients. 1068 | ```sh 1069 | curl -X 'POST' 'https://apis.usps.com/prices/v3/extra-service-rates/search' \ 1070 | --header 'Content-Type: application/json' \ 1071 | --header 'Authorization: Bearer $TOKEN' \ 1072 | --data '{ 1073 | "extraService": 415, 1074 | "mailClass": "PARCEL_SELECT", 1075 | "priceType": "RETAIL", 1076 | "itemValue": 0, 1077 | "weight": 5, 1078 | "mailingDate": "2023-05-25", 1079 | "accountType": "EPS", 1080 | "accountNumber": "XXXXXXXXXX" 1081 | }' 1082 | ``` 1083 | Response: 1084 | ```json 1085 | { 1086 | "extraService": "415", 1087 | "name": "Label Delivery", 1088 | "sku": "DXQX0XXXXCX0000", 1089 | "priceType": "RETAIL", 1090 | "price": 1.25, 1091 | "warnings": [] 1092 | } 1093 | ``` 1094 | ### Domestic Prices - Total Rates Request 1095 | Returns an eligible price given a set of package rate ingredients. 1096 | ```sh 1097 | curl -X 'POST' 'https://apis.usps.com/prices/v3/total-rates/search' \ 1098 | --header 'Content-Type: application/json' \ 1099 | --header 'Authorization: Bearer $TOKEN' \ 1100 | --data '{ 1101 | "originZIPCode": "36105", 1102 | "destinationZIPCode": "78207", 1103 | "weight": 7, 1104 | "length": 9, 1105 | "width": 0.25, 1106 | "height": 6, 1107 | "mailClass": "PARCEL_SELECT", 1108 | "priceType": "COMMERCIAL", 1109 | "mailingDate": "2023-07-28", 1110 | "accountType": "EPS", 1111 | "accountNumber": "XXXXXXXXXX", 1112 | "itemValue": 500, 1113 | "extraServices": [ 1114 | 415 1115 | ] 1116 | }' 1117 | ``` 1118 | Response: 1119 | ```json 1120 | { 1121 | "rateOptions": [ 1122 | { 1123 | "totalBasePrice": 4.59, 1124 | "totalPrice": 5.84, 1125 | "rates": [ 1126 | { 1127 | "description": "Parcel Select Machinable DDU Single-piece", 1128 | "priceType": "COMMERCIAL", 1129 | "price": 4.59, 1130 | "weight": 7.0, 1131 | "dimWeight": 0.0, 1132 | "fees": [], 1133 | "startDate": "2023-07-09", 1134 | "endDate": "", 1135 | "mailClass": "PARCEL_SELECT", 1136 | "zone": "00", 1137 | "SKU": "DVXP0XXUXC00070" 1138 | } 1139 | ], 1140 | "extraServices": [ 1141 | { 1142 | "extraService": "415", 1143 | "name": "Label Delivery", 1144 | "priceType": "COMMERCIAL", 1145 | "price": 1.25, 1146 | "warnings": [], 1147 | "SKU": "DXQX0XXXXCX0000" 1148 | } 1149 | ] 1150 | }, 1151 | { 1152 | "totalBasePrice": 7.86, 1153 | "totalPrice": 9.11, 1154 | "rates": [ 1155 | { 1156 | "description": "Parcel Select Machinable DNDC Single-piece", 1157 | "priceType": "COMMERCIAL", 1158 | "price": 7.86, 1159 | "weight": 7.0, 1160 | "dimWeight": 0.0, 1161 | "fees": [], 1162 | "startDate": "2023-07-09", 1163 | "endDate": "", 1164 | "mailClass": "PARCEL_SELECT", 1165 | "zone": "00", 1166 | "SKU": "DVXP0XXCXC00070" 1167 | } 1168 | ], 1169 | "extraServices": [ 1170 | { 1171 | "extraService": "415", 1172 | "name": "Label Delivery", 1173 | "priceType": "COMMERCIAL", 1174 | "price": 1.25, 1175 | "warnings": [], 1176 | "SKU": "DXQX0XXXXCX0000" 1177 | } 1178 | ] 1179 | }, 1180 | { 1181 | "totalBasePrice": 6.79, 1182 | "totalPrice": 8.04, 1183 | "rates": [ 1184 | { 1185 | "description": "Parcel Select Machinable DSCF SCF", 1186 | "priceType": "COMMERCIAL", 1187 | "price": 6.79, 1188 | "weight": 7.0, 1189 | "dimWeight": 0.0, 1190 | "fees": [], 1191 | "startDate": "2023-07-09", 1192 | "endDate": "", 1193 | "mailClass": "PARCEL_SELECT", 1194 | "zone": "00", 1195 | "SKU": "DVXP0XXFTC00070" 1196 | } 1197 | ], 1198 | "extraServices": [ 1199 | { 1200 | "extraService": "415", 1201 | "name": "Label Delivery", 1202 | "priceType": "COMMERCIAL", 1203 | "price": 1.25, 1204 | "warnings": [], 1205 | "SKU": "DXQX0XXXXCX0000" 1206 | } 1207 | ] 1208 | }, 1209 | { 1210 | "totalBasePrice": 5.74, 1211 | "totalPrice": 6.99, 1212 | "rates": [ 1213 | { 1214 | "description": "Parcel Select Machinable Single-piece", 1215 | "priceType": "COMMERCIAL", 1216 | "price": 5.74, 1217 | "weight": 7.0, 1218 | "dimWeight": 0.0, 1219 | "fees": [], 1220 | "startDate": "2023-07-09", 1221 | "endDate": "", 1222 | "mailClass": "PARCEL_SELECT", 1223 | "zone": "00", 1224 | "SKU": "DVXP0XXBXC00070" 1225 | } 1226 | ], 1227 | "extraServices": [ 1228 | { 1229 | "extraService": "415", 1230 | "name": "Label Delivery", 1231 | "priceType": "COMMERCIAL", 1232 | "price": 1.25, 1233 | "warnings": [], 1234 | "SKU": "DXQX0XXXXCX0000" 1235 | } 1236 | ] 1237 | } 1238 | ] 1239 | } 1240 | ``` 1241 | ### Domestic Prices - Letter Rates Request 1242 | Performs a search for letter prices using the submitted rate ingredients. 1243 | ```sh 1244 | curl -X 'POST' 'https://apis.usps.com/prices/v3/letter-rates/search' \ 1245 | --header 'Content-Type: application/json' \ 1246 | --header 'Authorization: Bearer $TOKEN' \ 1247 | --data '{ 1248 | "weight": 3.5, 1249 | "length": 4.0, 1250 | "height": 5.0, 1251 | "thickness": 0.25, 1252 | "processingCategory": "LETTERS", 1253 | "mailingDate": "2023-11-29", 1254 | "nonMachinableIndicators": { 1255 | "isPolybagged": true, 1256 | "hasClosureDevices": true, 1257 | "hasLooseItems": true, 1258 | "isRigid": true, 1259 | "isSelfMailer": true, 1260 | "isBooklet": true 1261 | } 1262 | }' 1263 | ``` 1264 | Response: 1265 | ```json 1266 | { 1267 | "totalBasePrice": 1.75, 1268 | "rates": [ 1269 | { 1270 | "SKU": "DFLL0XXXXR00035", 1271 | "description": "First Class Letter Metered", 1272 | "priceType": "RETAIL", 1273 | "price": 1.35, 1274 | "weight": 3.5, 1275 | "dimWeight": null, 1276 | "fees": [ 1277 | { 1278 | "name": "Nonmachinable letter fee", 1279 | "SKU": "N/A", 1280 | "price": 0.4 1281 | } 1282 | ], 1283 | "startDate": "2023-07-09", 1284 | "endDate": "", 1285 | "warnings": [], 1286 | "mailClass": "USPS_GROUND_ADVANTAGE", 1287 | "zone": null 1288 | } 1289 | ] 1290 | } 1291 | ``` 1292 | ## International Prices 1293 | The International Prices API can be used to look-up postage rates for international packages: 1294 | - Lookup International Base Postage based on a set of given package characteristics 1295 | - Lookup International Base Postage based on a given SKU 1296 | - The USPS has introduced Stock Keeping Units (SKUs), creating unique identifiers for USPS products, and making them available online for mailer download. 1297 | 1298 | 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. 1299 | 1300 | ### International Prices - Base Rates Request 1301 | ```sh 1302 | curl -X 'POST' 'https://apis.usps.com/international-prices/v3/base-rates/search' \ 1303 | --header 'Content-Type: application/json' \ 1304 | --header 'Authorization: Bearer $TOKEN' \ 1305 | --data '{ 1306 | "originZIPCode": "22407", 1307 | "foreignPostalCode": "10109", 1308 | "destinationCountryCode": "CA", 1309 | "destinationEntryFacilityType": "NONE", 1310 | "weight": 0.5, 1311 | "length": 9, 1312 | "width": 15, 1313 | "height": 6, 1314 | "mailClass": "FIRST-CLASS_PACKAGE_INTERNATIONAL_SERVICE", 1315 | "processingCategory": "NON_MACHINABLE", 1316 | "rateIndicator": "SP", 1317 | "priceType": "COMMERCIAL", 1318 | "accountType": "EPS", 1319 | "accountNumber": "XXXXXXXXXX", 1320 | "mailingDate": "2023-05-25" 1321 | }' 1322 | ``` 1323 | ```json 1324 | { 1325 | "rates": [ 1326 | { 1327 | "SKU": "IFXP0XXXXB01080", 1328 | "description": "First-Class Package International Service Nonmachinable Single-piece", 1329 | "mailClass": "FIRST-CLASS_PACKAGE_INTERNATIONAL_SERVICE", 1330 | "priceType": "COMMERCIAL", 1331 | "zone": "01", 1332 | "dimWeight": 0, 1333 | "weight": 0.5, 1334 | "fees": [], 1335 | "price": 14.96, 1336 | "startDate": "2023-01-22", 1337 | "endDate": "", 1338 | "warnings": [] 1339 | } 1340 | ], 1341 | "totalBasePrice": 14.96 1342 | } 1343 | ``` 1344 | ### International Prices - Extra Services Rates Request 1345 | Given a set of rate ingredients, returns international extra service rates. If contractId and productId are present, include contract-based rates in the results. 1346 | ```sh 1347 | curl -X 'POST' 'https://apis.usps.com/international-prices/v3/extra-service-rates/search' \ 1348 | --header 'Content-Type: application/json' \ 1349 | --header 'Authorization: Bearer $TOKEN' \ 1350 | --data '{ 1351 | "extraService": 930, 1352 | "mailClass": "PRIORITY_MAIL_INTERNATIONAL", 1353 | "priceType": "RETAIL", 1354 | "itemValue": "500", 1355 | "weight": 4, 1356 | "mailingDate": "2023-05-25", 1357 | "rateIndicator": "SP", 1358 | "destinationCountryCode": "CR", 1359 | "accountType": "EPS", 1360 | "accountNumber": "XXXXXXXXXX" 1361 | }' 1362 | ``` 1363 | Response: 1364 | ```json 1365 | { 1366 | "SKU": "IXIP0XXXXCX0500", 1367 | "priceType": "COMMERCIAL", 1368 | "price": 19.55, 1369 | "extraService": "930", 1370 | "name": "Insurance <= $500", 1371 | "warnings": [] 1372 | } 1373 | ``` 1374 | ### International Prices - Base Rates List Request 1375 | 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. 1376 | ```sh 1377 | curl -X 'POST' 'https://apis.usps.com/international-prices/v3/base-rates-list/search' \ 1378 | --header 'Content-Type: application/json' \ 1379 | --header 'Authorization: Bearer $TOKEN' \ 1380 | --data '{ 1381 | "originZIPCode": "22407", 1382 | "foreignPostalCode": "10109", 1383 | "destinationCountryCode": "CA", 1384 | "weight": 4, 1385 | "mailingDate": "2024-02-29", 1386 | "length": 6, 1387 | "width": 0.25, 1388 | "height": 3, 1389 | "mailClass": "PRIORITY_MAIL_INTERNATIONAL", 1390 | "accountType": "EPS", 1391 | "accountNumber": "XXXXXXXXXX" 1392 | }' 1393 | ``` 1394 | Response: 1395 | ```json 1396 | { 1397 | "rateOptions": [ 1398 | { 1399 | "rates": [ 1400 | { 1401 | "mailClass": "PRIORITY_MAIL_INTERNATIONAL", 1402 | "priceType": "COMMERCIAL_BASE", 1403 | "dimWeight": 0, 1404 | "zone": "01", 1405 | "fees": [], 1406 | "startDate": "2024-01-21", 1407 | "endDate": "", 1408 | "SKU": "IPFE0XXXXB01040", 1409 | "price": 29.66, 1410 | "weight": 4, 1411 | "description": "Priority Mail International ISC Flat Rate Envelope" 1412 | } 1413 | ], 1414 | "totalBasePrice": 29.66 1415 | }, 1416 | { 1417 | "rates": [ 1418 | { 1419 | "mailClass": "PRIORITY_MAIL_INTERNATIONAL", 1420 | "priceType": "COMMERCIAL_BASE", 1421 | "dimWeight": 0, 1422 | "zone": "01", 1423 | "fees": [], 1424 | "startDate": "2024-01-21", 1425 | "endDate": "", 1426 | "SKU": "IPFB2XXXXB01040", 1427 | "price": 30.67, 1428 | "weight": 4, 1429 | "description": "Priority Mail International Machinable ISC Small Flat Rate Box" 1430 | } 1431 | ], 1432 | "totalBasePrice": 30.67 1433 | }, 1434 | { 1435 | "rates": [ 1436 | { 1437 | "mailClass": "PRIORITY_MAIL_INTERNATIONAL", 1438 | "priceType": "COMMERCIAL_BASE", 1439 | "dimWeight": 0, 1440 | "zone": "01", 1441 | "fees": [], 1442 | "startDate": "2024-01-21", 1443 | "endDate": "", 1444 | "SKU": "IPFB0XXXXB01200", 1445 | "price": 70.55, 1446 | "weight": 4, 1447 | "description": "Priority Mail International Machinable ISC Large Flat Rate Box" 1448 | } 1449 | ], 1450 | "totalBasePrice": 70.55 1451 | }, 1452 | { 1453 | "rates": [ 1454 | { 1455 | "mailClass": "PRIORITY_MAIL_INTERNATIONAL", 1456 | "priceType": "COMMERCIAL_BASE", 1457 | "dimWeight": 0, 1458 | "zone": "01", 1459 | "fees": [], 1460 | "startDate": "2024-01-21", 1461 | "endDate": "", 1462 | "SKU": "IPFB1XXXXB01200", 1463 | "price": 58.06, 1464 | "weight": 4, 1465 | "description": "Priority Mail International Machinable ISC Medium Flat Rate Box" 1466 | } 1467 | ], 1468 | "totalBasePrice": 58.06 1469 | }, 1470 | { 1471 | "rates": [ 1472 | { 1473 | "mailClass": "PRIORITY_MAIL_INTERNATIONAL", 1474 | "priceType": "COMMERCIAL_BASE", 1475 | "dimWeight": 0, 1476 | "zone": "01", 1477 | "fees": [], 1478 | "startDate": "2024-01-21", 1479 | "endDate": "", 1480 | "SKU": "IPFE2XXXXB01040", 1481 | "price": 29.66, 1482 | "weight": 4, 1483 | "description": "Priority Mail International Machinable ISC Padded Flat Rate Envelope" 1484 | } 1485 | ], 1486 | "totalBasePrice": 29.66 1487 | }, 1488 | { 1489 | "rates": [ 1490 | { 1491 | "mailClass": "PRIORITY_MAIL_INTERNATIONAL", 1492 | "priceType": "COMMERCIAL_BASE", 1493 | "dimWeight": 0, 1494 | "zone": "01", 1495 | "fees": [], 1496 | "startDate": "2024-01-21", 1497 | "endDate": "", 1498 | "SKU": "IPXX0XXXXB01040", 1499 | "price": 50.6, 1500 | "weight": 4, 1501 | "description": "Priority Mail International ISC Single-piece" 1502 | } 1503 | ], 1504 | "totalBasePrice": 50.6 1505 | }, 1506 | { 1507 | "rates": [ 1508 | { 1509 | "mailClass": "PRIORITY_MAIL_INTERNATIONAL", 1510 | "priceType": "COMMERCIAL_BASE", 1511 | "dimWeight": 0, 1512 | "zone": "01", 1513 | "fees": [], 1514 | "startDate": "2024-01-21", 1515 | "endDate": "", 1516 | "SKU": "IPXX0XXXXB01040", 1517 | "price": 50.6, 1518 | "weight": 4, 1519 | "description": "Priority Mail International Machinable ISC Single-piece" 1520 | } 1521 | ], 1522 | "totalBasePrice": 50.6 1523 | }, 1524 | { 1525 | "rates": [ 1526 | { 1527 | "mailClass": "PRIORITY_MAIL_INTERNATIONAL", 1528 | "priceType": "COMMERCIAL_BASE", 1529 | "dimWeight": 0, 1530 | "zone": "01", 1531 | "fees": [], 1532 | "startDate": "2024-01-21", 1533 | "endDate": "", 1534 | "SKU": "IPFE1XXXXB01040", 1535 | "price": 29.66, 1536 | "weight": 4, 1537 | "description": "Priority Mail International ISC Legal Flat Rate Envelope" 1538 | } 1539 | ], 1540 | "totalBasePrice": 29.66 1541 | } 1542 | ] 1543 | } 1544 | ``` 1545 | ### International Prices - Total Rates Request 1546 | 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. 1547 | ```sh 1548 | curl -X 'POST' 'https://apis.usps.com/international-prices/v3/total-rates/search' \ 1549 | --header 'Content-Type: application/json' \ 1550 | --header 'Authorization: Bearer $TOKEN' \ 1551 | --data '{ 1552 | "originZIPCode": "22407", 1553 | "foreignPostalCode": "63118", 1554 | "destinationCountryCode": "CA", 1555 | "weight": 1.2, 1556 | "length": 6, 1557 | "width": 6, 1558 | "height": 6, 1559 | "mailClass": "PRIORITY_MAIL_EXPRESS_INTERNATIONAL", 1560 | "priceType": "COMMERCIAL", 1561 | "mailingDate": "2024-02-29", 1562 | "accountType": "EPS", 1563 | "accountNumber": "XXXXXXXXXX", 1564 | "itemValue": 300, 1565 | "extraServices": [ 1566 | 955 1567 | ] 1568 | }' 1569 | ``` 1570 | Response: 1571 | ```json 1572 | { 1573 | "rateOptions": [ 1574 | { 1575 | "totalBasePrice": 65.64, 1576 | "totalPrice": 71.44, 1577 | "rates": [ 1578 | { 1579 | "description": "Priority Mail Express International ISC Single-piece", 1580 | "priceType": "COMMERCIAL_BASE", 1581 | "price": 65.64, 1582 | "weight": 1.2, 1583 | "dimWeight": 0.0, 1584 | "fees": [], 1585 | "startDate": "2024-01-21", 1586 | "endDate": "", 1587 | "mailClass": "PRIORITY_MAIL_EXPRESS_INTERNATIONAL", 1588 | "zone": "01", 1589 | "SKU": "IEXX0XXXXB01020" 1590 | } 1591 | ], 1592 | "extraServices": [ 1593 | { 1594 | "extraService": "955", 1595 | "name": "Return Receipt", 1596 | "priceType": "COMMERCIAL", 1597 | "price": 5.80, 1598 | "warnings": [], 1599 | "SKU": "IXRX0XXXXCX0000" 1600 | } 1601 | ] 1602 | }, 1603 | { 1604 | "totalBasePrice": 55.49, 1605 | "totalPrice": 61.29, 1606 | "rates": [ 1607 | { 1608 | "description": "Priority Mail Express International ISC Padded Flat Rate Envelope", 1609 | "priceType": "COMMERCIAL_BASE", 1610 | "price": 55.49, 1611 | "weight": 1.2, 1612 | "dimWeight": 0.0, 1613 | "fees": [], 1614 | "startDate": "2024-01-21", 1615 | "endDate": "", 1616 | "mailClass": "PRIORITY_MAIL_EXPRESS_INTERNATIONAL", 1617 | "zone": "01", 1618 | "SKU": "IEFE2XXXXB01040" 1619 | } 1620 | ], 1621 | "extraServices": [ 1622 | { 1623 | "extraService": "955", 1624 | "name": "Return Receipt", 1625 | "priceType": "COMMERCIAL", 1626 | "price": 5.80, 1627 | "warnings": [], 1628 | "SKU": "IXRX0XXXXCX0000" 1629 | } 1630 | ] 1631 | } 1632 | ] 1633 | } 1634 | ``` 1635 | 1636 | ## Locations 1637 | 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). 1638 | 1639 | ### Dropoff-locations 1640 | ```sh 1641 | curl -X 'GET' 'https://apis.usps.com/locations/v3/dropoff-locations?mailClass=PARCEL_SELECT&destinationZIPCode=30343' \ 1642 | --header 'Accept: application/json' \ 1643 | --header 'Authorization: Bearer $TOKEN' 1644 | ``` 1645 | 1646 | Response: 1647 | [dropoff-location-v3-response.json](https://github.com/USPS/api-examples/blob/main/dropoff-location-v3-response.json) 1648 | 1649 | ### Post Office Locator 1650 | ```sh 1651 | curl -X 'GET' 'https://apis.usps.com/locations/v3/post-office-locations?radius=1&ZIPCode=10463' \ 1652 | --header 'Authorization: Bearer $TOKEN' \ 1653 | ``` 1654 | 1655 | Response: 1656 | [postoffice-locator-v3-response.json](https://github.com/USPS/api-examples/blob/main/postoffice-locator-v3-response.json) 1657 | 1658 | 1659 | ## Service Standards 1660 | 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. 1661 | 1662 | ### Service Standards - Estimates Request 1663 | Allows customers to get estimates on delivery standards between 3 or 5 digit ZIP Codes for the selected mail classes. 1664 | ```sh 1665 | curl -X 'GET' 'https://apis.usps.com/service-standards/v3/estimates?originZIPCode=10018&destinationZIPCode=95823&acceptanceDate=2023-05-26&mailClass=PRIORITY_MAIL&destinationType=HOLD_FOR_PICKUP&serviceTypeCodes=925' \ 1666 | --header 'Authorization: Bearer $TOKEN' \ 1667 | ``` 1668 | Response: 1669 | ```json 1670 | [ 1671 | { 1672 | "mailClass": "PRIORITY_MAIL", 1673 | "destinationType": "HOLD_FOR_PICKUP", 1674 | "acceptanceDateTime": "2023-05-26T12:00:00Z", 1675 | "effectiveAcceptanceDate": "2023-05-26", 1676 | "cutOffTime": 1700, 1677 | "serviceStandard": 2, 1678 | "serviceStandardMessage": "2-Day", 1679 | "acceptanceLocations": { 1680 | "facilityType": "POST OFFICE", 1681 | "streetAddress": "223 W 38TH ST", 1682 | "city": "NEW YORK", 1683 | "state": "NY", 1684 | "ZIPCode": 10018, 1685 | "ZIPPlus4": 9998 1686 | }, 1687 | "delivery": { 1688 | "scheduledDeliveryDateTime": "2023-05-30", 1689 | "holdForPickupLocation": { 1690 | "facilityName": "PARKWAY", 1691 | "streetAddress": "4301 BROOKFIELD DR", 1692 | "city": "SACRAMENTO", 1693 | "state": "CA", 1694 | "ZIPCode": 95823, 1695 | "ZIPPlus4": 9998, 1696 | "closeTimes": { 1697 | "Monday": 1700, 1698 | "Tuesday": 1700, 1699 | "Wednesday": 1700, 1700 | "Thursday": 1700, 1701 | "Friday": 1700, 1702 | "Saturday": 1500, 1703 | "Sunday": "0000", 1704 | "holidays": "0000" 1705 | } 1706 | } 1707 | } 1708 | } 1709 | ] 1710 | ``` 1711 | 1712 | ### Service Standards - Standards Request 1713 | Returns the average number of days it will take a package to arrive at its destination for the selected mail class. 1714 | ```sh 1715 | curl -X 'GET' 'https://apis.usps.com/service-standards/v3/standards?originZIPCode=10018&destinationZIPCode=95823&mailClass=PRIORITY_MAIL&destinationType=HOLD_FOR_PICKUP&serviceTypeCodes=925' \ 1716 | --header 'Authorization: Bearer $TOKEN' \ 1717 | ``` 1718 | Response: 1719 | ```json 1720 | [ 1721 | { 1722 | "mailClass": "PRIORITY_MAIL", 1723 | "originZIPCode": 10018, 1724 | "destinationZIPCode": 95823, 1725 | "days": 2, 1726 | "effectiveAcceptanceDate": "2023-05-23", 1727 | "scheduledDeliveryDate": "2023-05-25" 1728 | } 1729 | ] 1730 | ``` 1731 | 1732 | 1733 | ## Shipment Confirmation Acceptance Notice (SCAN) Form 1734 | 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. 1735 | 1736 | ### SCAN Form - Label Shipment 1737 | Save the example request body to a file: [SCANForm-LabelShipment-request.json](https://github.com/USPS/api-examples/blob/main/SCANForm-LabelShipment-request.json) 1738 | ```sh 1739 | curl -X 'POST' 'https://apis.usps.com/scan-forms/v3/scan-form' \ 1740 | --header 'Content-Type: application/json' \ 1741 | --header 'Authorization: Bearer $TOKEN' \ 1742 | --data @SCANForm-LabelShipment-request.json \ 1743 | 1744 | ``` 1745 | Response: 1746 | [SCANForm-LabelShipment-response.json](https://github.com/USPS/api-examples/blob/main/SCANForm-LabelShipment-response.json) 1747 | 1748 | ### SCAN Form - MID Shipment 1749 | Save the example request body to a file: [SCANForm-MIDShipment-request.json](https://github.com/USPS/api-examples/blob/main/SCANForm-MIDShipment-request.json) 1750 | ```sh 1751 | curl -X 'POST' 'https://apis.usps.com/scan-forms/v3/scan-form' \ 1752 | --header 'Content-Type: application/json' \ 1753 | --header 'Authorization: Bearer $TOKEN' \ 1754 | --data @SCANForm-MIDShipment-request.json \ 1755 | 1756 | ``` 1757 | Response: 1758 | [SCANForm-MIDShipment-response.json](https://github.com/USPS/api-examples/blob/main/SCANForm-MIDShipment-response.json) 1759 | 1760 | ### SCAN Form - Manifest MID Shipment 1761 | Save the example request body to a file: [SCANForm-ManifestMIDShipment-request.json](https://github.com/USPS/api-examples/blob/main/SCANForm-ManifestMIDShipment-request.json) 1762 | ```sh 1763 | curl -X 'POST' 'https://apis.usps.com/scan-forms/v3/scan-form' \ 1764 | --header 'Content-Type: application/json' \ 1765 | --header 'Authorization: Bearer $TOKEN' \ 1766 | --data @SCANForm-ManifestMIDShipment-request.json \ 1767 | 1768 | ``` 1769 | Response: 1770 | [SCANForm-ManifestMIDShipment-response.json](https://github.com/USPS/api-examples/blob/main/SCANForm-ManifestMIDShipment-response.json) 1771 | 1772 | 1773 | ## Shipping Options 1774 | Receive a comprehensive list of pricing, service standards, and shipping options for USPS products within a single API call. 1775 | 1776 | ### Shipping Options - Package Shipping Options 1777 | Allows users to generate a comprehensive list of shipping options that comply with USPS Shipping Standards, all within a single request. 1778 | ```sh 1779 | curl -X 'POST' 'https://apis.usps.com/shipments/v3/options/search' \ 1780 | --header 'Accept: application/json' \ 1781 | --header 'Authorization: Bearer $TOKEN' \ 1782 | --data '{ 1783 | "pricingOptions": [ 1784 | { 1785 | "priceType": "COMMERCIAL", 1786 | "paymentAccount": { 1787 | "accountType": "EPS", 1788 | "accountNumber": "XXXXXXXXXX" 1789 | } 1790 | } 1791 | ], 1792 | "originZIPCode": "05485-8016", 1793 | "destinationZIPCode": "38746 0230", 1794 | "packageDescription": { 1795 | "weight": 1, 1796 | "length": 1, 1797 | "height": 1, 1798 | "width": 1, 1799 | "girth": 1, 1800 | "mailClass": "PARCEL_SELECT", 1801 | "extraServices": [ 1802 | 365 1803 | ], 1804 | "mailingDate": "2024-05-01", 1805 | "packageValue": 35 1806 | } 1807 | }' 1808 | ``` 1809 | Response: 1810 | ```json 1811 | { 1812 | "originZIPCode": "05485-8016", 1813 | "destinationZIPCode": "38746-0230", 1814 | "pricingOptions": [ 1815 | { 1816 | "shippingOptions": [ 1817 | { 1818 | "mailClass": "PARCEL_SELECT", 1819 | "rateOptions": [ 1820 | { 1821 | "commitment": { 1822 | "name": "3 Days", 1823 | "scheduleDeliveryDate": "2024-05-04" 1824 | }, 1825 | "totalPrice": 3.40, 1826 | "totalBasePrice": 3.40, 1827 | "rates": [ 1828 | { 1829 | "description": "Parcel Select Nonmachinable DDU Single-piece", 1830 | "startDate": "2024-01-21", 1831 | "endDate": "", 1832 | "price": 3.4, 1833 | "zone": "00", 1834 | "weight": 1.0, 1835 | "dimensionalWeight": 0.0, 1836 | "fees": [], 1837 | "SKU": "DVXP0XXUXC00010" 1838 | } 1839 | ], 1840 | "extraServices": [ 1841 | { 1842 | "name": "Global Direct Entry", 1843 | "price": 0.00, 1844 | "SKU": "NA" 1845 | } 1846 | ] 1847 | }, 1848 | { 1849 | "commitment": { 1850 | "name": "3 Days", 1851 | "scheduleDeliveryDate": "2024-05-04" 1852 | }, 1853 | "totalPrice": 5.48, 1854 | "totalBasePrice": 5.48, 1855 | "rates": [ 1856 | { 1857 | "description": "Parcel Select Nonmachinable DNDC Single-piece", 1858 | "startDate": "2024-01-21", 1859 | "endDate": "", 1860 | "price": 5.48, 1861 | "zone": "00", 1862 | "weight": 1.0, 1863 | "dimensionalWeight": 0.0, 1864 | "fees": [], 1865 | "SKU": "DVXP0XXCXC00010" 1866 | } 1867 | ], 1868 | "extraServices": [ 1869 | { 1870 | "name": "Global Direct Entry", 1871 | "price": 0.00, 1872 | "SKU": "NA" 1873 | } 1874 | ] 1875 | }, 1876 | { 1877 | "commitment": { 1878 | "name": "3 Days", 1879 | "scheduleDeliveryDate": "2024-05-04" 1880 | }, 1881 | "totalPrice": 5.29, 1882 | "totalBasePrice": 5.29, 1883 | "rates": [ 1884 | { 1885 | "description": "Parcel Select Nonmachinable DSCF SCF", 1886 | "startDate": "2024-01-21", 1887 | "endDate": "", 1888 | "price": 5.29, 1889 | "zone": "00", 1890 | "weight": 1.0, 1891 | "dimensionalWeight": 0.0, 1892 | "fees": [], 1893 | "SKU": "DVXP0XXFXC00010" 1894 | } 1895 | ], 1896 | "extraServices": [ 1897 | { 1898 | "name": "Global Direct Entry", 1899 | "price": 0.00, 1900 | "SKU": "NA" 1901 | } 1902 | ] 1903 | }, 1904 | { 1905 | "commitment": { 1906 | "name": "3 Days", 1907 | "scheduleDeliveryDate": "2024-05-04" 1908 | }, 1909 | "totalPrice": 4.17, 1910 | "totalBasePrice": 4.17, 1911 | "rates": [ 1912 | { 1913 | "description": "Parcel Select Nonmachinable DHUB Single-piece", 1914 | "startDate": "2024-01-21", 1915 | "endDate": "", 1916 | "price": 4.17, 1917 | "zone": "00", 1918 | "weight": 1.0, 1919 | "dimensionalWeight": 0.0, 1920 | "fees": [], 1921 | "SKU": "DVXP0XXBXC00010" 1922 | } 1923 | ], 1924 | "extraServices": [ 1925 | { 1926 | "name": "Global Direct Entry", 1927 | "price": 0.00, 1928 | "SKU": "NA" 1929 | } 1930 | ] 1931 | } 1932 | ] 1933 | } 1934 | ], 1935 | "priceType": "COMMERCIAL", 1936 | "paymentAccount": { 1937 | "accountType": "EPS", 1938 | "accountNumber": "XXXXXXXXXX" 1939 | } 1940 | } 1941 | ] 1942 | } 1943 | ``` 1944 | 1945 | 1946 | ## Tracking 1947 | 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: 1948 | - Providing your customers with the latest status and delivery expectations while keeping them within your company’s or organization’s website. 1949 | - Integrating status and delivery information for incoming packages or customer returns directly into your systems and processes so that you know when a package will arrive at your facilities. 1950 | 1951 | ### Tracking - Single Request - Summary 1952 | 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. 1953 | ```sh 1954 | curl -X 'GET' 'https://apis.usps.com/tracking/v3/tracking/{Tracking Number}?expand=summary' \ 1955 | --header 'Authorization: Bearer $TOKEN' \ 1956 | --data '' 1957 | ``` 1958 | 1959 | Response: 1960 | 1961 | ```json 1962 | { 1963 | "TrackResults": { 1964 | "RequestSeqNumber": null, 1965 | "TrackInfo": { 1966 | "@ID": "XXXXXXXXXXXXXXXXXXXX", 1967 | "TrackSummary": "USPS is now in possession of your item as of 7:31 am on February 15, 2023 in RICHMOND, VA 23227." 1968 | } 1969 | } 1970 | } 1971 | ``` 1972 | 1973 | ### Tracking - Single Request - Detail 1974 | 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. 1975 | ```sh 1976 | curl -X 'GET' 'https://apis.usps.com/tracking/v3/tracking/{Tracking Number}?expand=DETAIL' \ 1977 | --header 'Authorization: Bearer $TOKEN' \ 1978 | --data '' 1979 | ``` 1980 | Response: 1981 | ```json 1982 | { 1983 | "destinationCity": "CEDAR RAPIDS", 1984 | "destinationState": "IA", 1985 | "destinationZIP": "52404", 1986 | "emailEnabled": "true", 1987 | "kahalaIndicator": "false", 1988 | "mailClass": "Priority Mail®", 1989 | "mailType": "DM", 1990 | "originCity": "RICHMOND", 1991 | "originState": "VA", 1992 | "originZIP": "23227", 1993 | "proofOfDeliveryEnabled": "false", 1994 | "restoreEnabled": "false", 1995 | "RRAMEnabled": "false", 1996 | "RREEnabled": "false", 1997 | "services": "USPS Tracking®", 1998 | "serviceTypeCode": "14", 1999 | "status": "USPS in possession of item", 2000 | "statusCategory": "Accepted", 2001 | "statusSummary": "USPS is now in possession of your item as of 7:31 am on August 2, 2023 in RICHMOND, VA 23227.", 2002 | "trackingEvents": [ 2003 | { 2004 | "eventType": "USPS in possession of item", 2005 | "eventTimestamp": "2023-08-02T07:31:00Z", 2006 | "eventCountry": null, 2007 | "eventCity": "RICHMOND", 2008 | "eventState": "VA", 2009 | "eventZIP": "23227", 2010 | "firm": null, 2011 | "name": null, 2012 | "authorizedAgent": "false", 2013 | "eventCode": "03", 2014 | "additionalProp": null 2015 | } 2016 | ], 2017 | "trackingNumber": "XXXXXXXXXXXXXXXXXXXX" 2018 | } 2019 | ``` 2020 | 2021 | ## USPS APIs Error Handling 2022 | Please review the [Error Inventory ](https://github.com/USPS/api-examples/tree/main/Error%20Inventory) for an exhaustive list of error messages. 2023 | 2024 | 2025 | ## Postman Collection 2026 | 2027 | 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. 2028 | 2029 | Example postman collection file: [Example postman collection.json](https://github.com/USPS/api-examples/blob/main/Example-Postman.postman_collection.json) 2030 | -------------------------------------------------------------------------------- /SCANForm-LabelShipment-request.json: -------------------------------------------------------------------------------- 1 | { 2 | "form": "5630", 3 | "imageType": "PDF", 4 | "labelType": "8.5x11LABEL", 5 | "mailingDate": "2023-04-19", 6 | "entryFacilityZIPCode": "45011", 7 | "entryFacilityZIPPlus4": "", 8 | "destinationEntryFacilityType": "NONE", 9 | "overwriteMailingDate": false, 10 | "shipment": { 11 | "trackingNumbers": [ 12 | "XXXXXXXXXXXXXXXXXXXXXX" 13 | ] 14 | }, 15 | "fromAddress": { 16 | "firstName": "Leroy", 17 | "lastName": "Brown", 18 | "firm": "USPS", 19 | "address": { 20 | "streetAddress": "4261 Port Union Road", 21 | "streetAddressAbbreviation": "", 22 | "secondaryAddress": "APT N", 23 | "city": "West Chester", 24 | "cityAbbreviation": "", 25 | "state": "OH", 26 | "ZIPCode": "45011", 27 | "ZIPPlus4": "1175", 28 | "urbanization": "URB Fair Oaks", 29 | "country": "United States", 30 | "countryISOCode": 840 31 | } 32 | } 33 | } -------------------------------------------------------------------------------- /SCANForm-LabelShipment-response.json: -------------------------------------------------------------------------------- 1 | --9oxGwpVpWyl-C7mImcElxzrQ 2 | Content-Type: application/json 3 | Content-Disposition: form-data; name="Scan Form Response" 4 | 5 | { 6 | "form": "5630", 7 | "imageType": "PDF", 8 | "labelType": "8.5x11LABEL", 9 | "mailingDate": "2023-04-19", 10 | "overwriteMailingDate": false, 11 | "entryFacilityZIPCode": "45011", 12 | "destinationEntryFacilityType": "NONE", 13 | "shipment": { 14 | "trackingNumbers": [ 15 | "XXXXXXXXXXXXXXXXXXXXXX" 16 | ] 17 | }, 18 | "fromAddress": { 19 | "firstName": "Leroy", 20 | "lastName": "Brown", 21 | "firm": "USPS", 22 | "address": { 23 | "streetAddress": "APT N", 24 | "streetAddressAbbreviation": "", 25 | "secondaryAddress": "4261 PORT UNION RD", 26 | "city": "WEST CHESTER", 27 | "cityAbbreviation": "", 28 | "state": "OH", 29 | "urbanization": "URB FAIR OAKS", 30 | "country": "United States", 31 | "countryISOCode": "840", 32 | "zipCode": "45011", 33 | "zipPlus4": "" 34 | } 35 | }, 36 | "manifestNumber": "XXXXXXXXXXXXXXXXXXXXXXXXXX", 37 | "trackingNumbers": [ 38 | "XXXXXXXXXXXXXXXXXXXXXX" 39 | ] 40 | } 41 | --9oxGwpVpWyl-C7mImcElxzrQ 42 | Content-Type: application/pdf 43 | Content-Disposition: form-data; filename="label.pdf"; name="label" 44 | 45 | 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YOngmODuEExIQEhTyOJmx82HNk+HGocWhI5tUd+SseXmVumt8VsvbiNvC992LgwVFhjWEvY53Cu8IXwxwjWiNmKBZc86zHrFtmGXs+c4lpwyzkykZWRZ5GyUZdTBqLlo6+iK6PkY+5jqmDexLrF1sUtxXnEn41biA+PbE7AJYQnnuRRuHLd/u/z2jO3DidqJBYn8JPOkQ0kLPHdeUzKUvCW5O4W2+pEeTNVI/S51Ms0qrSbtQ3pA+rkMsQxuxmCmVua+zJksp6wT2chsVnZfjmLO7pzJHbY76ndCOyN29uUq5+bnTu9y3nVqN3533O47efp5ZXnv9gTu6cmXy9+VP/Wd83etBSIFvILxvRZ7675Hfh/z/dC+9fuq9n0tZBfeKtIvqij6XMwqvvWDwQ+VP6zsj9w/VGJScrQUXcotHTtgfeBUmVhZVtnUQc+DneWM8sLyd4e2HbpZYVRRdxh/OPUwv9KjsrtKpaq06nN1dPVojV1Ne61s7b7apSPsIyNHbY621cnVFdV9OhZz7GG9c31ng1pDxXH08bTjLxoDGgdOME80N0k3FTV9Ock9yT/le6q/2bS5uUW2paQVbk1tnTsdevrejw4/drfptNW309uLzoAzqWde/hT209hZ97N955jn2n5W/bm2g9pR2Al1ZnYudEV38buDu4fPu53v67Ho6fhF95eTFxQv1FwUv1jSi+/N7125lHVp8XLi5fkrUVem+rb1TVwNuvqg36d/6Jr7tRvXna5fHbAduHTD8saFm+Y3z99i3uq6bXK7c9B4sOOO8Z2OIZOhzrumd7vvmd3rGd4w3DtiPXLlvsP96w9cH9we3Tg6POY/9nA8dJz/kP1w9lH8ozeP0x4vT+x6gnpS+FT0acUz2WcNv2r+2s434V+cdJgcfL7p+cQUa+rVb8m/fZ7Of0F6UTGjMNM8azh7Yc5p7t7LzS+nXyW+Wp4v+F3s99rXGq9 //sPmj8GFoIXpN7w3K38Wv5V6e/Kd0bu+Re/FZ+8T3i8vFX6Q+nDqI/PjwKfATzPL6Z8xnyu/aH7p+er+9clKwsqK0AWELiB0AaELCF1A6AJCFxC6gNAFhC4gdAGhCwhdQOgCQhf4P3aBtf84q4EQXI6PA+CXDYDHHQCqqgFQiwSAHJrCyUgRrHK3M1jbEzN5MVHRKesYqckcRiSPw4nPFKz9A9d7Ew4KZW5kc3RyZWFtCmVuZG9iagozIDAgb2JqCjI0NzIKZW5kb2JqCjQgMCBvYmoKWy9JQ0NCYXNlZCAyIDAgUl0KZW5kb2JqCjUgMCBvYmoKPDwKICAvTmFtZSAvSW0xCiAgL1R5cGUgL1hPYmplY3QKICAvTGVuZ3RoIDYgMCBSCiAgL0ZpbHRlciAvRmxhdGVEZWNvZGUKICAvU3VidHlwZSAvSW1hZ2UKICAvV2lkdGggNDM1CiAgL0hlaWdodCA3MAogIC9CaXRzUGVyQ29tcG9uZW50IDgKICAvQ29sb3JTcGFjZSBbL0luZGV4ZWQgL0RldmljZVJHQiAyNTUgPEZGRkZGRkY1RjVGNTk5OTc5NzZDNjk2QTRBNDc0ODQ4NDU0NkQ5RDlEOUU4RThFODlEOUI5Q0Y5RjlGOTRDNDk0OTg2ODQ4NDU5NTY1Nzg3ODQ4NUJFQkRCRDVCNTg1ODczNzA3MUFFQURBRERGREZERkY3RjdGNzQ5NDY0Nzk4OTY5NkM1QzRDNDUyNEY1MDc0NzE3MkRERENEQ0ZBRkFGQUQyRDFEMUEwOUY5RjZGNkQ2RDU1NTE1MjRFNEE0QjYxNUY1RkQ1RDRENUI3QjZCNkZFRkVGRTcyNkY3MEM2QzVDNjkxOEY4RkQ2RDVENUJBQjlCOUVDRUJFQkJCQkFCQThBODg4ODVFNUI1QzRCNDg0OUIzQjFCMkYyRjJGMkM3QzZDNzlBOTg5ODNGM0IzQzIzMUYyMDI3MjMyNEY4RjdGOEI5QjdCOEI0QjNCM0U3RTdFNzMxMkQyRTk3OTU5NkU5RTlFOTgwN0Q3RTcwNkU2RTJBMjYyN0ZCRkJGQkNDQ0NDQ0FEQUJBQjhFOEM4RDYyNjA2MERBREFEQUY4RjhGODk0OTI5MjJDMjgyOTZENkE2QkQzRDNEMzlDOUE5QjRGNEI0Q0EzQTFBMkQ3RDZENkQ5RDhEOENGQ0VDRUVFRUVFRUMxQzBDMDY3NjQ2NTM5MzUzNkU0RTNFM0EyQTFBMUM5QzhDODU4NTU1NkM2QzVDNTQwM0MzRDU2NTM1NERCREFEQjVGNUM1RDJFMkEyQkQxRDBEMDQzNDA0MTI5MjYyNjdBNzc3OEY2RjZGNjI2MjIyMzdCNzg3OTJCMjcyODhCODk4OTI5MjUyNjYxNUU1RTM0MzAzMTdFN0M3QzM3MzQzNDI1MjEyMjdGN0M3RDhDOEE4QURFRERERDg1ODM4MzZFNkI2Q0ZERkRGRDMwMkQyREYzRjNGMzNDMzkzQUNEQ0NDRDlFOUM5RDU3NTQ1NUNCQ0FDQUE5QThBODQ0NDE0MkUzRTJFM0I2QjVCNTg4ODY4NzJGMkIyQ0ZDRkNGQzRENEE0QTVCNTg1OTNBMzYzN0Q4RDdENzQ3NDM0NDVENUE1QkYyRjFGMUU1RTVFNURGREVERTdDN0E3QTI4MjQyNTQ1NDI0MjkzOTE5MUI4QjZCN0MwQkZDMEIwQUZBRkVERURFRDM1MzEzMkVGRUZFRkYxRjBGMTY1NjI2M0VBRTlFQTY4NjY2NkFDQUFBQkJDQkJCQkMzQzJDMjgyODA4MTU1NTI1M0RDREJEQzk2OTQ5NUYwRjBGMDdEN0I3QkQwQ0ZDRjc1NzM3MzJGMkMyRDhEOEI4QkVDRUNFQ0IxQUZCMDJEMjkyQTc4NzU3NkE3QTVBNUE2QTRBNEFBQThBOTUwNEQ0RUFCQTlBQUFEQUNBQzdCNzk3QUE0QTJBMzhEOEI4QzgxN0Y4MDQxM0QzRTI0MjAyMUQzRDJEMjVDNTk1QTkyOTA5MDMzMkYzMDUzNTA1MDMyMkUyRjlGOUQ5RDgzODE4MUY0RjRGNDQ2NDM0MzQ4NDQ0NTc5NzY3NzNCMzczOEVCRUFFQTYwNUQ1RTg3ODU4NjM1MzIzMzlCOTk5QTZFNkM2QzQyM0UzRjc3NzU3NUMyQzFDMTk1OTM5NDU0NTE1MUJEQkNCQzhGOEQ4RUUxRTFFMUM0QzNDMzY5Njc2N0UwRTBFMDkwOEU4RjRGNEM0REJGQkRCRTYzNjA2MTQyM0Y0MEIzQjJCMjM4MzQzNTNDMzgzOTVBNTc1NzlBOTk5OTNFM0IzQjc0NzI3M0E3QTZBNjZCNjg2OUExQTBBMEU2RTZFNkQ0RDNENEMwQkVCRkM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k3xIHF+X0w+K/m1LQTAplbmRzdHJlYW0KZW5kb2JqCjEzIDAgb2JqCjI2MzAKZW5kb2JqCjE0IDAgb2JqCjw8CiAgL1Jlc291cmNlcyAxNSAwIFIKICAvVHlwZSAvUGFnZQogIC9NZWRpYUJveCBbMCAwIDYxMiA3OTJdCiAgL0Nyb3BCb3ggWzAgMCA2MTIgNzkyXQogIC9CbGVlZEJveCBbMCAwIDYxMiA3OTJdCiAgL1RyaW1Cb3ggWzAgMCA2MTIgNzkyXQogIC9QYXJlbnQgMTYgMCBSCiAgL0NvbnRlbnRzIDEyIDAgUgo+PgplbmRvYmoKMTcgMCBvYmoKPDwKICAvVHlwZSAvRm9udAogIC9TdWJ0eXBlIC9UeXBlMQogIC9CYXNlRm9udCAvSGVsdmV0aWNhCiAgL0VuY29kaW5nIC9XaW5BbnNpRW5jb2RpbmcKPj4KZW5kb2JqCjE4IDAgb2JqCjw8CiAgL1R5cGUgL0ZvbnQKICAvU3VidHlwZSAvVHlwZTEKICAvQmFzZUZvbnQgL0hlbHZldGljYS1Cb2xkCiAgL0VuY29kaW5nIC9XaW5BbnNpRW5jb2RpbmcKPj4KZW5kb2JqCjE2IDAgb2JqCjw8IC9UeXBlIC9QYWdlcwovQ291bnQgMQovS2lkcyBbMTQgMCBSIF0gPj4KZW5kb2JqCjE5IDAgb2JqCjw8CiAgL1R5cGUgL0NhdGFsb2cKICAvUGFnZXMgMTYgMCBSCiAgL0xhbmcgKHgtdW5rbm93bikKPj4KZW5kb2JqCjE1IDAgb2JqCjw8CiAgL0ZvbnQgPDwgL0YxIDE3IDAgUiAvRjMgMTggMCBSID4+CiAgL1Byb2NTZXQgWy9QREYgL0ltYWdlQiAvSW1hZ2VDIC9UZXh0XQogIC9YT2JqZWN0IDw8IC9JbTEgNSAwIFIgL0ltMiAxMCAwIFIgPj4KICAvQ29sb3JTcGFjZSA8PCAvSUNDMiA0IDAgUiAvSUNDNyA5IDAgUiA+Pgo+PgplbmRvYmoKeHJlZgowIDIwCjAwMDAwMDAwMDAgNjU1MzUgZiAKMDAwMDAwMDAxNSAwMDAwMCBuIAowMDAwMDAwMTU3IDAwMDAwIG4gCjAwMDAwMDI3MTQgMDAwMDAgbiAKMDAwMDAwMjczNCAwMDAwMCBuIAowMDAwMDAyNzY3IDAwMDAwIG4gCjAwMDAwMTEzMzcgMDAwMDAgbiAKMDAwMDAxMTM1NyAwMDAwMCBuIAowMDAwMDEzOTE0IDAwMDAwIG4gCjAwMDAwMTM5MzQgMDAwMDAgbiAKMDAwMDAxMzk2NyAwMDAwMCBuIAowMDAwMDE0MjM1IDAwMDAwIG4gCjAwMDAwMTQyNTQgMDAwMDAgbiAKMDAwMDAxNjk2MCAwMDAwMCBuIAowMDAwMDE2OTgxIDAwMDAwIG4gCjAwMDAwMTc1MjcgMDAwMDAgbiAKMDAwMDAxNzM5MiAwMDAwMCBuIAowMDAwMDE3MTc1IDAwMDAwIG4gCjAwMDAwMTcyODEgMDAwMDAgbiAKMDAwMDAxNzQ1MiAwMDAwMCBuIAp0cmFpbGVyCjw8CiAgL1Jvb3QgMTkgMCBSCiAgL0luZm8gMSAwIFIKICAvSUQgWzxCRTJCMjkwRERDQjAzRUU3Q0NERUI3REYzOEVBNDRCRj4gPEJFMkIyOTBERENCMDNFRTdDQ0RFQjdERjM4RUE0NEJGPl0KICAvU2l6ZSAyMAo+PgpzdGFydHhyZWYKMTc3MDkKJSVFT0YK 46 | --9oxGwpVpWyl-C7mImcElxzrQ-- -------------------------------------------------------------------------------- /SCANForm-MIDShipment-request.json: -------------------------------------------------------------------------------- 1 | { 2 | "form": "5630", 3 | "imageType": "PDF", 4 | "labelType": "8.5x11LABEL", 5 | "mailingDate": "2023-04-19", 6 | "entryFacilityZIPCode": "45011", 7 | "entryFacilityZIPPlus4": "", 8 | "destinationEntryFacilityType": "NONE", 9 | "overwriteMailingDate": false, 10 | "shipment": { 11 | "MID": "XXXXXXXXX" 12 | }, 13 | "fromAddress": { 14 | "firstName": "Leroy", 15 | "lastName": "Brown", 16 | "firm": "USPS", 17 | "address": { 18 | "streetAddress": "1100 Wyoming", 19 | "streetAddressAbbreviation": "", 20 | "secondaryAddress": "APT N", 21 | "city": "St. Louis", 22 | "cityAbbreviation": "STL", 23 | "state": "MO", 24 | "ZIPCode": "63118", 25 | "ZIPPlus4": "8312", 26 | "urbanization": "URB Fair Oaks", 27 | "country": "United States", 28 | "countryISOCode": 840 29 | } 30 | } 31 | } -------------------------------------------------------------------------------- /SCANForm-MIDShipment-response.json: -------------------------------------------------------------------------------- 1 | --ki7xVSNgIImdXRIXQJNyPcG3 2 | Content-Type: application/json 3 | Content-Disposition: form-data; name="Scan Form Response" 4 | 5 | { 6 | "form": "5630", 7 | "imageType": "PDF", 8 | "labelType": "8.5x11LABEL", 9 | "mailingDate": "2023-04-19", 10 | "overwriteMailingDate": false, 11 | "entryFacilityZIPCode": "45011", 12 | "destinationEntryFacilityType": "NONE", 13 | "shipment": { 14 | "MID": "XXXXXXXXX" 15 | }, 16 | "fromAddress": { 17 | "firstName": "Leroy", 18 | "lastName": "Brown", 19 | "firm": "USPS", 20 | "address": { 21 | "streetAddress": "APT N", 22 | "streetAddressAbbreviation": "", 23 | "secondaryAddress": "1100 WYOMING ST", 24 | "city": "SAINT LOUIS", 25 | "cityAbbreviation": "STL", 26 | "state": "MO", 27 | "urbanization": "URB FAIR OAKS", 28 | "country": "United States", 29 | "countryISOCode": "840", 30 | "zipCode": "63118", 31 | "zipPlus4": "2628" 32 | } 33 | }, 34 | "manifestNumber": "XXXXXXXXXXXXXXXXXXXXXXXXXX", 35 | "trackingNumbers": [ 36 | "XXXXXXXXXXXXXXXXXXXXXX" 37 | "XXXXXXXXXXXXXXXXXXXXXX" 38 | "XXXXXXXXXXXXXXXXXXXXXX" 39 | "XXXXXXXXXXXXXXXXXXXXXX" 40 | ] 41 | } 42 | --ki7xVSNgIImdXRIXQJNyPcG3 43 | Content-Type: application/pdf 44 | Content-Disposition: form-data; filename="label.pdf"; name="label" 45 | 46 | JVBERi0xLjQKJaqrrK0KMSAwIG9iago8PAovUHJvZHVjZXIgKEFwYWNoZSBGT1AgVmVyc2lvbiBTVk4gYnJhbmNoZXMvZm9wLTJfOC9mb3AtY29yZTogUERGIFRyYW5zY29kZXIgZm9yIEJhdGlrKQovQ3JlYXRpb25EYXRlIChEOjIwMjMwNDE5MjAyNTAyWikKPj4KZW5kb2JqCjIgMCBvYmoKPDwKICAvTiAzCiAgL0xlbmd0aCAzIDAgUgogIC9GaWx0ZXIgL0ZsYXRlRGVjb2RlCj4+CnN0cmVhbQp4nO2ZZ1BUWRaA73udEw3dTZOhyUmihAYk5yRBsqhAd5NpoclBUWRwBEYQEUmKIKKAA44OQUZREcWAKCigok4jg4AyDo4iKipL44/ZrfmxtVVb+2f7/Hjvq3NPvXPuq1v1vqoHgAwxnpWQDOsDkMBN4fk62zGCgkMYmAcAC0iACCgAHc5KTrT19vYAqyGoBX+L92MAEtzv6wjWc8+Roos+6Bgem3F5/Haiecvf6/8liOwELhsAiLbKsWxOMmuVd61yNDuBLcjPCjg9JTEFANh7lWm81QFXmS3giG+cIeCob1y8VuPna7/KxwDAEqPWGH9awBFrTOkWMCualwCAdP9qvQorkbf6fGlBL8VvM6yFqGA/jCgOl8MLT+GwGf9mK/95/FMvVPLqy/+vN/gf9xGcnW/01nLtTED0yr9y28sBYL4GAFH6V07lCADkPQB09v6VizgBQFcpAJLPWKm8tG855NrsAA/IgAakgDxQBhpABxgCU2ABbIAjcANewA8Eg62ABaJBAuCBdJADdoMCUARKwSFQDepAI2gGbeAs6AIXwBVwHdwG98AomAB8MA1egQXwHixDEISBSBAVkoIUIFVIGzKEmJAV5Ah5QL5QMBQGRUFcKBXKgfZARVAZVA3VQ83QT9B56Ap0ExqGHkGT0Bz0J/QJRsBEmAbLwWqwHsyEbWF32A/eAkfBSXAWnA/vhyvhBvg03AlfgW/DozAffgUvIgCCgKAjFBE6CCbCHuGFCEFEIniInYhCRAWiAdGG6EEMIO4j+Ih5xEckGklFMpA6SAukC9IfyUImIXcii5HVyFPITmQ/8j5yErmA/IoioWRR2ihzlCsqCBWFSkcVoCpQTagO1DXUKGoa9R6NRtPR6mhTtAs6GB2LzkYXo4+g29GX0cPoKfQiBoORwmhjLDFemHBMCqYAU4U5jbmEGcFMYz5gCVgFrCHWCRuC5WLzsBXYFmwvdgQ7g13GieJUceY4Lxwbl4krwTXienB3cdO4ZbwYXh1viffDx+J34yvxbfhr+Cf4twQCQYlgRvAhxBB2ESoJZwg3CJOEj0QKUYtoTwwlphL3E08SLxMfEd+SSCQ1kg0phJRC2k9qJl0lPSN9EKGK6Iq4irBFckVqRDpFRkRek3FkVbIteSs5i1xBPke+S54XxYmqidqLhovuFK0RPS86LrooRhUzEPMSSxArFmsRuyk2S8FQ1CiOFDYln3KccpUyRUVQlan2VBZ1D7WReo06TUPT1GmutFhaEe1H2hBtQZwibiQeIJ4hXiN+UZxPR9DV6K70eHoJ/Sx9jP5JQk7CVoIjsU+iTWJEYklSRtJGkiNZKNkuOSr5SYoh5SgVJ3VAqkvqqTRSWkvaRzpd+qj0Nel5GZqMhQxLplDmrMxjWVhWS9ZXNlv2uOyg7KKcvJyzXKJcldxVuXl5uryNfKx8uXyv/JwCVcFKIUahXOGSwkuGOMOWEc+oZPQzFhRlFV0UUxXrFYcUl5XUlfyV8pTalZ4q45WZypHK5cp9ygsqCiqeKjkqrSqPVXGqTNVo1cOqA6pLaupqgWp71brUZtUl1V3Vs9Rb1Z9okDSsNZI0GjQeaKI1mZpxmkc072nBWsZa0Vo1Wne1YW0T7RjtI9rD61DrzNZx1zWsG9ch6tjqpOm06kzq0nU9dPN0u3Rf66nohegd0BvQ+6pvrB+v36g/YUAxcDPIM+gx+NNQy5BlWGP4YD1pvdP63PXd698YaRtxjI4aPTSmGnsa7zXuM/5iYmrCM2kzmTNVMQ0zrTUdZ9KY3sxi5g0zlJmdWa7ZBbOP5ibmKeZnzf+w0LGIs2ixmN2gvoGzoXHDlKWSZbhlvSXfimEVZnXMim+taB1u3WD93EbZhm3TZDNjq2kba3va9rWdvh3PrsNuyd7cfof9ZQeEg7NDocOQI8XR37Ha8ZmTklOUU6vTgrOxc7bzZReUi7vLAZdxVzlXlmuz64KbqdsOt353ovsm92r35x5aHjyPHk/Y083zoOeTjaobuRu7vICXq9dBr6fe6t5J3r/4oH28fWp8Xvga+Ob4Dmyibtq2qWXTez87vxK/CX8N/1T/vgByQGhAc8BSoENgWSA/SC9oR9DtYOngmODuEExIQEhTyOJmx82HNk+HGocWhI5tUd+SseXmVumt8VsvbiNvC992LgwVFhjWEvY53Cu8IXwxwjWiNmKBZc86zHrFtmGXs+c4lpwyzkykZWRZ5GyUZdTBqLlo6+iK6PkY+5jqmDexLrF1sUtxXnEn41biA+PbE7AJYQnnuRRuHLd/u/z2jO3DidqJBYn8JPOkQ0kLPHdeUzKUvCW5O4W2+pEeTNVI/S51Ms0qrSbtQ3pA+rkMsQxuxmCmVua+zJksp6wT2chsVnZfjmLO7pzJHbY76ndCOyN29uUq5+bnTu9y3nVqN3533O47efp5ZXnv9gTu6cmXy9+VP/Wd83etBSIFvILxvRZ7675Hfh/z/dC+9fuq9n0tZBfeKtIvqij6XMwqvvWDwQ+VP6zsj9w/VGJScrQUXcotHTtgfeBUmVhZVtnUQc+DneWM8sLyd4e2HbpZYVRRdxh/OPUwv9KjsrtKpaq06nN1dPVojV1Ne61s7b7apSPsIyNHbY621cnVFdV9OhZz7GG9c31ng1pDxXH08bTjLxoDGgdOME80N0k3FTV9Ock9yT/le6q/2bS5uUW2paQVbk1tnTsdevrejw4/drfptNW309uLzoAzqWde/hT209hZ97N955jn2n5W/bm2g9pR2Al1ZnYudEV38buDu4fPu53v67Ho6fhF95eTFxQv1FwUv1jSi+/N7125lHVp8XLi5fkrUVem+rb1TVwNuvqg36d/6Jr7tRvXna5fHbAduHTD8saFm+Y3z99i3uq6bXK7c9B4sOOO8Z2OIZOhzrumd7vvmd3rGd4w3DtiPXLlvsP96w9cH9we3Tg6POY/9nA8dJz/kP1w9lH8ozeP0x4vT+x6gnpS+FT0acUz2WcNv2r+2s434V+cdJgcfL7p+cQUa+rVb8m/fZ7Of0F6UTGjMNM8azh7Yc5p7t7LzS+nXyW+Wp4v+F3s99rXGq9 //sPmj8GFoIXpN7w3K38Wv5V6e/Kd0bu+Re/FZ+8T3i8vFX6Q+nDqI/PjwKfATzPL6Z8xnyu/aH7p+er+9clKwsqK0AWELiB0AaELCF1A6AJCFxC6gNAFhC4gdAGhCwhdQOgCQhf4P3aBtf84q4EQXI6PA+CXDYDHHQCqqgFQiwSAHJrCyUgRrHK3M1jbEzN5MVHRKesYqckcRiSPw4nPFKz9A9d7Ew4KZW5kc3RyZWFtCmVuZG9iagozIDAgb2JqCjI0NzIKZW5kb2JqCjQgMCBvYmoKWy9JQ0NCYXNlZCAyIDAgUl0KZW5kb2JqCjUgMCBvYmoKPDwKICAvTmFtZSAvSW0xCiAgL1R5cGUgL1hPYmplY3QKICAvTGVuZ3RoIDYgMCBSCiAgL0ZpbHRlciAvRmxhdGVEZWNvZGUKICAvU3VidHlwZSAvSW1hZ2UKICAvV2lkdGggNDM1CiAgL0hlaWdodCA3MAogIC9CaXRzUGVyQ29tcG9uZW50IDgKICAvQ29sb3JTcGFjZSBbL0luZGV4ZWQgL0RldmljZVJHQiAyNTUgPEZGRkZGRkY1RjVGNTk5OTc5NzZDNjk2QTRBNDc0ODQ4NDU0NkQ5RDlEOUU4RThFODlEOUI5Q0Y5RjlGOTRDNDk0OTg2ODQ4NDU5NTY1Nzg3ODQ4NUJFQkRCRDVCNTg1ODczNzA3MUFFQURBRERGREZERkY3RjdGNzQ5NDY0Nzk4OTY5NkM1QzRDNDUyNEY1MDc0NzE3MkRERENEQ0ZBRkFGQUQyRDFEMUEwOUY5RjZGNkQ2RDU1NTE1MjRFNEE0QjYxNUY1RkQ1RDRENUI3QjZCNkZFRkVGRTcyNkY3MEM2QzVDNjkxOEY4RkQ2RDVENUJBQjlCOUVDRUJFQkJCQkFCQThBODg4ODVFNUI1QzRCNDg0OUIzQjFCMkYyRjJGMkM3QzZDNzlBOTg5ODNGM0IzQzIzMUYyMDI3MjMyNEY4RjdGOEI5QjdCOEI0QjNCM0U3RTdFNzMxMkQyRTk3OTU5NkU5RTlFOTgwN0Q3RTcwNkU2RTJBMjYyN0ZCRkJGQkNDQ0NDQ0FEQUJBQjhFOEM4RDYyNjA2MERBREFEQUY4RjhGODk0OTI5MjJDMjgyOTZENkE2QkQzRDNEMzlDOUE5QjRGNEI0Q0EzQTFBMkQ3RDZENkQ5RDhEOENGQ0VDRUVFRUVFRUMxQzBDMDY3NjQ2NTM5MzUzNkU0RTNFM0EyQTFBMUM5QzhDODU4NTU1NkM2QzVDNTQwM0MzRDU2NTM1NERCREFEQjVGNUM1RDJFMkEyQkQxRDBEMDQzNDA0MTI5MjYyNjdBNzc3OEY2RjZGNjI2MjIyMzdCNzg3OTJCMjcyODhCODk4OTI5MjUyNjYxNUU1RTM0MzAzMTdFN0M3QzM3MzQzNDI1MjEyMjdGN0M3RDhDOEE4QURFRERERDg1ODM4MzZFNkI2Q0ZERkRGRDMwMkQyREYzRjNGMzNDMzkzQUNEQ0NDRDlFOUM5RDU3NTQ1NUNCQ0FDQUE5QThBODQ0NDE0MkUzRTJFM0I2QjVCNTg4ODY4NzJGMkIyQ0ZDRkNGQzRENEE0QTVCNTg1OTNBMzYzN0Q4RDdENzQ3NDM0NDVENUE1QkYyRjFGMUU1RTVFNURGREVERTdDN0E3QTI4MjQyNTQ1NDI0MjkzOTE5MUI4QjZCN0MwQkZDMEIwQUZBRkVERURFRDM1MzEzMkVGRUZFRkYxRjBGMTY1NjI2M0VBRTlFQTY4NjY2NkFDQUFBQkJDQkJCQkMzQzJDMjgyODA4MTU1NTI1M0RDREJEQzk2OTQ5NUYwRjBGMDdEN0I3QkQwQ0ZDRjc1NzM3MzJGMkMyRDhEOEI4QkVDRUNFQ0IxQUZCMDJEMjkyQTc4NzU3NkE3QTVBNUE2QTRBNEFBQThBOTUwNEQ0RUFCQTlBQUFEQUNBQzdCNzk3QUE0QTJBMzhEOEI4QzgxN0Y4MDQxM0QzRTI0MjAyMUQzRDJEMjVDNTk1QTkyOTA5MDMzMkYzMDUzNTA1MDMyMkUyRjlGOUQ5RDgzODE4MUY0RjRGNDQ2NDM0MzQ4NDQ0NTc5NzY3NzNCMzczOEVCRUFFQTYwNUQ1RTg3ODU4NjM1MzIzMzlCOTk5QTZFNkM2QzQyM0UzRjc3NzU3NUMyQzFDMTk1OTM5NDU0NTE1MUJEQkNCQzhGOEQ4RUUxRTFFMUM0QzNDMzY5Njc2N0UwRTBFMDkwOEU4RjRGNEM0REJGQkRCRTYzNjA2MTQyM0Y0MEIzQjJCMjM4MzQzNTNDMzgzOTVBNTc1NzlBOTk5OTNFM0IzQjc0NzI3M0E3QTZBNjZCNjg2OUExQTBBMEU2RTZFNkQ0RDNENEMwQkVCRkM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inH5Y/BcfSM/ICmVuZHN0cmVhbQplbmRvYmoKMTMgMCBvYmoKMjYyNgplbmRvYmoKMTQgMCBvYmoKPDwKICAvUmVzb3VyY2VzIDE1IDAgUgogIC9UeXBlIC9QYWdlCiAgL01lZGlhQm94IFswIDAgNjEyIDc5Ml0KICAvQ3JvcEJveCBbMCAwIDYxMiA3OTJdCiAgL0JsZWVkQm94IFswIDAgNjEyIDc5Ml0KICAvVHJpbUJveCBbMCAwIDYxMiA3OTJdCiAgL1BhcmVudCAxNiAwIFIKICAvQ29udGVudHMgMTIgMCBSCj4+CmVuZG9iagoxNyAwIG9iago8PAogIC9UeXBlIC9Gb250CiAgL1N1YnR5cGUgL1R5cGUxCiAgL0Jhc2VGb250IC9IZWx2ZXRpY2EKICAvRW5jb2RpbmcgL1dpbkFuc2lFbmNvZGluZwo+PgplbmRvYmoKMTggMCBvYmoKPDwKICAvVHlwZSAvRm9udAogIC9TdWJ0eXBlIC9UeXBlMQogIC9CYXNlRm9udCAvSGVsdmV0aWNhLUJvbGQKICAvRW5jb2RpbmcgL1dpbkFuc2lFbmNvZGluZwo+PgplbmRvYmoKMTYgMCBvYmoKPDwgL1R5cGUgL1BhZ2VzCi9Db3VudCAxCi9LaWRzIFsxNCAwIFIgXSA+PgplbmRvYmoKMTkgMCBvYmoKPDwKICAvVHlwZSAvQ2F0YWxvZwogIC9QYWdlcyAxNiAwIFIKICAvTGFuZyAoeC11bmtub3duKQo+PgplbmRvYmoKMTUgMCBvYmoKPDwKICAvRm9udCA8PCAvRjEgMTcgMCBSIC9GMyAxOCAwIFIgPj4KICAvUHJvY1NldCBbL1BERiAvSW1hZ2VCIC9JbWFnZUMgL1RleHRdCiAgL1hPYmplY3QgPDwgL0ltMSA1IDAgUiAvSW0yIDEwIDAgUiA+PgogIC9Db2xvclNwYWNlIDw8IC9JQ0MyIDQgMCBSIC9JQ0M3IDkgMCBSID4+Cj4+CmVuZG9iagp4cmVmCjAgMjAKMDAwMDAwMDAwMCA2NTUzNSBmIAowMDAwMDAwMDE1IDAwMDAwIG4gCjAwMDAwMDAxNTcgMDAwMDAgbiAKMDAwMDAwMjcxNCAwMDAwMCBuIAowMDAwMDAyNzM0IDAwMDAwIG4gCjAwMDAwMDI3NjcgMDAwMDAgbiAKMDAwMDAxMTMzNyAwMDAwMCBuIAowMDAwMDExMzU3IDAwMDAwIG4gCjAwMDAwMTM5MTQgMDAwMDAgbiAKMDAwMDAxMzkzNCAwMDAwMCBuIAowMDAwMDEzOTY3IDAwMDAwIG4gCjAwMDAwMTQyMzUgMDAwMDAgbiAKMDAwMDAxNDI1NCAwMDAwMCBuIAowMDAwMDE2OTU2IDAwMDAwIG4gCjAwMDAwMTY5NzcgMDAwMDAgbiAKMDAwMDAxNzUyMyAwMDAwMCBuIAowMDAwMDE3Mzg4IDAwMDAwIG4gCjAwMDAwMTcxNzEgMDAwMDAgbiAKMDAwMDAxNzI3NyAwMDAwMCBuIAowMDAwMDE3NDQ4IDAwMDAwIG4gCnRyYWlsZXIKPDwKICAvUm9vdCAxOSAwIFIKICAvSW5mbyAxIDAgUgogIC9JRCBbPDc4RTdEQ0JDNDdEMzBFNDUwNEVCN0NENkYyODdFMDY5PiA8NzhFN0RDQkM0N0QzMEU0NTA0RUI3Q0Q2RjI4N0UwNjk+XQogIC9TaXplIDIwCj4+CnN0YXJ0eHJlZgoxNzcwNQolJUVPRgo= 47 | --ki7xVSNgIImdXRIXQJNyPcG3-- -------------------------------------------------------------------------------- /SCANForm-ManifestMIDShipment-request.json: -------------------------------------------------------------------------------- 1 | { 2 | "form": "5630", 3 | "imageType": "PDF", 4 | "labelType": "8.5x11LABEL", 5 | "mailingDate": "2023-04-19", 6 | "entryFacilityZIPCode": "45011", 7 | "entryFacilityZIPPlus4": "", 8 | "destinationEntryFacilityType": "NONE", 9 | "overwriteMailingDate": false, 10 | "shipment": { 11 | "manifestMID": "XXXXXXXXX" 12 | }, 13 | "fromAddress": { 14 | "firstName": "Leroy", 15 | "lastName": "Brown", 16 | "firm": "USPS", 17 | "address": { 18 | "streetAddress": "1100 Wyoming", 19 | "streetAddressAbbreviation": "", 20 | "secondaryAddress": "APT N", 21 | "city": "St. Louis", 22 | "cityAbbreviation": "STL", 23 | "state": "MO", 24 | "ZIPCode": "63118", 25 | "ZIPPlus4": "8312", 26 | "urbanization": "URB Fair Oaks", 27 | "country": "United States", 28 | "countryISOCode": 840 29 | } 30 | } 31 | } -------------------------------------------------------------------------------- /SCANForm-ManifestMIDShipment-response.json: -------------------------------------------------------------------------------- 1 | --ENBLgudt45Tp+D7b8eMPXPgf 2 | Content-Type: application/json 3 | Content-Disposition: form-data; name="Scan Form Response" 4 | 5 | { 6 | "form": "5630", 7 | "imageType": "PDF", 8 | "labelType": "8.5x11LABEL", 9 | "mailingDate": "2023-04-19", 10 | "overwriteMailingDate": false, 11 | "entryFacilityZIPCode": "45011", 12 | "destinationEntryFacilityType": "NONE", 13 | "shipment": { 14 | "manifestMID": "XXXXXXXXX" 15 | }, 16 | "fromAddress": { 17 | "firstName": "Leroy", 18 | "lastName": "Brown", 19 | "firm": "USPS", 20 | "address": { 21 | "streetAddress": "APT N", 22 | "streetAddressAbbreviation": "", 23 | "secondaryAddress": "1100 WYOMING ST", 24 | "city": "SAINT LOUIS", 25 | "cityAbbreviation": "STL", 26 | "state": "MO", 27 | "urbanization": "URB FAIR OAKS", 28 | "country": "United States", 29 | "countryISOCode": "840", 30 | "zipCode": "63118", 31 | "zipPlus4": "2628" 32 | } 33 | }, 34 | "manifestNumber": "XXXXXXXXXXXXXXXXXXXXXXXXXX", 35 | "trackingNumbers": [ 36 | "XXXXXXXXXXXXXXXXXXXXXX" 37 | ] 38 | } 39 | --ENBLgudt45Tp+D7b8eMPXPgf 40 | Content-Type: application/pdf 41 | Content-Disposition: form-data; filename="label.pdf"; name="label" 42 | 43 | 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YOngmODuEExIQEhTyOJmx82HNk+HGocWhI5tUd+SseXmVumt8VsvbiNvC992LgwVFhjWEvY53Cu8IXwxwjWiNmKBZc86zHrFtmGXs+c4lpwyzkykZWRZ5GyUZdTBqLlo6+iK6PkY+5jqmDexLrF1sUtxXnEn41biA+PbE7AJYQnnuRRuHLd/u/z2jO3DidqJBYn8JPOkQ0kLPHdeUzKUvCW5O4W2+pEeTNVI/S51Ms0qrSbtQ3pA+rkMsQxuxmCmVua+zJksp6wT2chsVnZfjmLO7pzJHbY76ndCOyN29uUq5+bnTu9y3nVqN3533O47efp5ZXnv9gTu6cmXy9+VP/Wd83etBSIFvILxvRZ7675Hfh/z/dC+9fuq9n0tZBfeKtIvqij6XMwqvvWDwQ+VP6zsj9w/VGJScrQUXcotHTtgfeBUmVhZVtnUQc+DneWM8sLyd4e2HbpZYVRRdxh/OPUwv9KjsrtKpaq06nN1dPVojV1Ne61s7b7apSPsIyNHbY621cnVFdV9OhZz7GG9c31ng1pDxXH08bTjLxoDGgdOME80N0k3FTV9Ock9yT/le6q/2bS5uUW2paQVbk1tnTsdevrejw4/drfptNW309uLzoAzqWde/hT209hZ97N955jn2n5W/bm2g9pR2Al1ZnYudEV38buDu4fPu53v67Ho6fhF95eTFxQv1FwUv1jSi+/N7125lHVp8XLi5fkrUVem+rb1TVwNuvqg36d/6Jr7tRvXna5fHbAduHTD8saFm+Y3z99i3uq6bXK7c9B4sOOO8Z2OIZOhzrumd7vvmd3rGd4w3DtiPXLlvsP96w9cH9we3Tg6POY/9nA8dJz/kP1w9lH8ozeP0x4vT+x6gnpS+FT0acUz2WcNv2r+2s434V+cdJgcfL7p+cQUa+rVb8m/fZ7Of0F6UTGjMNM8azh7Yc5p7t7LzS+nXyW+Wp4v+F3s99rXGq9 //sPmj8GFoIXpN7w3K38Wv5V6e/Kd0bu+Re/FZ+8T3i8vFX6Q+nDqI/PjwKfATzPL6Z8xnyu/aH7p+er+9clKwsqK0AWELiB0AaELCF1A6AJCFxC6gNAFhC4gdAGhCwhdQOgCQhf4P3aBtf84q4EQXI6PA+CXDYDHHQCqqgFQiwSAHJrCyUgRrHK3M1jbEzN5MVHRKesYqckcRiSPw4nPFKz9A9d7Ew4KZW5kc3RyZWFtCmVuZG9iagozIDAgb2JqCjI0NzIKZW5kb2JqCjQgMCBvYmoKWy9JQ0NCYXNlZCAyIDAgUl0KZW5kb2JqCjUgMCBvYmoKPDwKICAvTmFtZSAvSW0xCiAgL1R5cGUgL1hPYmplY3QKICAvTGVuZ3RoIDYgMCBSCiAgL0ZpbHRlciAvRmxhdGVEZWNvZGUKICAvU3VidHlwZSAvSW1hZ2UKICAvV2lkdGggNDM1CiAgL0hlaWdodCA3MAogIC9CaXRzUGVyQ29tcG9uZW50IDgKICAvQ29sb3JTcGFjZSBbL0luZGV4ZWQgL0RldmljZVJHQiAyNTUgPEZGRkZGRkY1RjVGNTk5OTc5NzZDNjk2QTRBNDc0ODQ4NDU0NkQ5RDlEOUU4RThFODlEOUI5Q0Y5RjlGOTRDNDk0OTg2ODQ4NDU5NTY1Nzg3ODQ4NUJFQkRCRDVCNTg1ODczNzA3MUFFQURBRERGREZERkY3RjdGNzQ5NDY0Nzk4OTY5NkM1QzRDNDUyNEY1MDc0NzE3MkRERENEQ0ZBRkFGQUQyRDFEMUEwOUY5RjZGNkQ2RDU1NTE1MjRFNEE0QjYxNUY1RkQ1RDRENUI3QjZCNkZFRkVGRTcyNkY3MEM2QzVDNjkxOEY4RkQ2RDVENUJBQjlCOUVDRUJFQkJCQkFCQThBODg4ODVFNUI1QzRCNDg0OUIzQjFCMkYyRjJGMkM3QzZDNzlBOTg5ODNGM0IzQzIzMUYyMDI3MjMyNEY4RjdGOEI5QjdCOEI0QjNCM0U3RTdFNzMxMkQyRTk3OTU5NkU5RTlFOTgwN0Q3RTcwNkU2RTJBMjYyN0ZCRkJGQkNDQ0NDQ0FEQUJBQjhFOEM4RDYyNjA2MERBREFEQUY4RjhGODk0OTI5MjJDMjgyOTZENkE2QkQzRDNEMzlDOUE5QjRGNEI0Q0EzQTFBMkQ3RDZENkQ5RDhEOENGQ0VDRUVFRUVFRUMxQzBDMDY3NjQ2NTM5MzUzNkU0RTNFM0EyQTFBMUM5QzhDODU4NTU1NkM2QzVDNTQwM0MzRDU2NTM1NERCREFEQjVGNUM1RDJFMkEyQkQxRDBEMDQzNDA0MTI5MjYyNjdBNzc3OEY2RjZGNjI2MjIyMzdCNzg3OTJCMjcyODhCODk4OTI5MjUyNjYxNUU1RTM0MzAzMTdFN0M3QzM3MzQzNDI1MjEyMjdGN0M3RDhDOEE4QURFRERERDg1ODM4MzZFNkI2Q0ZERkRGRDMwMkQyREYzRjNGMzNDMzkzQUNEQ0NDRDlFOUM5RDU3NTQ1NUNCQ0FDQUE5QThBODQ0NDE0MkUzRTJFM0I2QjVCNTg4ODY4NzJGMkIyQ0ZDRkNGQzRENEE0QTVCNTg1OTNBMzYzN0Q4RDdENzQ3NDM0NDVENUE1QkYyRjFGMUU1RTVFNURGREVERTdDN0E3QTI4MjQyNTQ1NDI0MjkzOTE5MUI4QjZCN0MwQkZDMEIwQUZBRkVERURFRDM1MzEzMkVGRUZFRkYxRjBGMTY1NjI2M0VBRTlFQTY4NjY2NkFDQUFBQkJDQkJCQkMzQzJDMjgyODA4MTU1NTI1M0RDREJEQzk2OTQ5NUYwRjBGMDdEN0I3QkQwQ0ZDRjc1NzM3MzJGMkMyRDhEOEI4QkVDRUNFQ0IxQUZCMDJEMjkyQTc4NzU3NkE3QTVBNUE2QTRBNEFBQThBOTUwNEQ0RUFCQTlBQUFEQUNBQzdCNzk3QUE0QTJBMzhEOEI4QzgxN0Y4MDQxM0QzRTI0MjAyMUQzRDJEMjVDNTk1QTkyOTA5MDMzMkYzMDUzNTA1MDMyMkUyRjlGOUQ5RDgzODE4MUY0RjRGNDQ2NDM0MzQ4NDQ0NTc5NzY3NzNCMzczOEVCRUFFQTYwNUQ1RTg3ODU4NjM1MzIzMzlCOTk5QTZFNkM2QzQyM0UzRjc3NzU3NUMyQzFDMTk1OTM5NDU0NTE1MUJEQkNCQzhGOEQ4RUUxRTFFMUM0QzNDMzY5Njc2N0UwRTBFMDkwOEU4RjRGNEM0REJGQkRCRTYzNjA2MTQyM0Y0MEIzQjJCMjM4MzQzNTNDMzgzOTVBNTc1NzlBOTk5OTNFM0IzQjc0NzI3M0E3QTZBNjZCNjg2OUExQTBBMEU2RTZFNkQ0RDNENEMwQkVCRkM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U0w+L/wLh7c+2CmVuZHN0cmVhbQplbmRvYmoKMTMgMCBvYmoKMjYyNgplbmRvYmoKMTQgMCBvYmoKPDwKICAvUmVzb3VyY2VzIDE1IDAgUgogIC9UeXBlIC9QYWdlCiAgL01lZGlhQm94IFswIDAgNjEyIDc5Ml0KICAvQ3JvcEJveCBbMCAwIDYxMiA3OTJdCiAgL0JsZWVkQm94IFswIDAgNjEyIDc5Ml0KICAvVHJpbUJveCBbMCAwIDYxMiA3OTJdCiAgL1BhcmVudCAxNiAwIFIKICAvQ29udGVudHMgMTIgMCBSCj4+CmVuZG9iagoxNyAwIG9iago8PAogIC9UeXBlIC9Gb250CiAgL1N1YnR5cGUgL1R5cGUxCiAgL0Jhc2VGb250IC9IZWx2ZXRpY2EKICAvRW5jb2RpbmcgL1dpbkFuc2lFbmNvZGluZwo+PgplbmRvYmoKMTggMCBvYmoKPDwKICAvVHlwZSAvRm9udAogIC9TdWJ0eXBlIC9UeXBlMQogIC9CYXNlRm9udCAvSGVsdmV0aWNhLUJvbGQKICAvRW5jb2RpbmcgL1dpbkFuc2lFbmNvZGluZwo+PgplbmRvYmoKMTYgMCBvYmoKPDwgL1R5cGUgL1BhZ2VzCi9Db3VudCAxCi9LaWRzIFsxNCAwIFIgXSA+PgplbmRvYmoKMTkgMCBvYmoKPDwKICAvVHlwZSAvQ2F0YWxvZwogIC9QYWdlcyAxNiAwIFIKICAvTGFuZyAoeC11bmtub3duKQo+PgplbmRvYmoKMTUgMCBvYmoKPDwKICAvRm9udCA8PCAvRjEgMTcgMCBSIC9GMyAxOCAwIFIgPj4KICAvUHJvY1NldCBbL1BERiAvSW1hZ2VCIC9JbWFnZUMgL1RleHRdCiAgL1hPYmplY3QgPDwgL0ltMSA1IDAgUiAvSW0yIDEwIDAgUiA+PgogIC9Db2xvclNwYWNlIDw8IC9JQ0MyIDQgMCBSIC9JQ0M3IDkgMCBSID4+Cj4+CmVuZG9iagp4cmVmCjAgMjAKMDAwMDAwMDAwMCA2NTUzNSBmIAowMDAwMDAwMDE1IDAwMDAwIG4gCjAwMDAwMDAxNTcgMDAwMDAgbiAKMDAwMDAwMjcxNCAwMDAwMCBuIAowMDAwMDAyNzM0IDAwMDAwIG4gCjAwMDAwMDI3NjcgMDAwMDAgbiAKMDAwMDAxMTMzNyAwMDAwMCBuIAowMDAwMDExMzU3IDAwMDAwIG4gCjAwMDAwMTM5MTQgMDAwMDAgbiAKMDAwMDAxMzkzNCAwMDAwMCBuIAowMDAwMDEzOTY3IDAwMDAwIG4gCjAwMDAwMTQyMzUgMDAwMDAgbiAKMDAwMDAxNDI1NCAwMDAwMCBuIAowMDAwMDE2OTU2IDAwMDAwIG4gCjAwMDAwMTY5NzcgMDAwMDAgbiAKMDAwMDAxNzUyMyAwMDAwMCBuIAowMDAwMDE3Mzg4IDAwMDAwIG4gCjAwMDAwMTcxNzEgMDAwMDAgbiAKMDAwMDAxNzI3NyAwMDAwMCBuIAowMDAwMDE3NDQ4IDAwMDAwIG4gCnRyYWlsZXIKPDwKICAvUm9vdCAxOSAwIFIKICAvSW5mbyAxIDAgUgogIC9JRCBbPDQyNUNGMjQ1QjM3NzBGNTQ0MDc3NDU0N0U3RTZCNUFEPiA8NDI1Q0YyNDVCMzc3MEY1NDQwNzc0NTQ3RTdFNkI1QUQ+XQogIC9TaXplIDIwCj4+CnN0YXJ0eHJlZgoxNzcwNQolJUVPRgo= 44 | --ENBLgudt45Tp+D7b8eMPXPgf-- -------------------------------------------------------------------------------- /USPS APIs Domestic Labels API Documentation_2023_0901 Published.pdf: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/USPS/api-examples/c980c5264781bd4a4e82a878272c9a3a19899250/USPS APIs Domestic Labels API Documentation_2023_0901 Published.pdf -------------------------------------------------------------------------------- /dropoff-location-v3-response.json: -------------------------------------------------------------------------------- 1 | [ 2 | { 3 | "dropShipmentKey": "K020303", 4 | "facilityName": "ATLANTA GA RPDC", 5 | "facilityAddress": { 6 | "streetAddress": "600 PALMETTO LOGISTICS PKWY", 7 | "city": "PALMETTO", 8 | "state": "GA", 9 | "ZIPCode": "30268", 10 | "ZIPPlus4": "9991" 11 | }, 12 | "dropSitePhoneNumber": "4047657578", 13 | "destinationZIPCode": "303", 14 | "destinationEntryFacilityType": "DESTINATION_NETWORK_DISTRIBUTION_CENTER", 15 | "timeZone": "US/Eastern", 16 | "dstObserved": true, 17 | "acceptedPackageTypes": [ 18 | { 19 | "mailClass": "BOUND_PRINTED_MATTER", 20 | "processingCategory": "FLATS", 21 | "palletized": "BOTH" 22 | }, 23 | { 24 | "mailClass": "LIBRARY_MAIL", 25 | "processingCategory": "FLATS", 26 | "palletized": "BOTH" 27 | }, 28 | { 29 | "mailClass": "MEDIA_MAIL", 30 | "processingCategory": "FLATS", 31 | "palletized": "BOTH" 32 | }, 33 | { 34 | "mailClass": "BOUND_PRINTED_MATTER", 35 | "processingCategory": "NONSTANDARD", 36 | "palletized": "BOTH" 37 | }, 38 | { 39 | "mailClass": "LIBRARY_MAIL", 40 | "processingCategory": "NONSTANDARD", 41 | "palletized": "BOTH" 42 | }, 43 | { 44 | "mailClass": "MEDIA_MAIL", 45 | "processingCategory": "NONSTANDARD", 46 | "palletized": "BOTH" 47 | }, 48 | { 49 | "mailClass": "BOUND_PRINTED_MATTER", 50 | "processingCategory": "MACHINABLE", 51 | "palletized": "BOTH" 52 | }, 53 | { 54 | "mailClass": "LIBRARY_MAIL", 55 | "processingCategory": "MACHINABLE", 56 | "palletized": "BOTH" 57 | }, 58 | { 59 | "mailClass": "MEDIA_MAIL", 60 | "processingCategory": "MACHINABLE", 61 | "palletized": "BOTH" 62 | }, 63 | { 64 | "mailClass": "PARCEL_SELECT", 65 | "processingCategory": "NONSTANDARD", 66 | "palletized": "BOTH" 67 | }, 68 | { 69 | "mailClass": "USPS_CONNECT_REGIONAL", 70 | "processingCategory": "NONSTANDARD", 71 | "palletized": "BOTH" 72 | }, 73 | { 74 | "mailClass": "PARCEL_SELECT", 75 | "processingCategory": "MACHINABLE", 76 | "palletized": "BOTH" 77 | }, 78 | { 79 | "mailClass": "USPS_CONNECT_REGIONAL", 80 | "processingCategory": "MACHINABLE", 81 | "palletized": "BOTH" 82 | } 83 | ], 84 | "dropShipAcceptanceTimes": [], 85 | "dropShipmentFacilityDetails": { 86 | "dock": { 87 | "width": 10, 88 | "depth": 10, 89 | "height": 130 90 | }, 91 | "canopyClearance": 0, 92 | "liftTypes": { 93 | "manualLift": true, 94 | "electricGasLift": false, 95 | "cageStackerLift": false, 96 | "rollerTableExtenderLift": false 97 | }, 98 | "ramps": { 99 | "numberOfRamps": 0, 100 | "widestRamp": 1 101 | }, 102 | "truckManeuveringArea": { 103 | "length": 100, 104 | "width": 100, 105 | "surfaceType": "CONCRETE" 106 | }, 107 | "levelers": { 108 | "manualLevelers": 6, 109 | "hydraulicLevelers": 6, 110 | "scissorLevelers": 0 111 | }, 112 | "doorDetails": { 113 | "height": 0, 114 | "width": 0, 115 | "numberOfSteps": 0 116 | }, 117 | "overpassDetails": { 118 | "numberOfOverpasses": 0, 119 | "lowestOverpass": 0 120 | } 121 | }, 122 | "USPSConnectDetails": { 123 | "sameDayDelivery": false, 124 | "sameDayPickUp": "0000", 125 | "nextDayPickUp": "0000", 126 | "nextDayDropOffCutOffTimes": [], 127 | "sameDayDropOffCutOffTimes": [], 128 | "sameDayCarrierPickupCutOffTimes": [], 129 | "SundayDelivery": false 130 | } 131 | }, 132 | { 133 | "dropShipmentKey": "SX10969", 134 | "facilityName": "PEACHTREE CENTER", 135 | "facilityAddress": { 136 | "streetAddress": "240 PEACHTREE ST NW BSMT", 137 | "city": "ATLANTA", 138 | "state": "GA", 139 | "ZIPCode": "30303", 140 | "ZIPPlus4": "9996" 141 | }, 142 | "dropSitePhoneNumber": "4047657578", 143 | "destinationZIPCode": "30343", 144 | "destinationEntryFacilityType": "DESTINATION_DELIVERY_UNIT", 145 | "timeZone": "US/Eastern", 146 | "dstObserved": true, 147 | "acceptedPackageTypes": [ 148 | { 149 | "mailClass": "BOUND_PRINTED_MATTER", 150 | "processingCategory": "FLATS", 151 | "palletized": "BOTH" 152 | }, 153 | { 154 | "mailClass": "LIBRARY_MAIL", 155 | "processingCategory": "FLATS", 156 | "palletized": "BOTH" 157 | }, 158 | { 159 | "mailClass": "MEDIA_MAIL", 160 | "processingCategory": "FLATS", 161 | "palletized": "BOTH" 162 | }, 163 | { 164 | "mailClass": "BOUND_PRINTED_MATTER", 165 | "processingCategory": "NONSTANDARD", 166 | "palletized": "BOTH" 167 | }, 168 | { 169 | "mailClass": "LIBRARY_MAIL", 170 | "processingCategory": "NONSTANDARD", 171 | "palletized": "BOTH" 172 | }, 173 | { 174 | "mailClass": "MEDIA_MAIL", 175 | "processingCategory": "NONSTANDARD", 176 | "palletized": "BOTH" 177 | }, 178 | { 179 | "mailClass": "BOUND_PRINTED_MATTER", 180 | "processingCategory": "MACHINABLE", 181 | "palletized": "BOTH" 182 | }, 183 | { 184 | "mailClass": "LIBRARY_MAIL", 185 | "processingCategory": "MACHINABLE", 186 | "palletized": "BOTH" 187 | }, 188 | { 189 | "mailClass": "MEDIA_MAIL", 190 | "processingCategory": "MACHINABLE", 191 | "palletized": "BOTH" 192 | }, 193 | { 194 | "mailClass": "PARCEL_SELECT", 195 | "processingCategory": "NONSTANDARD", 196 | "palletized": "BOTH" 197 | }, 198 | { 199 | "mailClass": "USPS_CONNECT_LOCAL", 200 | "processingCategory": "NONSTANDARD", 201 | "palletized": "BOTH" 202 | }, 203 | { 204 | "mailClass": "USPS_CONNECT_MAIL", 205 | "processingCategory": "NONSTANDARD", 206 | "palletized": "BOTH" 207 | }, 208 | { 209 | "mailClass": "PARCEL_SELECT", 210 | "processingCategory": "MACHINABLE", 211 | "palletized": "BOTH" 212 | }, 213 | { 214 | "mailClass": "USPS_CONNECT_LOCAL", 215 | "processingCategory": "MACHINABLE", 216 | "palletized": "BOTH" 217 | }, 218 | { 219 | "mailClass": "USPS_CONNECT_MAIL", 220 | "processingCategory": "MACHINABLE", 221 | "palletized": "BOTH" 222 | } 223 | ], 224 | "dropShipAcceptanceTimes": [ 225 | { 226 | "dayOfWeek": "MONDAY", 227 | "times": [ 228 | { 229 | "openTime": "08:30", 230 | "closeTime": "16:30" 231 | } 232 | ] 233 | }, 234 | { 235 | "dayOfWeek": "TUESDAY", 236 | "times": [ 237 | { 238 | "openTime": "08:30", 239 | "closeTime": "16:30" 240 | } 241 | ] 242 | }, 243 | { 244 | "dayOfWeek": "WEDNESDAY", 245 | "times": [ 246 | { 247 | "openTime": "08:30", 248 | "closeTime": "16:30" 249 | } 250 | ] 251 | }, 252 | { 253 | "dayOfWeek": "THURSDAY", 254 | "times": [ 255 | { 256 | "openTime": "08:30", 257 | "closeTime": "16:30" 258 | } 259 | ] 260 | }, 261 | { 262 | "dayOfWeek": "FRIDAY", 263 | "times": [ 264 | { 265 | "openTime": "08:30", 266 | "closeTime": "16:30" 267 | } 268 | ] 269 | } 270 | ], 271 | "dropShipmentFacilityDetails": { 272 | "dock": { 273 | "width": 15, 274 | "depth": 3, 275 | "height": 56 276 | }, 277 | "canopyClearance": 14, 278 | "liftTypes": { 279 | "manualLift": true, 280 | "electricGasLift": true, 281 | "cageStackerLift": false, 282 | "rollerTableExtenderLift": false 283 | }, 284 | "ramps": { 285 | "numberOfRamps": 2, 286 | "widestRamp": 5 287 | }, 288 | "truckManeuveringArea": { 289 | "length": 0, 290 | "width": 0, 291 | "surfaceType": "ASPHALT" 292 | }, 293 | "levelers": { 294 | "manualLevelers": 0, 295 | "hydraulicLevelers": 0, 296 | "scissorLevelers": 0 297 | }, 298 | "doorDetails": { 299 | "height": 0, 300 | "width": 0, 301 | "numberOfSteps": 0 302 | }, 303 | "overpassDetails": { 304 | "numberOfOverpasses": 1, 305 | "lowestOverpass": 14 306 | } 307 | }, 308 | "USPSConnectDetails": { 309 | "sameDayDelivery": false, 310 | "sameDayPickUp": "0000", 311 | "nextDayPickUp": "0000", 312 | "nextDayDropOffCutOffTimes": [], 313 | "sameDayDropOffCutOffTimes": [], 314 | "sameDayCarrierPickupCutOffTimes": [], 315 | "SundayDelivery": false 316 | } 317 | }, 318 | { 319 | "dropShipmentKey": "K020303", 320 | "facilityName": "ATLANTA GA RPDC", 321 | "facilityAddress": { 322 | "streetAddress": "600 PALMETTO LOGISTICS PKWY", 323 | "city": "PALMETTO", 324 | "state": "GA", 325 | "ZIPCode": "30268", 326 | "ZIPPlus4": "9991" 327 | }, 328 | "dropSitePhoneNumber": "4047657578", 329 | "destinationZIPCode": "303", 330 | "destinationEntryFacilityType": "DESTINATION_SECTIONAL_CENTER_FACILITY", 331 | "timeZone": "US/Eastern", 332 | "dstObserved": true, 333 | "acceptedPackageTypes": [ 334 | { 335 | "mailClass": "BOUND_PRINTED_MATTER", 336 | "processingCategory": "NONSTANDARD", 337 | "palletized": "BOTH" 338 | }, 339 | { 340 | "mailClass": "LIBRARY_MAIL", 341 | "processingCategory": "NONSTANDARD", 342 | "palletized": "BOTH" 343 | }, 344 | { 345 | "mailClass": "MEDIA_MAIL", 346 | "processingCategory": "NONSTANDARD", 347 | "palletized": "BOTH" 348 | }, 349 | { 350 | "mailClass": "BOUND_PRINTED_MATTER", 351 | "processingCategory": "MACHINABLE", 352 | "palletized": "BOTH" 353 | }, 354 | { 355 | "mailClass": "LIBRARY_MAIL", 356 | "processingCategory": "MACHINABLE", 357 | "palletized": "BOTH" 358 | }, 359 | { 360 | "mailClass": "MEDIA_MAIL", 361 | "processingCategory": "MACHINABLE", 362 | "palletized": "BOTH" 363 | }, 364 | { 365 | "mailClass": "PARCEL_SELECT", 366 | "processingCategory": "NONSTANDARD", 367 | "palletized": "BOTH" 368 | }, 369 | { 370 | "mailClass": "USPS_CONNECT_REGIONAL", 371 | "processingCategory": "NONSTANDARD", 372 | "palletized": "BOTH" 373 | }, 374 | { 375 | "mailClass": "PARCEL_SELECT", 376 | "processingCategory": "MACHINABLE", 377 | "palletized": "BOTH" 378 | }, 379 | { 380 | "mailClass": "USPS_CONNECT_REGIONAL", 381 | "processingCategory": "MACHINABLE", 382 | "palletized": "BOTH" 383 | } 384 | ], 385 | "dropShipAcceptanceTimes": [], 386 | "dropShipmentFacilityDetails": { 387 | "dock": { 388 | "width": 10, 389 | "depth": 10, 390 | "height": 130 391 | }, 392 | "canopyClearance": 0, 393 | "liftTypes": { 394 | "manualLift": true, 395 | "electricGasLift": false, 396 | "cageStackerLift": false, 397 | "rollerTableExtenderLift": false 398 | }, 399 | "ramps": { 400 | "numberOfRamps": 0, 401 | "widestRamp": 1 402 | }, 403 | "truckManeuveringArea": { 404 | "length": 100, 405 | "width": 100, 406 | "surfaceType": "CONCRETE" 407 | }, 408 | "levelers": { 409 | "manualLevelers": 6, 410 | "hydraulicLevelers": 6, 411 | "scissorLevelers": 0 412 | }, 413 | "doorDetails": { 414 | "height": 0, 415 | "width": 0, 416 | "numberOfSteps": 0 417 | }, 418 | "overpassDetails": { 419 | "numberOfOverpasses": 0, 420 | "lowestOverpass": 0 421 | } 422 | }, 423 | "USPSConnectDetails": { 424 | "sameDayDelivery": false, 425 | "sameDayPickUp": "0000", 426 | "nextDayPickUp": "0000", 427 | "nextDayDropOffCutOffTimes": [], 428 | "sameDayDropOffCutOffTimes": [], 429 | "sameDayCarrierPickupCutOffTimes": [], 430 | "SundayDelivery": false 431 | } 432 | } 433 | ] --------------------------------------------------------------------------------