eBay Fulfillment_policy API

The Fulfillment_policy API from eBay — 4 operation(s) for fulfillment_policy.

Operations 6

POST /fulfillment_policy/ #
GET /fulfillment_policy/{fulfillmentPolicyId} #
PUT /fulfillment_policy/{fulfillmentPolicyId} #
DELETE /fulfillment_policy/{fulfillmentPolicyId} #
GET /fulfillment_policy #
GET /fulfillment_policy/get_by_policy_name #

Documentation

📖
Documentation
https://developer.ebay.com/api-docs/sell/account/static/overview.html
📖
Documentation
https://developer.ebay.com/api-docs/sell/analytics/static/overview.html
📖
Documentation
https://developer.ebay.com/api-docs/sell/compliance/resources/methods
📖
Documentation
https://developer.ebay.com/api-docs/sell/feed/resources/methods
📖
Documentation
https://developer.ebay.com/api-docs/buy/browse/overview.html
📖
Documentation
https://developer.ebay.com/api-docs/buy/deal/resources/methods
📖
Documentation
https://developer.ebay.com/api-docs/buy/marketing/resources/methods
📖
Documentation
https://developer.ebay.com/api-docs/buy/marketplace-insights/resources/methods
📖
Documentation
https://developer.ebay.com/api-docs/buy/offer/overview.html
📖
Documentation
https://developer.ebay.com/api-docs/buy/order/overview.html
📖
Documentation
https://developer.ebay.com/api-docs/sell/finances/overview.html
📖
Documentation
https://developer.ebay.com/api-docs/sell/fulfillment/overview.html
📖
Documentation
https://developer.ebay.com/api-docs/sell/inventory/overview.html
📖
Documentation
https://developer.ebay.com/api-docs/sell/logistics/overview.html
📖
Documentation
https://developer.ebay.com/api-docs/sell/metadata/overview.html
📖
Documentation
https://developer.ebay.com/api-docs/sell/negotiation/overview.html
📖
Documentation
https://developer.ebay.com/api-docs/sell/recommendation/overview.html
📖
Documentation
https://developer.ebay.com/api-docs/sell/stores/overview.html
📖
Documentation
https://developer.ebay.com/api-docs/commerce/catalog/resources/methods
📖
Documentation
https://developer.ebay.com/api-docs/commerce/charity/overview.html
📖
Documentation
https://developer.ebay.com/api-docs/commerce/identity/overview.html
📖
Documentation
https://developer.ebay.com/api-docs/commerce/media/overview.html
📖
Documentation
https://developer.ebay.com/api-docs/commerce/notification/overview.html
📖
Documentation
https://developer.ebay.com/api-docs/commerce/taxonomy/overview.html
📖
Documentation
https://developer.ebay.com/api-docs/commerce/translation/overview.html
📖
Documentation
https://developer.ebay.com/api-docs/developer/client-registration/overview.html
📖
Documentation
https://developer.ebay.com/api-docs/developer/key-management/overview.html

Specifications

Other Resources

🔗
ReleaseNotes
https://developer.ebay.com/api-docs/buy/browse/release-notes.html
🔗
ReleaseNotes
https://developer.ebay.com/api-docs/buy/deal/release-notes.html
🔗
ReleaseNotes
https://developer.ebay.com/api-docs/buy/marketing/release-notes.html
🔗
ReleaseNotes
https://developer.ebay.com/api-docs/buy/marketplace-insights/release-notes.html
🔗
ReleaseNotes
https://developer.ebay.com/api-docs/buy/offer/release-notes.html
🔗
ReleaseNotes
https://developer.ebay.com/api-docs/buy/order/release-notes.html
🔗
ReleaseNotes
https://developer.ebay.com/api-docs/sell/finances/release-notes.html
🔗
ReleaseNotes
https://developer.ebay.com/api-docs/sell/fulfillment/release-notes.html
🔗
ReleaseNotes
https://developer.ebay.com/api-docs/sell/inventory/release-notes.html
🔗
ReleaseNotes
https://developer.ebay.com/api-docs/sell/logistics/release-notes.html
🔗
ReleaseNotes
https://developer.ebay.com/api-docs/sell/metadata/release-notes.html
🔗
ReleaseNotes
https://developer.ebay.com/api-docs/sell/negotiation/release-notes.html
🔗
ReleaseNotes
https://developer.ebay.com/api-docs/sell/recommendation/release-notes.html
🔗
ReleaseNotes
https://developer.ebay.com/api-docs/sell/stores/release-notes.html
🔗
ReleaseNotes
https://developer.ebay.com/api-docs/commerce/catalog/release-notes.html
🔗
ReleaseNotes
https://developer.ebay.com/api-docs/commerce/charity/release-notes.html
🔗
ReleaseNotes
https://developer.ebay.com/api-docs/commerce/identity/release-notes.html
🔗
ReleaseNotes
https://developer.ebay.com/api-docs/commerce/media/release-notes.html
🔗
ReleaseNotes
https://developer.ebay.com/api-docs/commerce/notification/release-notes.html
🔗
ReleaseNotes
https://developer.ebay.com/api-docs/commerce/taxonomy/release-notes.html
🔗
ReleaseNotes
https://developer.ebay.com/api-docs/commerce/translation/release-notes.html
🔗
ReleaseNotes
https://developer.ebay.com/api-docs/developer/client-registration/release-notes.html
🔗
ReleaseNotes
https://developer.ebay.com/api-docs/developer/key-management/release-notes.html

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/ebay-fulfillment-policy-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

