Skip to content

Commit 91a06a5

Browse files
harris-n-jalil-uspsharris-n-jalil-usps
committed
July Release Updates
1 parent 9e46a48 commit 91a06a5

File tree

2 files changed

+225
-0
lines changed

2 files changed

+225
-0
lines changed

‎Example-Postman.postman_collection.json‎

Lines changed: 78 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2234,6 +2234,84 @@
22342234
}
22352235
},
22362236
"response": []
2237+
},
2238+
{
2239+
"name": "3.0 Domestic Prices - Total Rates",
2240+
"event": [
2241+
{
2242+
"listen": "test",
2243+
"script": {
2244+
"exec": [
2245+
"pm.test(\"Status code is 200\", function () {\r",
2246+
" pm.response.to.have.status(200);\r",
2247+
"});"
2248+
],
2249+
"type": "text/javascript"
2250+
}
2251+
}
2252+
],
2253+
"protocolProfileBehavior": {
2254+
"disableCookies": true
2255+
},
2256+
"request": {
2257+
"auth": {
2258+
"type": "oauth2",
2259+
"oauth2": [
2260+
{
2261+
"key": "tokenType",
2262+
"value": "",
2263+
"type": "string"
2264+
},
2265+
{
2266+
"key": "accessToken",
2267+
"value": "{{token}}",
2268+
"type": "string"
2269+
},
2270+
{
2271+
"key": "client_authentication",
2272+
"value": "body",
2273+
"type": "string"
2274+
},
2275+
{
2276+
"key": "tokenName",
2277+
"value": "",
2278+
"type": "string"
2279+
},
2280+
{
2281+
"key": "addTokenTo",
2282+
"value": "header",
2283+
"type": "string"
2284+
}
2285+
]
2286+
},
2287+
"method": "POST",
2288+
"header": [],
2289+
"body": {
2290+
"mode": "raw",
2291+
"raw": "{\r\n \"originZIPCode\": \"36105\",\r\n \"destinationZIPCode\": \"78207\",\r\n \"weight\": 7,\r\n \"length\": 9,\r\n \"width\": 0.25,\r\n \"height\": 6,\r\n \"mailClass\": \"PARCEL_SELECT\",\r\n \"priceType\": \"COMMERCIAL\",\r\n \"mailingDate\": \"2023-07-28\",\r\n \"accountType\": \"EPS\",\r\n \"accountNumber\": \"XXXXXXXXXX\",\r\n \"itemValue\": 500,\r\n \"extraServices\": [\r\n 415\r\n ]\r\n}",
2292+
"options": {
2293+
"raw": {
2294+
"language": "json"
2295+
}
2296+
}
2297+
},
2298+
"url": {
2299+
"raw": "https://api.usps.com/prices/v3/total-rates/search",
2300+
"protocol": "https",
2301+
"host": [
2302+
"api",
2303+
"usps",
2304+
"com"
2305+
],
2306+
"path": [
2307+
"prices",
2308+
"v3",
2309+
"total-rates",
2310+
"search"
2311+
]
2312+
}
2313+
},
2314+
"response": []
22372315
}
22382316
]
22392317
},

‎README.md‎

