Skip to main content

GET/shipping/marketplace/{marketplace_id}/get_shipping_carriers

This method retrieves a list of supported shipping carriers for the specified marketplace. It provides essential information for sellers to understand which shipping carriers are available for use when listing items on that eBay marketplace. Knowing the supported carriers can help sellers optimize their shipping options and ensure efficient delivery to buyers.

The value returned in the shippingCarrier field is the enumerated value required when providing shipment tracking information for that carrier.

Tip: Use the getShippingServices method to explore available shipping services for each carrier.

Manage shipping carriers using business policies through the fulfillment_policy resource of the Account v1 API.

Input

Resource URI

GET https://api.ebay.com/sell/metadata/v1/shipping/marketplace/{marketplace_id}/get_shipping_carriers

This method is supported in Sandbox environment. To access the endpoint, just replace the api.ebay.com root URI with api.sandbox.ebay.com

URI parameters

ParameterTypeDescription
marketplace_idstringThis path parameter specifies the eBay marketplace for which shipping carriers information is retrieved.

See MarketplaceIdEnum for supported eBay marketplace ID values.

Note: When listing the items on the French Canada, French Belgium, and Dutch Belgium marketplaces, also set the Accept-Language header as needed.

Occurrence: Required

HTTP request headers

All requests made to eBay REST operations require you to provide the Authorization HTTP header for authentication authorization.

The table below shows additional HTTP request headers that are either required, conditionally required, or strongly recommended for this method. Other standard HTTP request headers- opens rest request components page (not in this table) can also be used, but they are optional.

HeaderTypeDescription
Accept-LanguagestringThis header is required to retrieve metadata for the French Canada, French Belgium, and Dutch Belgium marketplaces.

Follow the instructions below to retrieve metadata for these three marketplaces:
  • French Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of fr-BE.
  • Dutch Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of nl-BE.
  • French Canada: Set the marketplace_id path parameter value to EBAY_CA, and include the Accept-Language header with a value of fr-CA.
Note: If EBAY_CA is set as the marketplace_id path parameter and the Accept-Language header is not used, the marketplace will default to the English Canada marketplace.

Occurrence: Conditional

OAuth scope

This request requires an access token created with the client credentials grant flow, using one or more scopes from the following list (please check your Application Keys page for a list of OAuth scopes available to your application):

https://api.ebay.com/oauth/api_scope

See OAuth access tokens for more information.

Request payload

This call has no payload.

Request fields

This call has no field definitions.

Output

HTTP response headers

This call has no response headers.

Response payload

Response fields

Output container/fieldTypeDescription
shippingCarriersarray of ShippingCarrier

A list of shipping carriers available for the marketplace.

Occurrence: Always

shippingCarriers.descriptionstring

The localized description of the shipping carrier, such as UPS, FedEx, and USPS.

Occurrence: Always

shippingCarriers.shippingCarrierstring

An enumerated value describing the shipping carrier returned, for example, UPS, FedEx, and USPS. These values are needed when providing shipment tracking information for each specific shipping carrier.

Occurrence: Always

HTTP status codes

This call can return one of the following HTTP status codes. For an overview of the status codes, see HTTP status codes in Using eBay RESTful APIs.

StatusMeaning
200Success
400Bad Request
500Internal Server Error

Error codes

For more on errors, plus the codes of other common errors, see Handling errors.

CodeDomainCategoryMeaning
46000API_METADATAAPPLICATIONThere was a problem with an eBay internal system or process. Contact eBay developer support for assistance.
46001API_METADATAREQUESTThe specified marketplace ID was not found.

Warnings

This call has no warnings.

Samples

New to making API calls? Please see Making a Call.

Note: Identifiers, such as order IDs or user IDs, and personal data in these samples might be anonymized or may no longer be active on eBay. If necessary, substitute current, relevant eBay data in your requests.

Sample 1: Retrieve the eBay shipping carriers available for the specified marketplace

This example retrieves the eBay shipping carriers available for the EBAY_US marketplace.

This method returns an array with each node in the response containing the available shipping carriers returned.

Input

This method does not use a request payload. The response returns a list for the marketplace specified through the path parameter.

GEThttps://api.ebay.com/sell/metadata/v1/shipping/marketplace/EBAY_US/get_shipping_carriers

Output

If the call is successful, the response body contains the available shipping carriers available for the marketplace specified in the request.