{"items":[{"type":"link","label":"RateGroup APIs","link":"/openapi/rategroup","routeSlug":"/openapi/rategroup","content":{"contentType":"overview","meta":{"name":"RateGroup APIs"},"children":[{"nodeType":"container","panels":[{"title":"Download OpenAPI description","titleTranslationKey":"download.description.title","children":[{"kind":"download","label":"rategroup.json","url":"/_bundle/openapi/rategroup.json?download"},{"kind":"download","label":"rategroup.yaml","url":"/_bundle/openapi/rategroup.yaml?download"}]},{"title":"Overview","titleTranslationKey":"info.title","children":[]},{"title":"Languages","titleTranslationKey":"languages.title","children":[{"kind":"languages","options":[{"key":"curl","title":"curl","lang":"curl"},{"key":"javascript","title":"JavaScript","lang":"JavaScript"},{"key":"node","title":"Node.js","lang":"Node.js"},{"key":"python","title":"Python","lang":"Python"},{"key":"java","title":"Java","lang":"Java"},{"key":"csharp","title":"C#","lang":"C#"},{"key":"php","title":"PHP","lang":"PHP"},{"key":"go","title":"Go","lang":"Go"},{"key":"ruby","title":"Ruby","lang":"Ruby"},{"key":"r","title":"R","lang":"R"},{"key":"payload","title":"Payload","lang":"Payload"}]}]},{"title":"Servers","titleTranslationKey":"servers.title","children":[{"kind":"servers","servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/shipping","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/shipping","description":"Production Server (uses live data)"},{"url":"https://api-ppd.shipping360.pitneybowes.com/ca/shipping","description":"Sandbox Server for Canada"},{"url":"https://api.shipping360.pitneybowes.com/ca/shipping","description":"Production Server for Canada"}],"mode":"default"}]}],"children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"header","level":1,"label":"RateGroup APIs (1.0.0)","showPageActions":true},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A RateGroup is used to automate carrier and service selection during shipment processing. Instead of explicitly passing a carrier and service in every request, you can pass a rateGroupId, and get the desired rate (for example, lowest cost or fastest delivery). "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"RateGroups helps with:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Atomatic rate shopping across multiple carriers"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Shipping decision depends on price, speed, or available services at runtime"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How it works"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a RateGroup with a list of"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"carrierCode (e.g., USPS, UPS, FedEx)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"serviceId (e.g., PM, FEDEX_GROUND, NDA) "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use the returned rateGroupId in"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Rate API:  to fetch the best available rate"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create Shipment API:  to generate a shipment using the selected service"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When a rateGroupId is provided in a request, carrier and service selection is handled internally based on the configured items."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Evaluation of carrier-service combinations is dynamic and may vary per request depending on shipment attributes such as origin, destination, and parcel details."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Only RateGroups with status active are considered for processing."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"RateGroups are country-specific, and only applicable shipments are evaluated."},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Read "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/docs/rategroup-management/rategroup-guide"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How to Create RateGroup"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}]}],"sectionId":"/openapi/rategroup"}],"sectionId":"/openapi/rategroup"}]}]}},{"type":"group","label":"RateGroup","link":"/openapi/rategroup/rategroup","routeSlug":"/openapi/rategroup/rategroup","items":[{"label":"Create RateGroup","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/rategroup/rategroup/createrategroup","routeSlug":"/openapi/rategroup/rategroup/createrategroup","metadata":{"seo":{"title":"Create RateGroup","description":"Use this API to create a RateGroup that groups carriers and their services for automated rate shopping. A RateGroup allows the system to dynamically select the cheapest or fastest delivery option across the defined carriers and services—without manual comparison.Read How to Create RateGroup."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createRateGroup","name":"Create RateGroup","isWebhook":false,"pointer":"/paths/~1api~1v1~1rategroups/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create RateGroup","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use this API to create a RateGroup that groups carriers and their services for automated rate shopping. A RateGroup allows the system to dynamically select the cheapest or fastest delivery option across the defined carriers and services—without manual comparison.Read "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/docs/rategroup-management/rategroup-guide"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How to Create RateGroup"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"bearerAuth","scopes":[],"type":"http","scheme":"bearer"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/Rategrouprequest","exampleIds":["paths/~1api~1v1~1rategroups/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/Rategrouprequest","exampleIds":["paths/~1api~1v1~1rategroups/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1api~1v1~1rategroups/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/v1/rategroups","servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/shipping","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/shipping","description":"Production Server (uses live data)"},{"url":"https://api-ppd.shipping360.pitneybowes.com/ca/shipping","description":"Sandbox Server for Canada"},{"url":"https://api.shipping360.pitneybowes.com/ca/shipping","description":"Production Server for Canada"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/Rategrouprequest","exampleIds":["paths/~1api~1v1~1rategroups/post/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","401","500"],"pointer":"/api/v1/rategroups","href":"rategroup/createrategroup","openApiOperationId":"createRateGroup","summary":"Create RateGroup"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/shipping","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/shipping","description":"Production Server (uses live data)"},{"url":"https://api-ppd.shipping360.pitneybowes.com/ca/shipping","description":"Sandbox Server for Canada"},{"url":"https://api.shipping360.pitneybowes.com/ca/shipping","description":"Production Server for Canada"}],"schemaId":"components/schemas/Rategrouprequest","exampleIds":["paths/~1api~1v1~1rategroups/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/Rategrouprequest","exampleIds":["paths/~1api~1v1~1rategroups/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successfully created a RateGroup.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_319"}},"schemaId":"schema_319"},{"code":"400","description":"Invalid request.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Errors"}},"schemaId":"components/schemas/Errors"},{"code":"401","description":"The request could not be authorized.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error"}},"schemaId":"components/schemas/error"},{"code":"500","description":"The request could not be completed due to an internal error."}],"pointer":"/paths/~1api~1v1~1rategroups/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_319","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_319"}}},{"code":"400","schemaId":"components/schemas/Errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Errors"}}},{"code":"401","schemaId":"components/schemas/error","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error"}}},{"code":"500"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/rategroup/createrategroup"}],"panels":[]}]},"httpPath":"/api/v1/rategroups"},{"label":"Get All RateGroups","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/rategroup/rategroup/getallrategroups","routeSlug":"/openapi/rategroup/rategroup/getallrategroups","metadata":{"seo":{"title":"Get All RateGroups","description":"This operation retrieves a list of all RateGroups with metadata such as the RateGroup ID, display name, origin country, status (active/inactive), audience type, included carriers and services, archival status available in the system."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getAllRateGroups","name":"Get All RateGroups","isWebhook":false,"pointer":"/paths/~1api~1v1~1rategroups/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get All RateGroups","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":" This operation retrieves a list of all RateGroups  with metadata such as the RateGroup ID, display name, origin country, status (active/inactive), audience type, included carriers and services, archival status available in the system."},{"nodeType":"security","requirements":[{"schemes":[{"name":"bearerAuth","scopes":[],"type":"http","scheme":"bearer"}]}]}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/rategroups","servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/shipping","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/shipping","description":"Production Server (uses live data)"},{"url":"https://api-ppd.shipping360.pitneybowes.com/ca/shipping","description":"Sandbox Server for Canada"},{"url":"https://api.shipping360.pitneybowes.com/ca/shipping","description":"Production Server for Canada"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","400","401","500"],"pointer":"/api/v1/rategroups","href":"rategroup/getallrategroups","openApiOperationId":"getAllRateGroups","summary":"Get All RateGroups"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/shipping","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/shipping","description":"Production Server (uses live data)"},{"url":"https://api-ppd.shipping360.pitneybowes.com/ca/shipping","description":"Sandbox Server for Canada"},{"url":"https://api.shipping360.pitneybowes.com/ca/shipping","description":"Production Server for Canada"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Retrived a list of all rete groups available.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AllRateGroups","exampleIds":["paths/~1api~1v1~1rategroups/get/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/AllRateGroups","exampleIds":["paths/~1api~1v1~1rategroups/get/responses/200/content/application~1json/example"]},{"code":"400","description":"Invalid request.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Errors"}},"schemaId":"components/schemas/Errors"},{"code":"401","description":"The request could not be authorized.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error"}},"schemaId":"components/schemas/error"},{"code":"500","description":"The request could not be completed due to an internal error."}],"pointer":"/paths/~1api~1v1~1rategroups/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/AllRateGroups","exampleIds":["paths/~1api~1v1~1rategroups/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AllRateGroups","exampleIds":["paths/~1api~1v1~1rategroups/get/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"components/schemas/Errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Errors"}}},{"code":"401","schemaId":"components/schemas/error","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error"}}},{"code":"500"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/rategroup/getallrategroups"}],"panels":[]}]},"httpPath":"/api/v1/rategroups"},{"label":"Get RateGroup by ID","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/rategroup/rategroup/getrategroup","routeSlug":"/openapi/rategroup/rategroup/getrategroup","metadata":{"seo":{"title":"Get RateGroup by ID","description":"This operation retrieves a RateGroups using the provided RateGroup ID with metadata such as the RateGroup ID, display name, origin country, status (active/inactive), audience type, included carriers and services, archival status available in the system."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getRateGroup","name":"Get RateGroup by ID","isWebhook":false,"pointer":"/paths/~1api~1v1~1rategroups~1{rateGroupId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get RateGroup by ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"This operation retrieves a RateGroups using the provided RateGroup ID with metadata such as the RateGroup ID, display name, origin country, status (active/inactive), audience type, included carriers and services, archival status available in the system."},{"nodeType":"security","requirements":[{"schemes":[{"name":"bearerAuth","scopes":[],"type":"http","scheme":"bearer"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"rateGroupId","in":"path","schemaId":"schema_320","description":"Unique identifier of the rategroup created. This Id is used in rate shipment and create shipment requests for automatic rate shopping.","required":true}],"pointer":"/paths/~1api~1v1~1rategroups~1{rateGroupId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/v1/rategroups/{rateGroupId}","servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/shipping","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/shipping","description":"Production Server (uses live data)"},{"url":"https://api-ppd.shipping360.pitneybowes.com/ca/shipping","description":"Sandbox Server for Canada"},{"url":"https://api.shipping360.pitneybowes.com/ca/shipping","description":"Production Server for Canada"}],"parameters":{"path":[{"name":"rateGroupId","in":"path","required":true,"example":"Q6Wp3onr3JNlDXx","schemaId":"schema_320"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","400","401","500"],"pointer":"/api/v1/rategroups/{rateGroupId}","href":"rategroup/getrategroup","openApiOperationId":"getRateGroup","summary":"Get RateGroup by ID"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/shipping","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/shipping","description":"Production Server (uses live data)"},{"url":"https://api-ppd.shipping360.pitneybowes.com/ca/shipping","description":"Sandbox Server for Canada"},{"url":"https://api.shipping360.pitneybowes.com/ca/shipping","description":"Production Server for Canada"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Retrieved the specified rategroup.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SingleRateGroups","exampleIds":["paths/~1api~1v1~1rategroups~1{rateGroupId}/get/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/SingleRateGroups","exampleIds":["paths/~1api~1v1~1rategroups~1{rateGroupId}/get/responses/200/content/application~1json/example"]},{"code":"400","description":"Invalid request.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Errors"}},"schemaId":"components/schemas/Errors"},{"code":"401","description":"The request could not be authorized.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error"}},"schemaId":"components/schemas/error"},{"code":"500","description":"The request could not be completed due to an internal error."}],"pointer":"/paths/~1api~1v1~1rategroups~1{rateGroupId}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/SingleRateGroups","exampleIds":["paths/~1api~1v1~1rategroups~1{rateGroupId}/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SingleRateGroups","exampleIds":["paths/~1api~1v1~1rategroups~1{rateGroupId}/get/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"components/schemas/Errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Errors"}}},{"code":"401","schemaId":"components/schemas/error","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error"}}},{"code":"500"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/rategroup/getrategroup"}],"panels":[]}]},"httpPath":"/api/v1/rategroups/{rateGroupId}"},{"label":"Update RateGroup","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/rategroup/rategroup/updaterategroup","routeSlug":"/openapi/rategroup/rategroup/updaterategroup","metadata":{"seo":{"title":"Update RateGroup","description":"This operation updates the details of an existing RateGroup identified by its RateGroup ID. You can modify attributes such as the display name, status (active/inactive), audience type (Enterprise, Location, or Users and Roles), and the list of carriers and services associated with the RateGroup. Once updated, the revised RateGroup will be available for use in dynamic rate shopping through the Rate and Create Shipment APIs."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateRateGroup","name":"Update RateGroup","isWebhook":false,"pointer":"/paths/~1api~1v1~1rategroups~1{rateGroupId}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update RateGroup","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"This operation updates the details of an existing RateGroup identified by its RateGroup ID. You can modify attributes such as the display name, status (active/inactive), audience type (Enterprise, Location, or Users and Roles), and the list of carriers and services associated with the RateGroup. Once updated, the revised RateGroup will be available for use in dynamic rate shopping through the Rate and Create Shipment APIs."},{"nodeType":"security","requirements":[{"schemes":[{"name":"bearerAuth","scopes":[],"type":"http","scheme":"bearer"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"rateGroupId","in":"path","schemaId":"schema_320","description":"Unique identifier of the RateGroup created. This Id is used in rate shipment and create shipment requests for automatic rate shopping.","required":true}],"pointer":"/paths/~1api~1v1~1rategroups~1{rateGroupId}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/Rategrouprequest","exampleIds":["paths/~1api~1v1~1rategroups~1{rateGroupId}/put/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/Rategrouprequest","exampleIds":["paths/~1api~1v1~1rategroups~1{rateGroupId}/put/requestBody/content/application~1json/example"],"pointer":"/paths/~1api~1v1~1rategroups~1{rateGroupId}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/api/v1/rategroups/{rateGroupId}","servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/shipping","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/shipping","description":"Production Server (uses live data)"},{"url":"https://api-ppd.shipping360.pitneybowes.com/ca/shipping","description":"Sandbox Server for Canada"},{"url":"https://api.shipping360.pitneybowes.com/ca/shipping","description":"Production Server for Canada"}],"parameters":{"path":[{"name":"rateGroupId","in":"path","required":true,"example":"Q6Wp3onr3JNlDXx","schemaId":"schema_320"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/Rategrouprequest","exampleIds":["paths/~1api~1v1~1rategroups~1{rateGroupId}/put/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","401","500"],"pointer":"/api/v1/rategroups/{rateGroupId}","href":"rategroup/updaterategroup","openApiOperationId":"updateRateGroup","summary":"Update RateGroup"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/shipping","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/shipping","description":"Production Server (uses live data)"},{"url":"https://api-ppd.shipping360.pitneybowes.com/ca/shipping","description":"Sandbox Server for Canada"},{"url":"https://api.shipping360.pitneybowes.com/ca/shipping","description":"Production Server for Canada"}],"schemaId":"components/schemas/Rategrouprequest","exampleIds":["paths/~1api~1v1~1rategroups~1{rateGroupId}/put/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/Rategrouprequest","exampleIds":["paths/~1api~1v1~1rategroups~1{rateGroupId}/put/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"RateGroup metadata has been updated successfully.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_321"}},"schemaId":"schema_321"},{"code":"400","description":"Invalid request.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Errors"}},"schemaId":"components/schemas/Errors"},{"code":"401","description":"The request could not be authorized.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error"}},"schemaId":"components/schemas/error"},{"code":"500","description":"The request could not be completed due to an internal error."}],"pointer":"/paths/~1api~1v1~1rategroups~1{rateGroupId}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_321","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_321"}}},{"code":"400","schemaId":"components/schemas/Errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Errors"}}},{"code":"401","schemaId":"components/schemas/error","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error"}}},{"code":"500"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/rategroup/updaterategroup"}],"panels":[]}]},"httpPath":"/api/v1/rategroups/{rateGroupId}"},{"label":"Delete RateGroup","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/rategroup/rategroup/deleterategroup","routeSlug":"/openapi/rategroup/rategroup/deleterategroup","metadata":{"seo":{"title":"Delete RateGroup","description":"This operations deletes the specified RateGroup."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteRateGroup","name":"Delete RateGroup","isWebhook":false,"pointer":"/paths/~1api~1v1~1rategroups~1{rateGroupId}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete RateGroup","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"This operations deletes the specified RateGroup."},{"nodeType":"security","requirements":[{"schemes":[{"name":"bearerAuth","scopes":[],"type":"http","scheme":"bearer"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"rateGroupId","in":"path","schemaId":"schema_320","description":"Unique identifier of the RateGroup created. This Id is used in rate shipment and create shipment requests for automatic rate shopping.","required":true}],"pointer":"/paths/~1api~1v1~1rategroups~1{rateGroupId}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/api/v1/rategroups/{rateGroupId}","servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/shipping","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/shipping","description":"Production Server (uses live data)"},{"url":"https://api-ppd.shipping360.pitneybowes.com/ca/shipping","description":"Sandbox Server for Canada"},{"url":"https://api.shipping360.pitneybowes.com/ca/shipping","description":"Production Server for Canada"}],"parameters":{"path":[{"name":"rateGroupId","in":"path","required":true,"example":"Q6Wp3onr3JNlDXx","schemaId":"schema_320"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"bearerAuth","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","400","401","500"],"pointer":"/api/v1/rategroups/{rateGroupId}","href":"rategroup/deleterategroup","openApiOperationId":"deleteRateGroup","summary":"Delete RateGroup"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/shipping","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/shipping","description":"Production Server (uses live data)"},{"url":"https://api-ppd.shipping360.pitneybowes.com/ca/shipping","description":"Sandbox Server for Canada"},{"url":"https://api.shipping360.pitneybowes.com/ca/shipping","description":"Production Server for Canada"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"The RateGroup has been archived successfully."},{"code":"400","description":"Invalid request.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Errors"}},"schemaId":"components/schemas/Errors"},{"code":"401","description":"The request could not be authorized.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error"}},"schemaId":"components/schemas/error"},{"code":"500","description":"The request could not be completed due to an internal error."}],"pointer":"/paths/~1api~1v1~1rategroups~1{rateGroupId}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200"},{"code":"400","schemaId":"components/schemas/Errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Errors"}}},{"code":"401","schemaId":"components/schemas/error","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error"}}},{"code":"500"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/rategroup/deleterategroup"}],"panels":[]}]},"httpPath":"/api/v1/rategroups/{rateGroupId}"}],"content":{"contentType":"group","meta":{"name":"RateGroup"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"RateGroup","showPageActions":true},{"nodeType":"markdoc","content":"APIs for creating, retrieving, updating, and deleting RateGroups. These APIs help manage carrier-service groupings and enable automated rate selection during shipment and rate request workflows."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/v1/rategroups","summary":"Create RateGroup","prefix":{"name":"post","color":"post"},"badges":[],"link":"/rategroup/createrategroup","deprecated":false},{"title":"/api/v1/rategroups","summary":"Get All RateGroups","prefix":{"name":"get","color":"get"},"badges":[],"link":"/rategroup/getallrategroups","deprecated":false},{"title":"/api/v1/rategroups/{rateGroupId}","summary":"Get RateGroup by ID","prefix":{"name":"get","color":"get"},"badges":[],"link":"/rategroup/getrategroup","deprecated":false},{"title":"/api/v1/rategroups/{rateGroupId}","summary":"Update RateGroup","prefix":{"name":"put","color":"put"},"badges":[],"link":"/rategroup/updaterategroup","deprecated":false},{"title":"/api/v1/rategroups/{rateGroupId}","summary":"Delete RateGroup","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/rategroup/deleterategroup","deprecated":false}]}]}]}]}}],"store":{"schemaStore":{"components/schemas/Rategrouprequest":{"id":"components/schemas/Rategrouprequest","kind":"json-schema","title":"Rategrouprequest","data":{"type":"object","required":["name","countryCode","items"],"properties":{"name":{"type":"string","description":"Display name of the RateGroup. This will be used as the rategroup's nickname or label.","example":"RATEGROUP-2"},"countryCode":{"type":"string","description":"Two-letter ISO country code representing the shipment origin for which the RateGroup is created.","example":"US"},"status":{"type":"string","enum":["active","inactive"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Defines whether the RateGroup is available for use ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"active"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") or not ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"inactive"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"example":"active"},"permissionEntityBy":{"type":"string","enum":["E","L","R","U"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Defines the audience who can access and use this RateGroup."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"E"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Enterprise (all users in the organization). If "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"permissionEntityBy"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not explicitly provided, Enterprise is set as the default entity."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"L"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Locations (restricted to specific locations)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"R"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": User Roles (restricted to specific roles, e.g., Admin or USER)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"U"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Users"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"RateGroups created at the enterprise level are supported in downstream API operations such as Create Shipment and Rate Shipment."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API requests fail if they use RateGroups created at user, division, or location levels."},"children":[]}]}]}]}],"example":"R"},"permissions":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List of audience identifiers who can access the RateGroup as set in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"permissionEntityBy"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"items":{"type":"object","properties":{"permissionEntityId":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Identifier of the audience (e.g., "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ADMIN"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"User"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", location ID)."},"children":[]}]}]}],"example":"ADMIN"}}}},"items":{"type":"array","description":"Array of carriers and their services to be included in the RateGroup for rate shopping.","items":{"type":"object","required":["carrierCode","serviceId"],"properties":{"carrierCode":{"type":"string","description":"U\"nique identifier of the carrier (e.g., USPS, FedEx, UPS).\"","example":"USPS"},"serviceId":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Identifier of the service offered by the carrier (e.g., PM for Priority Mail, FEDEX_GROUND)."},"children":[]}]}]}],"example":"PM"}}}}}}},"components/schemas/AllRateGroups":{"id":"components/schemas/AllRateGroups","kind":"json-schema","title":"AllRateGroups","data":{"type":"array","items":{"type":"object","properties":{"rateGroupId":{"type":"string","description":"Unique identifier of the rategroup created. This Id is used in rate shipment and create shipment requests for automatic rate shopping.","example":"Eew5PY45A9KWakb"},"uid":{"type":"string","description":"Unique user identifier who created the RateGroup.","example":"A8wZK4J2YdzqZym"},"name":{"type":"string","description":"Display name of the RateGroup.","example":"FEDEX-NDA"},"countryCode":{"type":"string","description":"ISO country code of the origin country for the RateGroup.","example":"US"},"permissionEntityBy":{"type":"string","description":"Audience type who can access this RateGroup.","enum":["E","L","R"],"example":"E"},"status":{"type":"string","description":"Status of the RateGroup.","enum":["active","inactive"],"example":"active"},"items":{"type":"array","description":"List of carriers and their services included in the RateGroup.","items":{"type":"object","properties":{"carrierCode":{"type":"string","description":"Unique identifier of the carrier.","example":"FEDEX"},"serviceId":{"type":"string","description":"Identifier of the carrier's service.","example":"NDA"}}}},"archived":{"type":"boolean","description":"Indicates whether the RateGroup is archived","example":false},"updateTimestamp":{"type":"string","format":"date-time","description":"Last update timestamp of the RateGroup","example":"2025-08-18T11:48:46.128Z"}}}}},"components/schemas/SingleRateGroups":{"id":"components/schemas/SingleRateGroups","kind":"json-schema","title":"SingleRateGroups","data":{"type":"object","properties":{"rateGroupId":{"type":"string","description":"Unique identifier of the rategroup created. This Id is used in rate shipment and create shipment requests for automatic rate shopping.","example":"Eew5PY45A9KWakb"},"uid":{"type":"string","description":"Unique user identifier who created the RateGroup.","example":"A8wZK4J2YdzqZym"},"name":{"type":"string","description":"Display name of the RateGroup.","example":"FEDEX-NDA"},"countryCode":{"type":"string","description":"ISO country code of the origin country for the RateGroup.","example":"US"},"permissionEntityBy":{"type":"string","description":"Audience type who can access this RateGroup.","enum":["E","L","R"],"example":"E"},"status":{"type":"string","description":"Status of the RateGroup.","enum":["active","inactive"],"example":"active"},"items":{"type":"array","description":"List of carriers and their services included in the RateGroup.","items":{"type":"object","properties":{"carrierCode":{"type":"string","description":"Unique identifier of the carrier.","example":"FEDEX"},"serviceId":{"type":"string","description":"Identifier of the carrier's service.","example":"NDA"}}}},"archived":{"type":"boolean","description":"Indicates whether the RateGroup is archived","example":false},"updateTimestamp":{"type":"string","format":"date-time","description":"Last update timestamp of the RateGroup","example":"2025-08-18T11:48:46.128Z"}}}},"components/schemas/error":{"id":"components/schemas/error","kind":"json-schema","title":"error","data":{"type":"object","properties":{"message":{"type":"string","description":"This is HTTP 401 Unauthorized response status code, that indicates that the client request has not been completed because it lacks valid authentication credentials for the requested resource."}},"required":["message"]}},"components/schemas/Errors":{"id":"components/schemas/Errors","kind":"json-schema","title":"Errors","data":{"type":"array","items":{"type":"object","properties":{"errorCode":{"type":"string","description":"Error code(s) that appear due to HTTP  400- Invalid or Bad Request, e.g. validation-error.","example":"validation_error"},"errorDescription":{"type":"string","description":"The HTTP 400 Bad Request response status code indicates that the server cannot process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing).","example":"Rategrop cannot created."},"additionalCode":{"type":"string","description":"A unique identifier for the error, for example 01000806."},"additionalInfo":{"type":"string","description":"This is an additional information about the error. This error 'Invalid Request' might appear due to invalid dimension, weight, or serviceid, or if the information is missing."},"additionalParameters":{"type":"array","items":{"type":"string","description":"The field(s) that might be incorrect in the request."}}}}}},"components/schemas/NotFoundErrors":{"id":"components/schemas/NotFoundErrors","kind":"json-schema","title":"NotFoundErrors","data":{"type":"array","items":{"type":"object","properties":{"errorCode":{"type":"string","example":"not_found","description":"Error code(s) that appear due HTTP 404 Page or File not found."},"errorDescription":{"type":"string","example":"resource not found","description":"The HTTP 404 Not Found response status code indicates that the server cannot find the requested resource."},"additionalCode":{"type":"string","description":"A unique identifier for the error, for example 0100025, 1110017, or 1090001."},"additionalInfo":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Additional information about the error. This error 'Not Found' might appear due to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"RateGroup Not Found"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"No Shipments to close"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Original Transaction not found"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},"additionalParameters":{"type":"array","items":{"type":"string","description":"The field(s) that might be incorrect in the request."}}}}}},"schema_319":{"kind":"json-schema","data":{"type":"object","properties":{"rateGroupId":{"type":"string","description":"Unique identifier of the rategroup created. This Id is used in rate shipment and create shipment requests for automatic rate shopping.","example":"wZJvKEBg0gPVbZ5"}}},"id":"schema_319"},"schema_320":{"kind":"json-schema","data":{"type":"string","example":"Q6Wp3onr3JNlDXx"},"id":"schema_320"},"schema_321":{"kind":"json-schema","data":{"type":"object","properties":{"rateGroupId":{"type":"string","description":"Unique identifier of the RateGroup created. This Id is used in rate shipment and create shipment requests for automatic rate shopping.","example":"wZJvKEBg0gPVbZ5"}}},"id":"schema_321"}},"exampleStore":{"paths/~1api~1v1~1rategroups/post/requestBody/content/application~1json/example":{"value":{"name":"RATEGROUP USERS2","countryCode":"US","status":"active","permissionEntityBy":"R","permissions":[{"permissionEntityId":"ADMIN"},{"permissionEntityId":"User"}],"items":[{"carrierCode":"USPS","serviceId":"PM"},{"carrierCode":"FedEx","serviceId":"FEDEX_GROUND"},{"carrierCode":"UPS","serviceId":"2ND_DAY_AIR"}]},"id":"paths/~1api~1v1~1rategroups/post/requestBody/content/application~1json/example"},"paths/~1api~1v1~1rategroups/get/responses/200/content/application~1json/example":{"value":[{"rateGroupId":"Eew5PY45A9KWakb","uid":"A8wZK4J2YdzqZym","name":"FEDEX-NDA","countryCode":"US","permissionEntityBy":"E","status":"active","items":[{"carrierCode":"FEDEX","serviceId":"NDA"}],"archived":false,"updateTimestamp":"2025-08-18T11:48:46.128Z"},{"rateGroupId":"Q6Wp3onr3JNlDXx","uid":"Ae6vn3VD5voQ46R","name":"FEDEX-UPS-NDA","countryCode":"US","permissionEntityBy":"E","status":"active","items":[{"carrierCode":"FEDEX","serviceId":"NDA"},{"carrierCode":"FEDEX","serviceId":"2DA"},{"carrierCode":"UPS","serviceId":"NDA"}],"archived":false,"updateTimestamp":"2025-08-14T10:03:47.063Z"}],"id":"paths/~1api~1v1~1rategroups/get/responses/200/content/application~1json/example"},"paths/~1api~1v1~1rategroups~1{rateGroupId}/get/responses/200/content/application~1json/example":{"value":{"rateGroupId":"Q6Wp3onr3JNlDXx","uid":"Ae6vn3VD5voQ46R","name":"FEDEX-UPS-NDA","countryCode":"US","permissionEntityBy":"E","status":"active","items":[{"carrierCode":"FEDEX","serviceId":"NDA"},{"carrierCode":"FEDEX","serviceId":"2DA"},{"carrierCode":"UPS","serviceId":"NDA"}],"archived":false,"updateTimestamp":"2025-08-14T10:03:47.063Z","permissions":[{"permissionEntityId":"1eBNadyLLYp"}]},"id":"paths/~1api~1v1~1rategroups~1{rateGroupId}/get/responses/200/content/application~1json/example"},"paths/~1api~1v1~1rategroups~1{rateGroupId}/put/requestBody/content/application~1json/example":{"value":{"name":"RATEGROUP USERS2","countryCode":"US","status":"active","permissionEntityBy":"R","permissions":[{"permissionEntityId":"ADMIN"},{"permissionEntityId":"User"}],"items":[{"carrierCode":"USPS","serviceId":"PM"},{"carrierCode":"FedEx","serviceId":"FEDEX_GROUND"},{"carrierCode":"UPS","serviceId":"2ND_DAY_AIR"}]},"id":"paths/~1api~1v1~1rategroups~1{rateGroupId}/put/requestBody/content/application~1json/example"}},"securitySchemeStore":{"basicAuth":{"id":"basicAuth","type":"http","scheme":"basic"},"bearerAuth":{"id":"bearerAuth","type":"http","scheme":"bearer"}},"servers":[{"url":"https://api-sandbox.sendpro360.pitneybowes.com/shipping","description":"Sandbox Server"},{"url":"https://api.sendpro360.pitneybowes.com/shipping","description":"Production Server (uses live data)"},{"url":"https://api-ppd.shipping360.pitneybowes.com/ca/shipping","description":"Sandbox Server for Canada"},{"url":"https://api.shipping360.pitneybowes.com/ca/shipping","description":"Production Server for Canada"}]},"options":{"hideDownloadButtons":false,"hideInfoMetadata":true,"jsonSamplesExpandLevel":3,"layout":"three-panel","schemasExpansionLevel":2,"generateCodeSamples":{"languages":[{"lang":"curl"},{"lang":"JavaScript"},{"lang":"Node.js"},{"lang":"Python"},{"lang":"Go"},{"lang":"Java"},{"lang":"C#"}]},"hideSidebar":true,"mockServer":{"off":true},"disableRouter":true,"downloadUrls":[{"url":"/_bundle/openapi/rategroup.json?download"},{"url":"/_bundle/openapi/rategroup.yaml?download"}],"excludeFromSearch":false,"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"RateGroup APIs","description":"A RateGroup is used to automate carrier and service selection during shipment processing. Instead of explicitly passing a carrier and service in every request, you can pass a rateGroupId, and get the desired rate (for example, lowest cost or fastest delivery). <br/>\nRateGroups helps with:\n- Atomatic rate shopping across multiple carriers\n- Shipping decision depends on price, speed, or available services at runtime\n\n**How it works**<br/>\n- Create a RateGroup with a list of\n  - carrierCode (e.g., USPS, UPS, FedEx)\n  - serviceId (e.g., PM, FEDEX_GROUND, NDA) <br/>\n\n- Use the returned rateGroupId in\n  - Rate API:  to fetch the best available rate\n  - Create Shipment API:  to generate a shipment using the selected service\n\n- When a rateGroupId is provided in a request, carrier and service selection is handled internally based on the configured items.\n- Evaluation of carrier-service combinations is dynamic and may vary per request depending on shipment attributes such as origin, destination, and parcel details.\n- Only RateGroups with status active are considered for processing.\n- RateGroups are country-specific, and only applicable shipments are evaluated.\n\n> Read [How to Create RateGroup](/docs/rategroup-management/rategroup-guide).\n"}},"baseSlug":"/openapi/rategroup","routesMapping":{}}