ebay-fulfillment-policy-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: eBay Account Fulfillment Policy API
  description: The <b>Account API</b> gives sellers the ability to configure their eBay seller accounts, including the seller's policies (eBay business policies and seller-defined custom policies), opt in and out of eBay seller programs, configure sales tax tables, and get account information.  <br><br>For details on the availability of the methods in this API, see <a href="/api-docs/sell/account/overview.html#requirements">Account API requirements and restrictions</a>.
  contact:
    name: eBay Inc,
  license:
    name: eBay API License Agreement
    url: https://go.developer.ebay.com/api-license-agreement
  version: v1.9.2
servers:
- url: https://api.ebay.com{basePath}
  description: Production
  variables:
    basePath:
      default: /sell/account/v1
tags:
- name: Fulfillment_policy
paths:
  /fulfillment_policy/:
    post:
      tags:
      - Fulfillment_policy
      description: 'This method creates a new fulfillment policy where the policy encapsulates seller''s terms for fulfilling item purchases. Fulfillment policies include the shipment options that the seller offers to buyers.  <br><br>Each policy targets a specific eBay marketplace and a category group type, and you can create multiple policies for each combination. <br><br>A successful request returns the <b>getFulfillmentPolicy</b> URI to the new policy in the <b>Location</b> response header and the ID for the new policy is returned in the response payload.  <p class="tablenote"><b>Tip:</b> For details on creating and using the business policies supported by the Account API, see <a href="/api-docs/sell/static/seller-accounts/business-policies.html">eBay business policies</a>.</p>  <p><b>Using the eBay standard envelope service (eSE)</b></p><p>The eBay standard envelope service (eSE) is a domestic envelope service with tracking through eBay. This service applies to specific sub-categories of <b>Trading Cards</b>, and to coins & paper money, postcards, stamps, patches, and similar <a href="https://www.ebay.com/sellercenter/shipping/choosing-a-carrier-and-service/ebay-standard-envelope#eligible-categories" target="_blank ">eligible categories</a>, and is only available on the US marketplace. To use this service, send envelopes using the USPS mail and set the <b>shippingServiceCode</b> field to <code>US_eBayStandardEnvelope</code>. See <a href="/api-docs/sell/static/seller-accounts/using-the-ebay-standard-envelope-service.html" target="_blank">Using eBay standard envelope (eSE) service</a> for details. See <a href="https://pages.ebay.com/seller-center/shipping/ebay-standard-envelope.html#lower-cost-way" target="_blank ">eBay standard envelope</a> for additional details, restrictions, and an <a href="https://ir.ebaystatic.com/pictures/sc/Shipping/ebay_standard_envelope_template.pdf" target="_blank ">envelope size template</a>. '
      operationId: createFulfillmentPolicy
      parameters:
      - name: Content-Type
        in: header
        description: This header indicates the format of the request body provided by the client. Its value should be set to <b>application/json</b>. <br><br> For more information, refer to <a href="/api-docs/static/rest-request-components.html#HTTP" target="_blank ">HTTP request headers</a>.
        required: true
        schema:
          type: string
      requestBody:
        description: Request to create a seller account fulfillment policy.
        content:
          application/json:
            schema:
              description: Request to create a seller account fulfillment policy.
              $ref: '#/components/schemas/FulfillmentPolicyRequest'
        required: true
      responses:
        '201':
          description: Created
          headers:
            Location:
              schema:
                type: string
                description: The <b>location</b> response header contains the URL to the newly created fulfillment policy. The URL includes the eBay-assigned <code>fulfillmentPolicyId</code>, which you can use to reference the policy.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SetFulfillmentPolicyResponse'
          x-response-codes:
            errors:
              '20200':
                domain: API_ACCOUNT
                category: BUSINESS
                description: Warning. {additionalInfo}
              '20201':
                domain: API_ACCOUNT
                category: BUSINESS
                description: '{fieldName} (Click and Collect Program) can not be enabled for this seller or marketplace.'
        '400':
          description: Bad Request
          x-response-codes:
            errors:
              '20400':
                domain: API_ACCOUNT
                category: REQUEST
                description: Invalid request. {additionalInfo}
              '20401':
                domain: API_ACCOUNT
                category: REQUEST
                description: Missing field {fieldName}. {additionalInfo}
              '20402':
                domain: API_ACCOUNT
                category: REQUEST
                description: Invalid input. {additionalInfo}
              '20403':
                domain: API_ACCOUNT
                category: REQUEST
                description: Invalid {fieldName}. {additionalInfo}
        '500':
          description: Internal Server Error
          x-response-codes:
            errors:
              '20500':
                domain: API_ACCOUNT
                category: APPLICATION
                description: System error.
              '20501':
                domain: API_ACCOUNT
                category: APPLICATION
                description: Service unavailable. Please try again in next 24 hours.
      security:
      - api_auth:
        - https://api.ebay.com/oauth/api_scope/sell.account
  /fulfillment_policy/{fulfillmentPolicyId}:
    get:
      tags:
      - Fulfillment_policy
      description: This method retrieves the complete details of a fulfillment policy. Supply the ID of the policy you want to retrieve using the <b>fulfillmentPolicyId</b> path parameter.
      operationId: getFulfillmentPolicy
      parameters:
      - name: fulfillmentPolicyId
        in: path
        description: This path parameter specifies the ID of the fulfillment policy you want to retrieve.<br><br> This ID can be retrieved for a fulfillment policy by using the <a href="/api-docs/sell/account/resources/fulfillment_policy/methods/getFulfillmentPolicies" target="_blank ">getFulfillmentPolicies</a> method.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FulfillmentPolicy'
        '400':
          description: Bad Request
          x-response-codes:
            errors:
              '20403':
                domain: API_ACCOUNT
                category: REQUEST
                description: Invalid {fieldName}. {additionalInfo}
              '20404':
                domain: API_ACCOUNT
                category: REQUEST
                description: '{fieldName} not found.'
        '404':
          description: Not Found
        '500':
          description: Internal Server Error
          x-response-codes:
            errors:
              '20500':
                domain: API_ACCOUNT
                category: APPLICATION
                description: System error.
              '20501':
                domain: API_ACCOUNT
                category: APPLICATION
                description: Service unavailable. Please try again in next 24 hours.
      security:
      - api_auth:
        - https://api.ebay.com/oauth/api_scope/sell.account
        - https://api.ebay.com/oauth/api_scope/sell.account.readonly
    put:
      tags:
      - Fulfillment_policy
      description: This method updates an existing fulfillment policy. Specify the policy you want to update using the <b>fulfillment_policy_id</b> 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.
      operationId: updateFulfillmentPolicy
      parameters:
      - name: fulfillmentPolicyId
        in: path
        description: This path parameter specifies the ID of the fulfillment policy you want to update.<br><br>This ID can be retrieved for a specific fulfillment policy by using the <a href="/api-docs/sell/account/resources/fulfillment_policy/methods/getFulfillmentPolicies" target="_blank ">getFulfillmentPolicies</a> method.
        required: true
        schema:
          type: string
      - name: Content-Type
        in: header
        description: This header indicates the format of the request body provided by the client. Its value should be set to <b>application/json</b>. <br><br> For more information, refer to <a href="/api-docs/static/rest-request-components.html#HTTP" target="_blank ">HTTP request headers</a>.
        required: true
        schema:
          type: string
      requestBody:
        description: Fulfillment policy request
        content:
          application/json:
            schema:
              description: Fulfillment policy request
              $ref: '#/components/schemas/FulfillmentPolicyRequest'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SetFulfillmentPolicyResponse'
          x-response-codes:
            errors:
              '20200':
                domain: API_ACCOUNT
                category: BUSINESS
                description: Warning. {additionalInfo}
              '20201':
                domain: API_ACCOUNT
                category: BUSINESS
                description: '{fieldName} (Click and Collect Program) can not be enabled for this seller or marketplace.'
        '400':
          description: Bad Request
          x-response-codes:
            errors:
              '20400':
                domain: API_ACCOUNT
                category: REQUEST
                description: Invalid request. {additionalInfo}
              '20401':
                domain: API_ACCOUNT
                category: REQUEST
                description: Missing field {fieldName}. {additionalInfo}
              '20402':
                domain: API_ACCOUNT
                category: REQUEST
                description: Invalid input. {additionalInfo}
              '20403':
                domain: API_ACCOUNT
                category: REQUEST
                description: Invalid {fieldName}. {additionalInfo}
              '20404':
                domain: API_ACCOUNT
                category: REQUEST
                description: '{fieldName} not found.'
        '404':
          description: Not Found
        '500':
          description: Internal Server Error
          x-response-codes:
            errors:
              '20500':
                domain: API_ACCOUNT
                category: APPLICATION
                description: System error.
              '20501':
                domain: API_ACCOUNT
                category: APPLICATION
                description: Service unavailable. Please try again in next 24 hours.
      security:
      - api_auth:
        - https://api.ebay.com/oauth/api_scope/sell.account
    delete:
      tags:
      - Fulfillment_policy
      description: This method deletes a fulfillment policy. Supply the ID of the policy you want to delete in the <b>fulfillmentPolicyId</b> path parameter.
      operationId: deleteFulfillmentPolicy
      parameters:
      - name: fulfillmentPolicyId
        in: path
        description: This path parameter specifies the ID of the fulfillment policy to delete.<br><br> This ID can be retrieved for a fulfillment policy by using the <a href="/api-docs/sell/account/resources/fulfillment_policy/methods/getFulfillmentPolicies" target="_blank ">getFulfillmentPolicies</a> method.
        required: true
        schema:
          type: string
      responses:
        '204':
          description: No Content
        '400':
          description: Bad Request
          x-response-codes:
            errors:
              '20401':
                domain: API_ACCOUNT
                category: REQUEST
                description: Missing field {fieldName}. {additionalInfo}
              '20402':
                domain: API_ACCOUNT
                category: REQUEST
                description: Invalid input. {additionalInfo}
              '20403':
                domain: API_ACCOUNT
                category: REQUEST
                description: Invalid {fieldName}. {additionalInfo}
              '20404':
                domain: API_ACCOUNT
                category: REQUEST
                description: '{fieldName} not found.'
        '404':
          description: Not Found
        '409':
          description: Conflict
          x-response-codes:
            errors:
              '20409':
                domain: API_ACCOUNT
                category: BUSINESS
                description: Invalid default policy type. {additionalInfo}
              '21409':
                domain: API_ACCOUNT
                category: BUSINESS
                description: Invalid default for category type. {additionalInfo}
              '22409':
                domain: API_ACCOUNT
                category: BUSINESS
                description: Invalid target default policy. {additionalInfo}
        '500':
          description: Internal Server Error
          x-response-codes:
            errors:
              '20500':
                domain: API_ACCOUNT
                category: APPLICATION
                description: System error.
              '20501':
                domain: API_ACCOUNT
                category: APPLICATION
                description: Service unavailable. Please try again in next 24 hours.
      security:
      - api_auth:
        - https://api.ebay.com/oauth/api_scope/sell.account
  /fulfillment_policy:
    get:
      tags:
      - Fulfillment_policy
      description: 'This method retrieves all the fulfillment policies configured for the marketplace you specify using the <code>marketplace_id</code> query parameter.  <br><br><b>Marketplaces and locales</b>  <br><br>Get the correct policies for a marketplace that supports multiple locales using the <code>Content-Language</code> request header. For example, get the policies for the French locale of the Canadian marketplace by specifying <code>fr-CA</code> for the <code>Content-Language</code> header. Likewise, target the Dutch locale of the Belgium marketplace by setting <code>Content-Language: nl-BE</code>. For details on header values, see <a href="/api-docs/static/rest-request-components.html#HTTP" target="_blank">HTTP request headers</a>.'
      operationId: getFulfillmentPolicies
      parameters:
      - name: marketplace_id
        in: query
        description: 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/api-docs/sell/account/types/ba:MarketplaceIdEnum
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FulfillmentPolicyResponse'
        '400':
          description: Bad Request
          x-response-codes:
            errors:
              '20401':
                domain: API_ACCOUNT
                category: REQUEST
                description: Missing field {fieldName}. {additionalInfo}
              '20403':
                domain: API_ACCOUNT
                category: REQUEST
                description: Invalid {fieldName}. {additionalInfo}
              '20404':
                domain: API_ACCOUNT
                category: REQUEST
                description: '{fieldName} not found.'
        '500':
          description: Internal Server Error
          x-response-codes:
            errors:
              '20500':
                domain: API_ACCOUNT
                category: APPLICATION
                description: System error.
              '20501':
                domain: API_ACCOUNT
                category: APPLICATION
                description: Service unavailable. Please try again in next 24 hours.
      security:
      - api_auth:
        - https://api.ebay.com/oauth/api_scope/sell.account
        - https://api.ebay.com/oauth/api_scope/sell.account.readonly
  /fulfillment_policy/get_by_policy_name:
    get:
      tags:
      - Fulfillment_policy
      description: 'This method retrieves the details for a specific fulfillment policy. In the request, supply both the policy <code>name</code> and its associated <code>marketplace_id</code> as query parameters.   <br><br><b>Marketplaces and locales</b>  <br><br>Get the correct policy for a marketplace that supports multiple locales using the <code>Content-Language</code> request header. For example, get a policy for the French locale of the Canadian marketplace by specifying <code>fr-CA</code> for the <code>Content-Language</code> header. Likewise, target the Dutch locale of the Belgium marketplace by setting <code>Content-Language: nl-BE</code>. For details on header values, see <a href="/api-docs/static/rest-request-components.html#HTTP">HTTP request headers</a>.'
      operationId: getFulfillmentPolicyByName
      parameters:
      - name: marketplace_id
        in: query
        description: 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/api-docs/sell/account/types/ba:MarketplaceIdEnum
        required: true
        schema:
          type: string
      - name: name
        in: query
        description: This query parameter specifies the seller-defined name of the fulfillment policy you want to retrieve.<br><br>This value can be retrieved for a fulfillment policy by using the <a href="/api-docs/sell/account/resources/fulfillment_policy/methods/getFulfillmentPolicies" target="_blank ">getFulfillmentPolicies</a> method.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FulfillmentPolicy'
        '400':
          description: Bad Request
          x-response-codes:
            errors:
              '20401':
                domain: API_ACCOUNT
                category: REQUEST
                description: Missing field {fieldName}. {additionalInfo}
              '20403':
                domain: API_ACCOUNT
                category: REQUEST
                description: Invalid {fieldName}. {additionalInfo}
              '20404':
                domain: API_ACCOUNT
                category: REQUEST
                description: '{fieldName} not found.'
        '500':
          description: Internal Server Error
          x-response-codes:
            errors:
              '20500':
                domain: API_ACCOUNT
                category: APPLICATION
                description: System error.
              '20501':
                domain: API_ACCOUNT
                category: APPLICATION
                description: Service unavailable. Please try again in next 24 hours.
      security:
      - api_auth:
        - https://api.ebay.com/oauth/api_scope/sell.account
        - https://api.ebay.com/oauth/api_scope/sell.account.readonly
