--- title: Account API v1 description: "The **Account API v1** helps sellers configure and manage the core selling settings that power their eBay business. This API centralizes seller account configuration, including business policies (payment, fulfillment, and return), sales tax tables, custom compliance policies, and key account-level attributes like selling limits, subscriptions, and payments program status. **NOTE:** The Account API v1 is part of the Sell APIs and is intended for managing account-level configuration, not for creating or revising individual listings. Use it together with listing-focused APIs (such as Inventory or Trading/Listing APIs) to ensure that all listings consistently follow your centralized payment, shipping, return, and tax policies across eBay marketplaces." api_version: 1.0 api_name: account_api_v1 api_type: REST api_group: sell/account_api_v1 source_url: html: https://developer.ebay.com/develop/api/sell/account_api_v1 md: https://developer.ebay.com/develop/api/sell/account_api_v1.md --- # Account API v1 API The **Account API v1** helps sellers configure and manage the core selling settings that power their eBay business. This API centralizes seller account configuration, including business policies (payment, fulfillment, and return), sales tax tables, custom compliance policies, and key account-level attributes like selling limits, subscriptions, and payments program status. **NOTE:** The Account API v1 is part of the Sell APIs and is intended for managing account-level configuration, not for creating or revising individual listings. Use it together with listing-focused APIs (such as Inventory or Trading/Listing APIs) to ensure that all listings consistently follow your centralized payment, shipping, return, and tax policies across eBay marketplaces. ## API Methods The following API methods are available: ### createCustomPolicy #### POST /custom_policy/ **Description:** This method creates a new custom policy that specifies the seller's terms for complying with local governmental regulations. Each Custom Policy targets a **policyType**. Multiple policies may be created as using the following custom policy types: * PRODUCT\_COMPLIANCE: Product Compliance policies disclose product information as required for regulatory compliance. **Note:** A maximum of 60 Product Compliance policies per seller may be created. * TAKE\_BACK: Takeback policies describe the seller's legal obligation to take back a previously purchased item when the buyer purchases a new one. **Note:** A maximum of 18 Takeback policies per seller may be created. A successful create policy call returns an HTTP status code of **201 Created** with the system-generated policy ID included in the Location response header. **Parameters:** - **Content-Type** (string) *required* - This header indicates the format of the request body provided by the client. Its value should be set to **application/json**. For more information, refer to [HTTP request headers](/api-docs/static/rest-request-components.html#HTTP). ### getCustomPolicies #### GET /custom_policy/ **Description:** This method retrieves the list of custom policies defined for a seller's account. To limit the returned custom policies, specify the **policy\_types** query parameter. **Parameters:** - **policy_types** (string) - This query parameter specifies the type of custom policies to be returned. Multiple policy types may be requested in a single call by providing a comma-delimited set of all policy types to be returned. **Note:** Omitting this query parameter from a request will also return policies of all policy types. See the [CustomPolicyTypeEnum](/develop/api/sell/account_api_v1#sell-account_api_v1-custom_policy-createcustompolicy.custompolicytypeenum) type for a list of supported values. ### getCustomPolicy #### GET /custom_policy/{custom_policy_id} **Description:** This method retrieves the custom policy specified by the **custom\_policy\_id** path parameter. **Parameters:** - **custom_policy_id** (string) *required* - This path parameter is the unique identifier of the custom policy to retrieve. This ID can be retrieved for a custom policy by using the [getCustomPolicies](/api-docs/sell/account/resources/custom_policy/methods/getCustomPolicies) method. ### updateCustomPolicy #### PUT /custom_policy/{custom_policy_id} **Description:** This method updates an existing custom policy specified by the **custom\_policy\_id** path parameter. Since this method overwrites the policy's **name**, **label**, and **description** fields, always include the complete and current text of all three policy fields in the request payload, even if they are not being updated. For example, the value for the **label** field is to be updated, but the **name** and **description** values will remain unchanged. The existing **name** and **description** values, as they are defined in the current policy, must also be passed in. A successful policy update call returns an HTTP status code of **204 No Content**. **Parameters:** - **custom_policy_id** (string) *required* - This path parameter is the unique identifier of the custom policy to update. **Note:** A list of custom policies defined for a seller's account that includes this ID can be retrieved by calling the [getCustomPolicies](/develop/api/sell/account_api_v1#sell-account_api_v1-custom_policy-getcustompolicies) method. - **Content-Type** (string) *required* - This header indicates the format of the request body provided by the client. Its value should be set to **application/json**. ### createFulfillmentPolicy #### POST /fulfillment_policy/ **Description:** This method creates a new fulfillment policy for an eBay marketplace where the policy encapsulates seller's terms for fulfilling item purchases. Fulfillment policies include the shipment options that the seller offers to buyers. A successful request returns the **getFulfillmentPolicy** URI to the new policy in the **Location** response header and the ID for the new policy is returned in the response payload. **Tip:** For details on creating and using the business policies supported by the Account API, see [eBay business policies](/api-docs/sell/static/seller-accounts/business-policies.html). **Parameters:** - **Content-Type** (string) *required* - This header indicates the format of the request body provided by the client. Its value should be set to **application/json**. ### deleteFulfillmentPolicy #### DELETE /fulfillment_policy/{fulfillmentPolicyId} **Description:** This method deletes a fulfillment policy. Supply the ID of the policy you want to delete in the **fulfillmentPolicyId** path parameter. **Parameters:** - **fulfillmentPolicyId** (string) *required* - This path parameter specifies the ID of the fulfillment policy to delete. This ID can be retrieved for a fulfillment policy by using the [getFulfillmentPolicies](/develop/api/sell/account_api_v1#sell-account_api_v1-fulfillment_policy-getfulfillmentpolicies) method. ### getFulfillmentPolicies #### GET /fulfillment_policy **Description:** This method retrieves all the fulfillment policies configured for the marketplace you specify using the `marketplace_id` query parameter. **Parameters:** - **Content-Language** (string) - Get the correct policies for a marketplace that supports multiple locales using the `Content-Language` request header. For example, get the policies for the French locale of the Canadian marketplace by specifying `fr-CA` for the `Content-Language` header. Likewise, target the Dutch locale of the Belgium marketplace by setting `Content-Language: nl-BE`. For details on header values, see [HTTP request headers](/api-docs/static/rest-request-components.html#HTTP). - **marketplace_id** (string) *required* - This query parameter specifies the eBay marketplace of the policies you want to retrieve. For implementation help, refer to eBay API documentation at https://developer.ebay.com/develop/api/sell/account\_api\_v1#sell-account\_api\_v1-fulfillment\_policy-getfulfillmentpolicies.marketplaceidenum ### getFulfillmentPolicy #### GET /fulfillment_policy/{fulfillmentPolicyId} **Description:** This method retrieves the complete details of a fulfillment policy. Supply the ID of the policy you want to retrieve using the **fulfillmentPolicyId** path parameter. **Parameters:** - **fulfillmentPolicyId** (string) *required* - This path parameter specifies the ID of the fulfillment policy you want to retrieve. This ID can be retrieved for a fulfillment policy by using the [getFulfillmentPolicies](/develop/api/sell/account_api_v1#sell-account_api_v1-fulfillment_policy-getfulfillmentpolicies) method. ### getFulfillmentPolicyByName #### GET /fulfillment_policy/get_by_policy_name **Description:** This method retrieves the details for a specific fulfillment policy. In the request, supply both the policy `name` and its associated `marketplace_id` as query parameters. **Parameters:** - **Content-Language** (string) - Get the correct policies for a marketplace that supports multiple locales using the `Content-Language` request header. For example, get the policies for the French locale of the Canadian marketplace by specifying `fr-CA` for the `Content-Language` header. Likewise, target the Dutch locale of the Belgium marketplace by setting `Content-Language: nl-BE`. For details on header values, see [HTTP request headers](/api-docs/static/rest-request-components.html#HTTP). - **marketplace_id** (string) *required* - This query parameter specifies the eBay marketplace of the policy you want to retrieve. For implementation help, refer to eBay API documentation at https://developer.ebay.com/develop/api/sell/account\_api\_v1#sell-account\_api\_v1-fulfillment\_policy-getfulfillmentpolicybyname.marketplaceidenum - **name** (string) *required* - This query parameter specifies the seller-defined name of the fulfillment policy you want to retrieve. This value can be retrieved for a fulfillment policy by using the [getFulfillmentPolicies](/develop/api/sell/account_api_v1#sell-account_api_v1-fulfillment_policy-getfulfillmentpolicies) method. ### updateFulfillmentPolicy #### PUT /fulfillment_policy/{fulfillmentPolicyId} **Description:** This method updates an existing fulfillment policy. Specify the policy you want to update using the **fulfillment\_policy\_id** path parameter. Supply a complete policy payload with the updates you want to make; this call overwrites the existing policy with the new details specified in the payload. **Parameters:** - **fulfillmentPolicyId** (string) *required* - This path parameter specifies the ID of the fulfillment policy you want to update. This ID can be retrieved for a specific fulfillment policy by using the [getFulfillmentPolicies](/develop/api/sell/account_api_v1#sell-account_api_v1-fulfillment_policy-getfulfillmentpolicies) method. - **Content-Type** (string) *required* - This header indicates the format of the request body provided by the client. Its value should be set to **application/json**. For more information, refer to [HTTP request headers](/api-docs/static/rest-request-components.html#HTTP). ### createPaymentPolicy #### POST /payment_policy **Description:** This method creates a new payment policy where the policy encapsulates seller's terms for order payments. A successful request returns the **getPaymentPolicy** URI to the new policy in the **Location** response header and the ID for the new policy is returned in the response payload. **Tip:** For details on creating and using the business policies supported by the Account API, see [eBay business policies](/api-docs/sell/static/seller-accounts/business-policies.html). **Parameters:** - **Content-Type** (string) *required* - This header indicates the format of the request body provided by the client. Its value should be set to **application/json**. For more information, refer to [HTTP request headers](/api-docs/static/rest-request-components.html#HTTP). ### deletePaymentPolicy #### DELETE /payment_policy/{payment_policy_id} **Description:** This method deletes a payment policy. Supply the ID of the policy you want to delete in the **paymentPolicyId** path parameter. **Parameters:** - **payment_policy_id** (string) *required* - This path parameter specifies the unique identifier of the payment policy you want to delete. This ID can be retrieved for a payment policy by using the [getPaymentPolices](/develop/api/sell/account_api_v1#sell-account_api_v1-payment_policy-getpaymentpolicies) method. ### getPaymentPolicies #### GET /payment_policy **Description:** This method retrieves all the payment business policies configured for the marketplace you specify using the `marketplace_id` query parameter. **Parameters:** - **marketplace_id** (string) *required* - This query parameter specifies the eBay marketplace of the policies you want to retrieve. For implementation help, refer to eBay API documentation at https://developer.ebay.com/develop/api/sell/account\_api\_v1#sell-account\_api\_v1-payment\_policy-getpaymentpolicies.marketplaceidenum - **Content-Language** (string) - Get the correct policies for a marketplace that supports multiple locales using the `Content-Language` request header. For example, get the policies for the French locale of the Canadian marketplace by specifying `fr-CA` for the `Content-Language` header. Likewise, target the Dutch locale of the Belgium marketplace by setting `Content-Language: nl-BE`. For details on header values, see [HTTP request headers](/api-docs/static/rest-request-components.html#HTTP). ### getPaymentPolicy #### GET /payment_policy/{payment_policy_id} **Description:** This method retrieves the complete details of a payment policy. Supply the ID of the policy you want to retrieve using the **paymentPolicyId** path parameter. **Parameters:** - **payment_policy_id** (string) *required* - This path parameter specifies the ID of the payment policy you want to retrieve. This ID can be retrieved for a payment policy by using the [getPaymentPolices](/develop/api/sell/account_api_v1#sell-account_api_v1-payment_policy-getpaymentpolicies) method. ### getPaymentPolicyByName #### GET /payment_policy/get_by_policy_name **Description:** This method retrieves the details of a specific payment policy. Supply both the policy `name` and its associated `marketplace_id` in the request query parameters. **Parameters:** - **Content-Language** (string) - Get the correct policy for a marketplace that supports multiple locales using the `Content-Language` request header. For example, get a policy for the French locale of the Canadian marketplace by specifying `fr-CA` for the `Content-Language` header. Likewise, target the Dutch locale of the Belgium marketplace by setting `Content-Language: nl-BE`. For details on header values, see [HTTP request headers](/api-docs/static/rest-request-components.html#HTTP). - **marketplace_id** (string) *required* - This query parameter specifies the eBay marketplace of the policy you want to retrieve. For implementation help, refer to eBay API documentation at https://developer.ebay.com/develop/api/sell/account\_api\_v1#sell-account\_api\_v1-payment\_policy-getpaymentpolicies.marketplaceidenum - **name** (string) *required* - This query parameter specifies the seller-defined name of the payment policy you want to retrieve. This value can be retrieved for a payment policy by using the [getPaymentPolicies](/develop/api/sell/account_api_v1#sell-account_api_v1-payment_policy-getpaymentpolicies) method. ### updatePaymentPolicy #### PUT /payment_policy/{payment_policy_id} **Description:** This method updates an existing payment policy. Specify the policy you want to update using the **payment\_policy\_id** path parameter. Supply a complete policy payload with the updates you want to make; this call overwrites the existing policy with the new details specified in the payload. **Parameters:** - **payment_policy_id** (string) *required* - This path parameter specifies the ID of the payment policy you want to update. This ID can be retrieved for a payment policy by using the [getPaymentPolices](/develop/api/sell/account_api_v1#sell-account_api_v1-payment_policy-getpaymentpolicies) method. - **Content-Type** (string) *required* - This header indicates the format of the request body provided by the client. Its value should be set to **application/json**. For more information, refer to [HTTP request headers](/api-docs/static/rest-request-components.html#HTTP). ### getPaymentsProgram #### GET /payments_program/{marketplace_id}/{payments_program_type} **Description:** **Note:** This method is no longer applicable, as all seller accounts globally have been enabled for the new eBay payment and checkout flow. This method returns whether or not the user is opted-in to the specified payments program. Sellers opt-in to payments programs by marketplace and you use the **marketplace\_id** path parameter to specify the marketplace of the status flag you want returned. **Parameters:** - **marketplace_id** (string) *required* - This path parameter specifies the eBay marketplace of the payments program for which you want to retrieve the seller's status. - **payments_program_type** (string) *required* - This path parameter specifies the payments program whose status is returned by the call. ### getPaymentsProgramOnboarding #### GET /payments_program/{marketplace_id}/{payments_program_type}/onboarding **Description:** **Note:** This method is no longer applicable, as all seller accounts globally have been enabled for the new eBay payment and checkout flow. This method retrieves a seller's onboarding status for a payments program for a specified marketplace. The overall onboarding status of the seller and the status of each onboarding step is returned. **Parameters:** - **marketplace_id** (string) *required* - The eBay marketplace ID associated with the onboarding status to retrieve. - **payments_program_type** (string) *required* - The type of payments program whose status is returned by the method. ### getPrivileges #### GET /privilege **Description:** This method retrieves the seller's current set of privileges, including whether or not the seller's eBay registration has been completed, as well as the details of their site-wide **sellingLimit** (the amount and quantity they can sell on a given day). ### getOptedInPrograms #### GET /program/get_opted_in_programs **Description:** This method gets a list of the seller programs that the seller has opted-in to. ### optInToProgram #### POST /program/opt_in **Description:** This method opts the seller in to an eBay seller program. Refer to the [ProgramTypeEnum](/develop/api/sell/account_api_v1#sell-account_api_v1-program-optintoprogram.programtypeenum) for information about available eBay seller programs. **Note:** It can take up to 24-hours for eBay to process your request to opt-in to a Seller Program. Use the [getOptedInPrograms](/develop/api/sell/account_api_v1#sell-account_api_v1-program-getoptedinprograms) call to check the status of your request after the processing period has passed. **Parameters:** - **Content-Type** (string) *required* - This header indicates the format of the request body provided by the client. Its value should be set to **application/json**. For more information, refer to [HTTP request headers](/api-docs/static/rest-request-components.html#HTTP). ### optOutOfProgram #### POST /program/opt_out **Description:** This method opts the seller out of a seller program in which they are currently opted in to. A seller can retrieve a list of the seller programs they are opted-in to using the **getOptedInPrograms** method. **Parameters:** - **Content-Type** (string) *required* - This header indicates the format of the request body provided by the client. Its value should be set to **application/json**. For more information, refer to [HTTP request headers](/api-docs/static/rest-request-components.html#HTTP). ### getRateTables #### GET /rate_table **Description:** This method retrieves a seller's _shipping rate tables_ for the country specified in the **country\_code** query parameter. If you call this method without specifying a country code, the call returns all of the seller's shipping rate tables. The method's response includes a **rateTableId** for each table defined by the seller. This **rateTableId** value is used in add/revise item call or in create/update fulfillment business policy call to specify the shipping rate table to use for that policy's domestic or international shipping options. This call currently supports getting rate tables related to the following marketplaces: United States, Canada, United Kingdom, Germany, Australia, France, Italy, and Spain. **Note:** Rate tables created with the Trading API might not have been assigned a **rateTableId** at the time of their creation. This method can assign and return **rateTableId** values for rate tables with missing IDs if you make a request using the **country\_code** where the seller has defined rate tables. Sellers can define up to 40 shipping rate tables for their account, which lets them set up different rate tables for each of the marketplaces they sell into. Go to [Shipping rate tables]() in **My eBay** to create and update rate tables. **Parameters:** - **country_code** (string) - This query parameter specifies the two-letter [ISO 3166]( "https://www.iso.org ") code of country for which you want shipping rate table information. If you do not specify a country code, the request returns all of the seller's defined shipping rate tables for all eBay marketplaces. For implementation help, refer to eBay API documentation at https://developer.ebay.com/develop/api/sell/account\_api\_v1#sell-account\_api\_v1-rate\_table-getratetables.countrycodeenum ### createReturnPolicy #### POST /return_policy **Description:** This method creates a new return policy where the policy encapsulates seller's terms for returning items. Each policy targets a specific marketplace, and you can create multiple policies for each marketplace. Return policies are not applicable to motor-vehicle listings. A successful request returns the **getReturnPolicy** URI to the new policy in the **Location** response header and the ID for the new policy is returned in the response payload. **Tip:** For details on creating and using the business policies supported by the Account API, see [eBay business policies](/api-docs/sell/static/seller-accounts/business-policies.html). **Parameters:** - **Content-Type** (string) *required* - This header indicates the format of the request body provided by the client. Its value should be set to **application/json**. For more information, refer to [HTTP request headers](/api-docs/static/rest-request-components.html#HTTP). ### deleteReturnPolicy #### DELETE /return_policy/{return_policy_id} **Description:** This method deletes a return policy. Supply the ID of the policy you want to delete in the **returnPolicyId** path parameter. **Parameters:** - **return_policy_id** (string) *required* - This path parameter specifies the unique identifier of the return policy you want to delete. This ID can be retrieved for a return policy by using the [getReturnPolicies](/develop/api/sell/account_api_v1#sell-account_api_v1-return_policy-getreturnpolicies) method. ### getReturnPolicies #### GET /return_policy **Description:** This method retrieves all the return policies configured for the marketplace you specify using the `marketplace_id` query parameter. **Parameters:** - **Content-Language** (string) - Get the correct policies for a marketplace that supports multiple locales using the `Content-Language` request header. For example, get the policies for the French locale of the Canadian marketplace by specifying `fr-CA` for the `Content-Language` header. Likewise, target the Dutch locale of the Belgium marketplace by setting `Content-Language: nl-BE`. For details on header values, see [HTTP request headers](/api-docs/static/rest-request-components.html#HTTP). - **marketplace_id** (string) *required* - This query parameter specifies the ID of the eBay marketplace of the policies you want to retrieve. For implementation help, refer to eBay API documentation at https://developer.ebay.com/develop/api/sell/account\_api\_v1#sell-account\_api\_v1-payment\_policy-getpaymentpolicies.marketplaceidenum ### getReturnPolicy #### GET /return_policy/{return_policy_id} **Description:** This method retrieves the complete details of the return policy specified by the **returnPolicyId** path parameter. **Parameters:** - **return_policy_id** (string) *required* - This path parameter specifies the unique identifier of the return policy you want to retrieve. This ID can be retrieved for a return policy by using the [getReturnPolicies](/develop/api/sell/account_api_v1#sell-account_api_v1-return_policy-getreturnpolicies) method. ### getReturnPolicyByName #### GET /return_policy/get_by_policy_name **Description:** This method retrieves the details of a specific return policy. Supply both the policy `name` and its associated `marketplace_id` in the request query parameters. **Parameters:** - **Content-Language** (string) - Get the correct policy for a marketplace that supports multiple locales using the `Content-Language` request header. For example, get a policy for the French locale of the Canadian marketplace by specifying `fr-CA` for the `Content-Language` header. Likewise, target the Dutch locale of the Belgium marketplace by setting `Content-Language: nl-BE`. For details on header values, see [HTTP request headers](/api-docs/static/rest-request-components.html#HTTP). - **marketplace_id** (string) *required* - This query parameter specifies the ID of the eBay marketplace of the policy you want to retrieve. For implementation help, refer to eBay API documentation at https://developer.ebay.com/develop/api/sell/account\_api\_v1#sell-account\_api\_v1-payment\_policy-getpaymentpolicies.marketplaceidenum - **name** (string) *required* - This query parameter specifies the seller-defined name of the return policy you want to retrieve. This value can be retrieved for a return policy by using the [getReturnPolicies](/develop/api/sell/account_api_v1#sell-account_api_v1-return_policy-getreturnpolicies) method. ### updateReturnPolicy #### PUT /return_policy/{return_policy_id} **Description:** This method updates an existing return policy. Specify the policy you want to update using the **return\_policy\_id** path parameter. Supply a complete policy payload with the updates you want to make; this call overwrites the existing policy with the new details specified in the payload. **Parameters:** - **return_policy_id** (string) *required* - This path parameter specifies the ID of the return policy you want to update. This ID can be retrieved for a return policy by using the [getReturnPolicies](/develop/api/sell/account_api_v1#sell-account_api_v1-return_policy-getreturnpolicies) method. - **Content-Type** (string) *required* - This header indicates the format of the request body provided by the client. Its value should be set to **application/json**. For more information, refer to [HTTP request headers](/api-docs/static/rest-request-components.html#HTTP). ### bulkCreateOrReplaceSalesTax #### POST /bulk_create_or_replace_sales_tax **Description:** This method creates or updates multiple sales-tax table entries. _Sales-tax tables_ can be set up for countries that support different _tax jurisdictions_. **Note:** Sales-tax tables are only available for the US (EBAY\_US) and Canada (EBAY\_CA) marketplaces. Each sales-tax table entry comprises the following parameters: * `countryCode` * `jurisdictionId` * `salesTaxPercentage` * `shippingAndHandlingTaxed` Valid jurisdiction IDs are retrieved using **[getSalesTaxJurisdictions](/develop/api/sell/metadata_api#sell-metadata_api-country-getsalestaxjurisdictions)** in the Metadata API. For details about using this call, refer to [Establishing sales-tax tables](/api-docs/sell/static/seller-accounts/tax-tables.html). **Important!** In the US, eBay now calculates, collects, and remits sales tax to the proper taxing authorities in all 50 states and Washington, DC. Sellers can no longer specify sales-tax rates for these jurisdictions using a tax table. However, sellers may continue to use a sales-tax table to set rates for the following US territories: * American Samoa (AS) * Guam (GU) * Northern Mariana Islands (MP) * Palau (PW) * US Virgin Islands (VI) For additional information, refer to [Taxes and import charges](). ### createOrReplaceSalesTax #### PUT /sales_tax/{countryCode}/{jurisdictionId} **Description:** This method creates or updates a sales-tax table entry for a jurisdiction. Specify the tax table entry you want to configure using the two path parameters: **countryCode** and **jurisdictionId**. A tax table entry for a jurisdiction is comprised of two fields: one for the jurisdiction's sales-tax rate and another that's a boolean value indicating whether or not shipping and handling are taxed in the jurisdiction. You can set up _sales-tax tables_ for countries that support different _tax jurisdictions_. **Note:** Sales-tax tables are only available for the US (EBAY\_US) and Canada (EBAY\_CA) marketplaces. Retrieve valid jurisdiction IDs using **[getSalesTaxJurisdictions](/develop/api/sell/metadata_api#sell-metadata_api-country-getsalestaxjurisdictions)** in the Metadata API. For details about using this call, refer to [Establishing sales-tax tables](/api-docs/sell/static/seller-accounts/tax-tables.html). **Important!** In the US, eBay now calculates, collects, and remits sales tax to the proper taxing authorities in all 50 states and Washington, DC. Sellers can no longer specify sales-tax rates for these jurisdictions using a tax table. However, sellers may continue to use a sales-tax table to set rates for the following US territories: * American Samoa (AS) * Guam (GU) * Northern Mariana Islands (MP) * Palau (PW) * US Virgin Islands (VI) For additional information, refer to [Taxes and import charges](). **Parameters:** - **countryCode** (string) *required* - This path parameter specifies the two-letter [ISO 3166]( "https://www.iso.org ") code for the country for which you want to create a sales tax table entry. **Note:** Sales-tax tables are available only for the US and Canada marketplaces. Therefore, the only supported values are: * `US` * `CA` - **jurisdictionId** (string) *required* - This path parameter specifies the ID of the tax jurisdiction for the table entry to be created. Valid jurisdiction IDs can be retrieved using the [getSalesTaxJurisdiction](/develop/api/sell/metadata_api#sell-metadata_api-country-getsalestaxjurisdictions) method of the Metadata API. **Note:** When `countryCode` is set to `US`, the only supported values for `jurisdictionId` are: * `AS` (American Samoa) * `GU` (Guam) * `MP` (Northern Mariana Islands) * `PW` (Palau) * `VI` (US Virgin Islands) - **Content-Type** (string) *required* - This header indicates the format of the request body provided by the client. Its value should be set to **application/json**. For more information, refer to [HTTP request headers](/api-docs/static/rest-request-components.html#HTTP). ### deleteSalesTax #### DELETE /sales_tax/{countryCode}/{jurisdictionId} **Description:** This call deletes a sales-tax table entry for a jurisdiction. Specify the jurisdiction to delete using the **countryCode** and **jurisdictionId** path parameters. **Note:** Sales-tax tables are only available for the US (EBAY\_US) and Canada (EBAY\_CA) marketplaces. **Parameters:** - **countryCode** (string) *required* - This path parameter specifies the two-letter [ISO 3166]( "https://www.iso.org ") code for the country whose sales tax table entry you want to delete. **Note:** Sales-tax tables are available only for the US and Canada marketplaces. Therefore, the only supported values are: * `US` * `CA` - **jurisdictionId** (string) *required* - This path parameter specifies the ID of the sales tax jurisdiction whose table entry you want to delete. Valid jurisdiction IDs can be retrieved using the [getSalesTaxJurisdiction](/develop/api/sell/metadata_api#sell-metadata_api-country-getsalestaxjurisdictions) method of the Metadata API. **Note:** When `countryCode` is set to `US`, the only supported values for `jurisdictionId` are: * `AS` (American Samoa) * `GU` (Guam) * `MP` (Northern Mariana Islands) * `PW` (Palau) * `VI` (US Virgin Islands) ### getSalesTax #### GET /sales_tax/{countryCode}/{jurisdictionId} **Description:** This call retrieves the current sales-tax table entry for a specific tax jurisdiction. Specify the jurisdiction to retrieve using the **countryCode** and **jurisdictionId** path parameters. All four response fields will be returned if a sales-tax entry exists for the tax jurisdiction. Otherwise, the response will be returned as empty. **Note:** Sales-tax tables are only available for the US (EBAY\_US) and Canada (EBAY\_CA) marketplaces. **Important!** In the US, eBay now calculates, collects, and remits sales tax to the proper taxing authorities in all 50 states and Washington, DC. Sellers can no longer specify sales-tax rates for these jurisdictions using a tax table. However, sellers may continue to use a sales-tax table to set rates for the following US territories: * American Samoa (AS) * Guam (GU) * Northern Mariana Islands (MP) * Palau (PW) * US Virgin Islands (VI) For additional information, refer to [Taxes and import charges](). **Parameters:** - **countryCode** (string) *required* - This path parameter specifies the two-letter [ISO 3166]( "https://www.iso.org ") code for the country whose sales tax table you want to retrieve. **Note:** Sales-tax tables are available only for the US and Canada marketplaces. Therefore, the only supported values are: * `US` * `CA` - **jurisdictionId** (string) *required* - This path parameter specifies the ID of the sales tax jurisdiction for the tax table entry to be retrieved. Valid jurisdiction IDs can be retrieved using the [getSalesTaxJurisdiction](/develop/api/sell/metadata_api#sell-metadata_api-country-getsalestaxjurisdictions) method of the Metadata API. **Note:** When `countryCode` is set to `US`, the only supported values for `jurisdictionId` are: * `AS` (American Samoa) * `GU` (Guam * `MP` Northern Mariana Islands * `PW (Palau)` * `` `VI` (US Virgin Islands) `` ### getSalesTaxes #### GET /sales_tax **Description:** Use this call to retrieve all sales tax table entries that the seller has defined for a specific country. All four response fields will be returned for each tax jurisdiction that matches the search criteria. If no sales tax rates are defined for the specified, a `204 No Content` status code is returned with no response payload. **Note:** Sales-tax tables are only available for the US (EBAY\_US) and Canada (EBAY\_CA) marketplaces. **Important!** In the US, eBay now calculates, collects, and remits sales tax to the proper taxing authorities in all 50 states and Washington, DC. Sellers can no longer specify sales-tax rates for these jurisdictions using a tax table. However, sellers may continue to use a sales-tax table to set rates for the following US territories: * American Samoa (AS) * Guam (GU) * Northern Mariana Islands (MP) * Palau (PW) * US Virgin Islands (VI) For additional information, refer to [Taxes and import charges](). **Parameters:** - **country_code** (string) *required* - This path parameter specifies the two-letter [ISO 3166]( "https://www.iso.org ") code for the country whose tax table you want to retrieve. **Note:** Sales-tax tables are available only for the US and Canada marketplaces. Therefore, the only supported values are: * `US` * `CA` For implementation help, refer to eBay API documentation at https://developer.ebay.com/api-docs/sell/account/types/ba:CountryCodeEnum ### getSubscription #### GET /subscription **Description:** This method retrieves a list of subscriptions associated with the seller account. **Parameters:** - **limit** (string) - This field is for future use. - **continuation_token** (string) - This field is for future use. ### getKYC #### GET /kyc **Description:** **Note:** This method was originally created to see which onboarding requirements were still pending for sellers being onboarded for eBay managed payments, but now that all seller accounts are onboarded globally, this method should now just return an empty payload with a `204 No Content` HTTP status code. ### getAdvertisingEligibility #### GET /advertising_eligibility **Description:** This method allows developers to check the seller eligibility status for eBay advertising programs. **Parameters:** - **program_types** (string) - A comma-separated list of eBay advertising programs for which eligibility status will be returned. See the [AdvertisingProgramEnum](/develop/api/sell/account_api_v1#sell-account_api_v1-advertising_eligibility-getadvertisingeligibility.advertisingprogramenum) type for a list of supported values. If no programs are specified, the results will be returned for all programs. - **X-EBAY-C-MARKETPLACE-ID** (string) *required* - The unique identifier of the eBay marketplace for which the seller eligibility status shall be checked. This header is required or the call will fail. See the [MarketplaceIdEnum](https://edp.qa.ebay.com/develop/guides-v2/using-ebay-restful-apis#marketpl) type for the supported marketplace ID values. ## Error Codes The following error codes may be returned by this API: ### REQUEST Errors #### 20411 - API_ACCOUNT **Description:** Invalid/Missing policyType {policyType} #### 20412 - API_ACCOUNT **Description:** Invalid/Missing label #### 20413 - API_ACCOUNT **Description:** Invalid/Missing name #### 20414 - API_ACCOUNT **Description:** Invalid/Missing description #### 20415 - API_ACCOUNT **Description:** Invalid/Missing marketplaceId #### 20417 - API_ACCOUNT **Description:** Maximum custom policy per site is reached #### 20418 - API_ACCOUNT **Description:** This policy name is already used #### 20416 - API_ACCOUNT **Description:** Invalid/Missing customPolicyId #### 20400 - API_ACCOUNT **Description:** Invalid request. {additionalInfo} #### 20401 - API_ACCOUNT **Description:** Missing field {fieldName}. {additionalInfo} #### 20402 - API_ACCOUNT **Description:** Invalid input. {additionalInfo} #### 20403 - API_ACCOUNT **Description:** Invalid {fieldName}. {additionalInfo} #### 20404 - API_ACCOUNT **Description:** {fieldName} not found. #### 20405 - API_ACCOUNT **Description:** Invalid payment method. {fieldName} #### 20408 - API_ACCOUNT **Description:** No payment program available. The user may not be registered to the specified site or the site may not be supported by the payments program. #### 25804 - API_ACCOUNT **Description:** {fieldName} already exists #### 20406 - API_ACCOUNT **Description:** Invalid return option #### 20407 - API_ACCOUNT **Description:** Tax table not supported for {fieldName}. #### 21400 - API_ACCOUNT **Description:** This marketplace is not supported. Please refer to documentation. #### 50114 - API_ACCOUNT **Description:** The HTTP request header 'X-EBAY-C-MARKETPLACE-ID' is required. #### 50116 - API_ACCOUNT **Description:** Invalid program\_type(s) {programTypes}. #### 50117 - API_ACCOUNT **Description:** Invalid marketplaceId in HTTP request header 'X-EBAY-C-MARKETPLACE-ID' {marketplaceId}. ### APPLICATION Errors #### 20500 - API_ACCOUNT **Description:** System error. #### 20501 - API_ACCOUNT **Description:** Service unavailable. Please try again in next 24 hours. #### 35001 - API_ACCOUNT **Description:** There was a problem with an eBay internal system or process. Contact eBay developer support for assistance. #### 35002 - API_ACCOUNT **Description:** Internal error. Please wait a few minutes and try the call again. ### BUSINESS Errors #### 20409 - API_ACCOUNT **Description:** Invalid default policy type. {additionalInfo} #### 21409 - API_ACCOUNT **Description:** Invalid default for category type. {additionalInfo} #### 22409 - API_ACCOUNT **Description:** Invalid target default policy. {additionalInfo} #### 25803 - API_ACCOUNT **Description:** {fieldName} already exists. ## Rate Limits See [API Call Limits](https://developer.ebay.com/develop/get-started/api-call-limits) on the eBay Developer Program. ## Resources ### Documentation - [eBay Developer Program](https://developer.ebay.com/) - [API Documentation](https://developer.ebay.com/develop/api/) - [SDKs and Widgets](https://developer.ebay.com/develop/sdks-and-widgets) - [Developer Community Forum](https://community.ebay.com/t5/Developer-Groups/ct-p/developergroup) ### Tools - [API Explorer](https://developer.ebay.com/my/api_test_tool) - [GraphQL Explorer](https://developer.ebay.com/my/graphql_explorer) ### Support - [Developer Support](https://developer.ebay.com/support/) - [API Status](https://developer.ebay.com/support/api-status) - [Release Notes](https://developer.ebay.com/develop/api/release_notes/) --- *Generated on 2026-07-08T04:34:30.747Z*