# Fulfillment API API

> Fulfillment API API on Apizie: 15 endpoints (Use this call to search for and retrieve one or more orders based on their creation date, last modification…, Use this call to retrieve the contents of an order based on its unique identifier, orderId . This value was…, Use this call to retrieve the contents of all fulfillments currently defined for a specified order based on…, When you group an order's line items into one or more packages, each package requires a corresponding plan…, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/ecommerce:ebay-sell-fulfillment/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `ecommerce:ebay-sell-fulfillment`
- Category: E-commerce
- Status: byok
- Source: https://ebay.com
- Page: https://apizie.tech/api/ecommerce/ebay-sell-fulfillment
- OpenAPI: https://apizie.tech/api/ecommerce/ebay-sell-fulfillment/openapi.json

Use the Fulfillment API to complete the process of packaging, addressing, handling, and shipping each order on behalf of the seller, in accordance with the payment method and timing specified at checkout.

## Endpoints

### Use this call to search for and retrieve one or more orders based on their creation date, last modification…
`GET https://apizie.tech/v1/ecommerce:ebay-sell-fulfillment/get-orders` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| fieldGroups | string | no | The response type associated with the order. The only presently supported value is TAX_BREAKDOWN . This type returns a breakdown of tax… |
| filter | string | no | One or more comma-separated criteria for narrowing down the collection of orders returned by this call. These criteria correspond to… |
| limit | string | no | The number of orders to return per page of the result set. Use this parameter in conjunction with the offset parameter to control the… |
| offset | string | no | Specifies the number of orders to skip in the result set before returning the first order in the paginated response. Combine offset with… |
| orderIds | string | no | A comma-separated list of the unique identifiers of the orders to retrieve (maximum 50). If one or more order ID values are specified… |

### Use this call to retrieve the contents of an order based on its unique identifier, orderId . This value was…
`GET https://apizie.tech/v1/ecommerce:ebay-sell-fulfillment/get-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| fieldGroups | string | no | The response type associated with the order. The only presently supported value is TAX_BREAKDOWN . This type returns a breakdown of tax… |
| orderId | string | yes | The unique identifier of the order. Order ID values are shown in My eBay/Seller Hub, and are also returned by the getOrders method in the… |

### Use this call to retrieve the contents of all fulfillments currently defined for a specified order based on…
`GET https://apizie.tech/v1/ecommerce:ebay-sell-fulfillment/get-shipping-fulfillments` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| orderId | string | yes | The unique identifier of the order. Order ID values are shown in My eBay/Seller Hub, and are also returned by the getOrders method in the… |

### When you group an order's line items into one or more packages, each package requires a corresponding plan…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-fulfillment/create-shipping-fulfillment` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| orderId | string | yes | The unique identifier of the order. Order ID values are shown in My eBay/Seller Hub, and are also returned by the getOrders method in the… |
| body | object | yes | JSON request body |

### Use this call to retrieve the contents of a fulfillment based on its unique identifier, fulfillmentId…
`GET https://apizie.tech/v1/ecommerce:ebay-sell-fulfillment/get-shipping-fulfillment` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| fulfillmentId | string | yes | The unique identifier of the fulfillment. This eBay-generated value was created by the Create Shipping Fulfillment call, and returned by… |
| orderId | string | yes | The unique identifier of the order. Order ID values are shown in My eBay/Seller Hub, and are also returned by the getOrders method in the… |

### Issue Refund
`POST https://apizie.tech/v1/ecommerce:ebay-sell-fulfillment/issue-refund` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| order_id | string | yes | The unique identifier of the order. Order IDs are returned in the getOrders method (and GetOrders call of Trading API). The issueRefund… |
| body | object | no | JSON request body |

### Get Payment Dispute Details
`GET https://apizie.tech/v1/ecommerce:ebay-sell-fulfillment/get-payment-dispute` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| payment_dispute_id | string | yes | This is the unique identifier of the payment dispute. This path parameter must be passed in at the end of the call URI to identify the… |

### Accept Payment Dispute
`POST https://apizie.tech/v1/ecommerce:ebay-sell-fulfillment/accept-payment-dispute` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| payment_dispute_id | string | yes | This is the unique identifier of the payment dispute. This path parameter must be passed into the call URI to identify the payment dispute… |
| body | object | no | JSON request body |

### Get Payment Dispute Activity
`GET https://apizie.tech/v1/ecommerce:ebay-sell-fulfillment/get-activities` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| payment_dispute_id | string | yes | This is the unique identifier of the payment dispute. This path parameter must be passed in at the end of the call URI to identify the… |

### Add an Evidence File
`POST https://apizie.tech/v1/ecommerce:ebay-sell-fulfillment/add-evidence` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| payment_dispute_id | string | yes | This is the unique identifier of the payment dispute. This path parameter must be passed into the call URI to identify the payment dispute… |
| body | object | no | JSON request body |

### Contest Payment Dispute
`POST https://apizie.tech/v1/ecommerce:ebay-sell-fulfillment/contest-payment-dispute` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| payment_dispute_id | string | yes | This is the unique identifier of the payment dispute. This path parameter must be passed into the call URI to identify the payment dispute… |
| body | object | no | JSON request body |

### Get Payment Dispute Evidence File
`GET https://apizie.tech/v1/ecommerce:ebay-sell-fulfillment/fetch-evidence-content` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| payment_dispute_id | string | yes | The identifier of the payment dispute. The identifier of each payment dispute is returned in the getPaymentDisputeSummaries response. This… |
| evidence_id | string | yes | The identifier of the evidential file set. The identifier of an evidential file set for a payment dispute is returned under the evidence… |
| file_id | string | yes | The identifier of an evidential file. This file must belong to the evidential file set identified through the evidence_id query parameter.… |

### Update evidence
`POST https://apizie.tech/v1/ecommerce:ebay-sell-fulfillment/update-evidence` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| payment_dispute_id | string | yes | This is the unique identifier of the payment dispute. This path parameter must be passed into the call URI to identify the payment dispute… |
| body | object | no | JSON request body |

### Upload an Evidence File
`POST https://apizie.tech/v1/ecommerce:ebay-sell-fulfillment/upload-evidence-file` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| payment_dispute_id | string | yes | This is the unique identifier of the payment dispute. This path parameter must be passed into the call URI to identify the payment dispute… |

### Search Payment Dispute by Filters
`GET https://apizie.tech/v1/ecommerce:ebay-sell-fulfillment/get-payment-dispute-summaries` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| order_id | string | no | This filter is used if the seller wishes to retrieve one or more payment disputes filed against a specific order. It is possible that… |
| buyer_username | string | no | This filter is used if the seller wishes to retrieve one or more payment disputes opened by a specific seller. The string that is passed… |
| open_date_from | string | no | The open_date_from and/or open_date_to date filters are used if the seller wishes to retrieve payment disputes opened within a specific… |
| open_date_to | string | no | The open_date_from and/or open_date_to date filters are used if the seller wishes to retrieve payment disputes opened within a specific… |
| payment_dispute_status | string | no | This filter is used if the seller wishes to only retrieve payment disputes in a specific state. More than one value can be specified. If… |
| limit | string | no | The value passed in this query parameter sets the maximum number of payment disputes to return per page of data. The value passed in this… |
| offset | string | no | This field is used to specify the number of records to skip in the result set before returning the first payment dispute in the paginated… |

## Example
```
curl "https://apizie.tech/v1/ecommerce:ebay-sell-fulfillment/get-orders" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Fulfillment API API?
Create a free Apizie key, then send GET https://apizie.tech/v1/ecommerce:ebay-sell-fulfillment/get-orders with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Fulfillment API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Fulfillment API itself also needs your own key from ebay.com.

### Can AI agents use the Fulfillment API API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key ecommerce:ebay-sell-fulfillment.

### What is the status of the Fulfillment API API?
Needs your own provider key (bring your own key)