Lines changed: 147 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -858,6 +858,153 @@ Response:
858858
"warnings": []
859859
}
860860
```
861+
### Domestic Prices - Total Rates Request (V3)
862+
Returns eligible extra service prices, descriptions, and SKUs given a set of package rate ingredients.
863+
```sh
864+
curl -X 'POST' 'https://api.usps.com/prices/v3/total-rates/search' \
865+
--header 'Content-Type: application/json' \
866+
--header 'Authorization: Bearer $TOKEN' \
867+
--data '{
868+
"originZIPCode": "36105",
869+
"destinationZIPCode": "78207",
870+
"weight": 7,
871+
"length": 9,
872+
"width": 0.25,
873+
"height": 6,
874+
"mailClass": "PARCEL_SELECT",
875+
"priceType": "COMMERCIAL",
876+
"mailingDate": "2023-07-28",
877+
"accountType": "EPS",
878+
"accountNumber": "XXXXXXXXXX",
879+
"itemValue": 500,
880+
"extraServices": [
881+
415
882+
]
883+
}'
884+
```
885+
Response:
886+
```json
887+
{
888+
"rateOptions": [
889+
{
890+
"totalBasePrice": 4.59,
891+
"totalPrice": 5.84,
892+
"rates": [
893+
{
894+
"description": "Parcel Select Machinable DDU Single-piece",
895+
"priceType": "COMMERCIAL",
896+
"price": 4.59,
897+
"weight": 7.0,
898+
"dimWeight": 0.0,
899+
"fees": [],
900+
"startDate": "2023-07-09",
901+
"endDate": "",
902+
"mailClass": "PARCEL_SELECT",
903+
"zone": "00",
904+
"SKU": "DVXP0XXUXC00070"
905+
}
906+
],
907+
"extraServices": [
908+
{
909+
"extraService": "415",
910+
"name": "Label Delivery",
911+
"priceType": "COMMERCIAL",
912+
"price": 1.25,
913+
"warnings": [],
914+
"SKU": "DXQX0XXXXCX0000"
915+
}
916+
]
917+
},
918+
{
919+
"totalBasePrice": 7.86,
920+
"totalPrice": 9.11,
921+
"rates": [
922+
{
923+
"description": "Parcel Select Machinable DNDC Single-piece",
924+
"priceType": "COMMERCIAL",
925+
"price": 7.86,
926+
"weight": 7.0,
927+
"dimWeight": 0.0,
928+
"fees": [],
929+
"startDate": "2023-07-09",
930+
"endDate": "",
931+
"mailClass": "PARCEL_SELECT",
932+
"zone": "00",
933+
"SKU": "DVXP0XXCXC00070"
934+
}
935+
],
936+
"extraServices": [
937+
{
938+
"extraService": "415",
939+
"name": "Label Delivery",
940+
"priceType": "COMMERCIAL",
941+
"price": 1.25,
942+
"warnings": [],
943+
"SKU": "DXQX0XXXXCX0000"
944+
}
945+
]
946+
},
947+
{
948+
"totalBasePrice": 6.79,
949+
"totalPrice": 8.04,
950+
"rates": [
951+
{
952+
"description": "Parcel Select Machinable DSCF SCF",
953+
"priceType": "COMMERCIAL",
954+
"price": 6.79,
955+
"weight": 7.0,
956+
"dimWeight": 0.0,
957+
"fees": [],
958+
"startDate": "2023-07-09",
959+
"endDate": "",
960+
"mailClass": "PARCEL_SELECT",
961+
"zone": "00",
962+
"SKU": "DVXP0XXFTC00070"
963+
}
964+
],
965+
"extraServices": [
966+
{
967+
"extraService": "415",
968+
"name": "Label Delivery",
969+
"priceType": "COMMERCIAL",
970+
"price": 1.25,
971+
"warnings": [],
972+
"SKU": "DXQX0XXXXCX0000"
973+
}
974+
]
975+
},
976+
{
977+
"totalBasePrice": 5.74,
978+
"totalPrice": 6.99,
979+
"rates": [
980+
{
981+
"description": "Parcel Select Machinable Single-piece",
982+
"priceType": "COMMERCIAL",
983+
"price": 5.74,
984+
"weight": 7.0,
985+
"dimWeight": 0.0,
986+
"fees": [],
987+
"startDate": "2023-07-09",
988+
"endDate": "",
989+
"mailClass": "PARCEL_SELECT",
990+
"zone": "00",
991+
"SKU": "DVXP0XXBXC00070"
992+
}
993+
],
994+
"extraServices": [
995+
{
996+
"extraService": "415",
997+
"name": "Label Delivery",
998+
"priceType": "COMMERCIAL",
999+
"price": 1.25,
1000+
"warnings": [],
1001+
"SKU": "DXQX0XXXXCX0000"
1002+
}
1003+
]
1004+
}
1005+
]
1006+
}
1007+
```
8611008
## International Prices
8621009
The International Prices API can be used to look-up postage rates for international packages:
8631010
- Lookup International Base Postage based on a set of given package characteristics

0 commit comments

Comments
 (0)