Get Carrier License Agreement¶
HTTP Request¶
GET /v1/carrier/license-agreements?carrier={carrier}&originCountryCode={two-character-ISO-code}
Summary¶
This operation retrieves a carrier’s license agreement. The operation is used in the steps to Add a Carrier through the APIs.
Considerations¶
The returned license agreement includes escape characters (for example, \n, \t, and \"). You should substitute the escape characters with appropriate control characters or punctuation marks.
Request URLs¶
Sandbox: https://shipping-api-sandbox.pitneybowes.com/shippingservices/v1/carrier/license-agreements?carrier={carrier}&originCountryCode={two-character-ISO-code}
Production: https://shipping-api.pitneybowes.com/shippingservices/v1/carrier/license-agreements?carrier={carrier}&originCountryCode={two-character-ISO-code}
Query Parameters¶
Name |
Description |
|---|---|
carrier |
Required. The carrier. Valid values:
|
originCountryCode |
Required. The two-character ISO country code for the origin country. Valid values: |
Request Header¶
Name |
Description |
|---|---|
Authorization |
Required. OAuth token generated using the Generate an OAuth Token API. |
Response Element¶
Name |
Description |
|---|---|
licenseText |
The license agreement. |
Sample Request¶
curl -X GET ".../v1/carrier/license-agreements?carrier=UPS&originCountryCode=US" \
-H "Authorization: Bearer <oauth_token>" \
-H "X-PB-UnifiedErrorStructure: true"
Sample Response¶
{
"licenseText": "<text>"
}
Error Codes¶
For a list of all error codes returned by the PB Shipping APIs, please see Error Codes.