components:
  schemas:
    SetFulfillmentPolicyResponse:
      type: object
      properties:
        categoryTypes:
          type: array
          description: This container indicates whether the fulfillment business policy applies to motor vehicle listings, or if it applies to non-motor vehicle listings.
          items:
            $ref: '#/components/schemas/CategoryType'
        description:
          type: string
          description: 'A seller-defined description of the fulfillment policy. This description is only for the seller''s use, and is not exposed on any eBay pages. This field is returned if set for the policy. <br><br><b>Max length</b>: 250'
        freightShipping:
          type: boolean
          description: If returned as <code>true</code>, the seller offers freight shipping. Freight shipping can be used for large items over 150 lbs.
        fulfillmentPolicyId:
          type: string
          description: A unique eBay-assigned ID for a fulfillment business policy. This ID is generated when the policy is created.
        globalShipping:
          type: boolean
          description: 'If returned as <code>true</code>, the eBay Global Shipping Program will be used by the seller to ship items to international locations.<br><br><span class="tablenote"><b>Note</b>: On the US marketplace, the <em><b>Global Shipping Program</b></em> is scheduled to be replaced by a new intermediated international shipping program called <em><b>eBay International Shipping</b></em>. US sellers who are opted in to the Global Shipping Program will be automatically opted in to eBay International Shipping when it becomes available to them. All US sellers will be migrated by March 31, 2023. <br><br>eBay International Shipping is an account level setting, and no field needs to be set in a Fulfillment business policy to enable it. As long as the US seller''s account is opted in to eBay International Shipping, this shipping option will be enabled automatically for all listings where international shipping is available. <br><br>A US seller who is opted in to eBay International Shipping can also specify individual international shipping service options for a Fulfillment business policy.</span>'
        handlingTime:
          description: Specifies the maximum number of business days the seller commits to for preparing and shipping an order after receiving a cleared payment for the order. This time does not include the transit time it takes the shipping carrier to deliver the order. <p>If only local pickup or freight shipping is available for the item, this container may not get returned.</p>
          $ref: '#/components/schemas/TimeDuration'
        localPickup:
          type: boolean
          description: If returned as <code>true</code>, local pickup is available for this policy.
        marketplaceId:
          type: string
          description: The ID of the eBay marketplace to which this fulfillment business policy applies. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/account/types/ba:MarketplaceIdEnum'>eBay API documentation</a>
        name:
          type: string
          description: 'A seller-defined name for this fulfillment business policy. Names must be unique for policies assigned to the same marketplace. <br><br><b>Max length</b>: 64'
        pickupDropOff:
          type: boolean
          description: If returned as <code>true</code>, the seller offers the "Click and Collect" option. <br><br>Currently, "Click and Collect" is available only to large retail merchants the eBay AU and UK marketplaces.
        shippingOptions:
          type: array
          description: This array is used to provide detailed information on the domestic and international shipping options available for the policy. A separate <b>ShippingOption</b> object covers domestic shipping service options and international shipping service options (if the seller ships to international locations). <br><br>The <b>optionType</b> field indicates whether the <b>ShippingOption</b> object applies to domestic or international shipping, and the <b>costType</b> field indicates whether flat-rate shipping or calculated shipping will be used. <p>A separate <b>ShippingServices</b> object is used to specify cost and other details for every available domestic and international shipping service option. </p>
          items:
            $ref: '#/components/schemas/ShippingOption'
        shipToLocations:
          description: This container consists of the <b>regionIncluded</b> and <b>regionExcluded</b> containers, which define the geographical regions/countries/states or provinces/domestic regions where the seller does and doesn't ship to with this fulfillment policy.
          $ref: '#/components/schemas/RegionSet'
        warnings:
          type: array
          description: An array of one or more errors or warnings that were generated during the processing of the request. If there were no issues with the request, this array will return empty.
          items:
            $ref: '#/components/schemas/Error'
      description: Complex type that that gets populated with a response containing a fulfillment policy.
    Error:
      type: object
      properties:
        category:
          type: string
          description: 'The category type for this error or warning. It is a string that can have one of three values:<ul><li><code>Application</code>: Indicates an exception or error occurred in the application code or at runtime. Examples include catching an exception in a service''s business logic, system failures, or request errors from a dependency.</li><li><code>Business</code>: Used when your service or a dependent service refused to continue processing on the resource because of a business rule violation such as "Seller does not ship item to Antarctica" or "Buyer ineligible to purchase an alcoholic item". Business errors are not syntactical input errors.</li><li><code>Request</code>: Used when there is anything wrong with the request, such as authentication, syntactical errors, rate limiting or missing headers, bad HTTP header values, and so on.</li></ul>'
        domain:
          type: string
          description: Name of the domain ,or primary system, of the service or application where the error occurred.
        errorId:
          type: integer
          description: A positive integer that uniquely identifies the specific error condition that occurred. Your application can use error codes as identifiers in your customized error-handling algorithms.
          format: int32
        inputRefIds:
          type: array
          description: Identifies specific request elements associated with the error, if any. inputRefId's response is format specific. For JSON, use <i>JSONPath</i> notation.
          items:
            type: string
        longMessage:
          type: string
          description: A more detailed explanation of the error than given in the <code>message</code> error field.
        message:
          type: string
          description: Information on how to correct the problem, in the end user's terms and language where applicable. Its value is at most 50 characters long. If applicable, the value is localized in the end user's requested locale.
        outputRefIds:
          type: array
          description: Identifies specific response elements associated with the error, if any. Path format is the same as <code>inputRefId</code>.
          items:
            type: string
        parameters:
          type: array
          description: This optional list of name/value pairs that contain context-specific <code>ErrorParameter</code> objects, with each item in the list being a parameter (or input field name) that caused an error condition. Each <code>ErrorParameter</code> object consists of two fields, a <code>name</code> and a <code>value</code>.
          items:
            $ref: '#/components/schemas/ErrorParameter'
        subdomain:
          type: string
          description: If present, indicates the subsystem in which the error occurred.
      description: A container that defines the elements of error and warning messages.
    TimeDuration:
      type: object
      properties:
        unit:
          type: string
          description: These enum values represent the time measurement unit, such as <code>DAY</code>. A span of time is defined when you apply the value specified in the <b>value</b> field to the value specified for <b>unit</b>. <br><br>See <b>TimeDurationUnitEnum</b> for a complete list of possible time-measurement units. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/account/types/ba:TimeDurationUnitEnum'>eBay API documentation</a>
        value:
          type: integer
          description: An integer that represents an amount of time, as measured by the time-measurement unit specified in the <b>unit</b> field.
          format: int32
      description: A type used to specify a period of time using a specified time-measurement unit. Payment, return, and fulfillment business policies all use this type to specify time windows.<br><br>Whenever a container that uses this type is used in a request, both of these fields are required. Similarly, whenever a container that uses this type is returned in a response, both of these fields are always returned.
    FulfillmentPolicyResponse:
      type: object
      properties:
        fulfillmentPolicies:
          type: array
          description: A list of all of the seller's fulfillment policies defined for the specified marketplace. This array will be returned as empty if no fulfillment policies are defined for the specified marketplace.
          items:
            $ref: '#/components/schemas/FulfillmentPolicy'
        href:
          type: string
          description: This field is for future use.
        limit:
          type: integer
          description: This field is for future use.
          format: int32
        next:
          type: string
          description: This field is for future use.
        offset:
          type: integer
          description: This field is for future use.
          format: int32
        prev:
          type: string
          description: This field is for future use.
        total:
          type: integer
          description: The total number of fulfillment policies retrieved in the result set.  <br><br>If no fulfillment policies are defined for the specified marketplace, this field is returned with a value of <code>0</code>.
          format: int32
      description: 'The response payload for the <b>getFulfillmentPolicies</b> method.<br><br><span class="tablenote"><b>Note</b>: Pagination has not yet been enabled for <b>getFulfillmentPolicies</b>, so all of the pagination-related fields are for future use.</span>'
    FulfillmentPolicyRequest:
      type: object
      properties:
        categoryTypes:
          type: array
          description: This container is used to specify whether the fulfillment business policy applies to motor vehicle listings, or if it applies to non-motor vehicle listings.
          items:
            $ref: '#/components/schemas/CategoryType'
        description:
          type: string
          description: 'A seller-defined description of the fulfillment policy. This description is only for the seller''s use, and is not exposed on any eBay pages.  <br><br><b>Max length</b>: 250'
        freightShipping:
          type: boolean
          description: 'This field is included and set to <code>true</code> if freight shipping is available for the item. Freight shipping can be used for large items over 150 lbs.<br><br><b>Default</b>: false'
        globalShipping:
          type: boolean
          description: 'This field is included and set to <code>true</code> if the seller wants to use the Global Shipping Program for international shipments. See the <a href="https://pages.ebay.com/help/sell/shipping-globally.html ">Global Shipping Program</a> help topic for more details and requirements on the Global Shipping Program.<br><br>It is possible for a seller to use a combination of the Global Shipping Program and other international shipping services. <br><br>If this value is set to <code>false</code> or if the field is omitted, the seller is responsible for manually specifying individual international shipping services (if the seller ships internationally)., as described in <a href="https://developer.ebay.com/api-docs/sell/static/seller-accounts/ht_shipping-worldwide.html ">Setting up worldwide shipping</a>. <br><br>Sellers can opt in or out of the Global Shipping Program through the Shipping preferences in My eBay.<br><br><span class="tablenote"><b>Note</b>: On the US marketplace, the <em><b>Global Shipping Program</b></e

# --- truncated at 32 KB (69 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/ebay/refs/heads/main/openapi/ebay-fulfillment-policy-api-openapi.yml