fulfillment-api — quality + safety report

---
name: fulfillment-api
description: "Fulfillment API skill. Use when working with Fulfillment for order, payment_dispute, payment_dispute_summary. Covers 15 endpoints."
version: 1.0.0
generator: lapsh
---

# Fulfillment API
API version: v1.20.7

## Auth
OAuth2

## Base URL
https://api.ebay.com/sell/fulfillment/v1

## Setup
1. Configure auth: OAuth2
2. GET /order -- verify access
3. POST /order/{order_id}/issue_refund -- create first issue_refund

## Endpoints

15 endpoints across 3 groups. See references/api-spec.lap for full details.

### order
| Method | Path | Description |
|--------|------|-------------|
| GET | /order/{orderId} | Use this call to retrieve the contents of an order based on its unique identifier, <i>orderId</i>. This value was returned in the <b> getOrders</b> call's <b>orders.orderId</b> field when you searched for orders by creation date, modification date, or fulfillment status. Include the optional <b>fieldGroups</b> query parameter set to <code>TAX_BREAKDOWN</code> to return a breakdown of the taxes and fees. <br><br> The returned <b>Order</b> object contains information you can use to create and process fulfillments, including: <ul> <li>Information about the buyer and seller</li> <li>Information about the order's line items</li> <li> The plans for packaging, addressing and shipping the order</li> <li>The status of payment, packaging, addressing, and shipping the order</li> <li>A summary of monetary amounts specific to the order such as pricing, payments, and shipping costs</li> <li>A summary of applied taxes and fees, and optionally a breakdown of each </li></ul> |
| GET | /order | Use this method to search for and retrieve one or more orders based on their creation date, last modification date, or fulfillment status using the <b>filter</b> parameter. You can alternatively specify a list of orders using the <b>orderIds</b> parameter. Include the optional <b>fieldGroups</b> query parameter set to <code>TAX_BREAKDOWN</code> to return a breakdown of the taxes and fees. By default, when no filters are used this call returns all orders created within the last 90 days. <br><br> The returned <b>Order</b> objects contain information you can use to create and process fulfillments, including: <ul> <li>Information about the buyer and seller</li> <li>Information about the order's line items</li> <li>The plans for packaging, addressing and shipping the order</li> <li>The status of payment, packaging, addressing, and shipping the order</li> <li>A summary of monetary amounts specific to the order such as pricing, payments, and shipping costs</li> <li>A summary of applied taxes and fees, and optionally a breakdown of each </li></ul> <br><br> <span class="tablenote"><strong>Important:</strong> In this call, the <b>cancelStatus.cancelRequests</b> array is returned but is always empty. Use the <b>getOrder</b> call instead, which returns this array fully populated with information about any cancellation requests.</span> |
| POST | /order/{order_id}/issue_refund | Issue Refund |
| GET | /order/{orderId}/shipping_fulfillment | Use this call to retrieve the contents of all fulfillments currently defined for a specified order based on the order's unique identifier, <b>orderId</b>. This value is returned in the <b>getOrders</b> call's <b>members.orderId</b> field when you search for orders by creation date or shipment status. |
| POST | /order/{orderId}/shipping_fulfillment | When you group an order's line items into one or more packages, each package requires a corresponding plan for handling, addressing, and shipping; this is a <i>shipping fulfillment</i>. For each package, execute this call once to generate a shipping fulfillment associated with that package. <br><br> <span class="tablenote"><strong>Note:</strong> A single line item in an order can consist of multiple units of a purchased item, and one unit can consist of multiple parts or components. Although these components might be provided by the manufacturer in separate packaging, the seller must include all components of a given line item in the same package.</span> <br><br>Before using this call for a given package, you must determine which line items are in the package. If the package has been shipped, you should provide the date of shipment in the request. If not provided, it will default to the current date and time. |
| GET | /order/{orderId}/shipping_fulfillment/{fulfillmentId} | Use this call to retrieve the contents of a fulfillment based on its unique identifier, <b>fulfillmentId</b> (combined with the associated order's <b>orderId</b>). The <b>fulfillmentId</b> value was originally generated by the <b>createShippingFulfillment</b> call, and is returned by the <b>getShippingFulfillments</b> call in the <b>members.fulfillmentId</b> field. |

### payment_dispute
| Method | Path | Description |
|--------|------|-------------|
| GET | /payment_dispute/{payment_dispute_id} | Get Payment Dispute Details |
| GET | /payment_dispute/{payment_dispute_id}/fetch_evidence_content | Get Payment Dispute Evidence File |
| GET | /payment_dispute/{payment_dispute_id}/activity | Get Payment Dispute Activity |
| POST | /payment_dispute/{payment_dispute_id}/contest | Contest Payment Dispute |
| POST | /payment_dispute/{payment_dispute_id}/accept | Accept Payment Dispute |
| POST | /payment_dispute/{payment_dispute_id}/upload_evidence_file | Upload an Evidence File |
| POST | /payment_dispute/{payment_dispute_id}/add_evidence | Add an Evidence File |
| POST | /payment_dispute/{payment_dispute_id}/update_evidence | Update evidence |

### payment_dispute_summary
| Method | Path | Description |
|--------|------|-------------|
| GET | /payment_dispute_summary | Search Payment Dispute by Filters |

## Common Questions

Match user requests to endpoints in references/api-spec.lap. Key patterns:
- "Get order details?" -> GET /order/{orderId}
- "List all order?" -> GET /order
- "Create a issue_refund?" -> POST /order/{order_id}/issue_refund
- "List all shipping_fulfillment?" -> GET /order/{orderId}/shipping_fulfillment
- "Create a shipping_fulfillment?" -> POST /order/{orderId}/shipping_fulfillment
- "Get shipping_fulfillment details?" -> GET /order/{orderId}/shipping_fulfillment/{fulfillmentId}
- "Get payment_dispute details?" -> GET /payment_dispute/{payment_dispute_id}
- "List all fetch_evidence_content?" -> GET /payment_dispute/{payment_dispute_id}/fetch_evidence_content
- "List all activity?" -> GET /payment_dispute/{payment_dispute_id}/activity
- "List all payment_dispute_summary?" -> GET /payment_dispute_summary
- "Create a contest?" -> POST /payment_dispute/{payment_dispute_id}/contest
- "Create a accept?" -> POST /payment_dispute/{payment_dispute_id}/accept
- "Create a upload_evidence_file?" -> POST /payment_dispute/{payment_dispute_id}/upload_evidence_file
- "Create a add_evidence?" -> POST /payment_dispute/{payment_dispute_id}/add_evidence
- "Create a update_evidence?" -> POST /payment_dispute/{payment_dispute_id}/update_evidence
- "How to authenticate?" -> See Auth section

## Response Tips
- Check response schemas in references/api-spec.lap for field details
- List endpoints may support pagination; check for limit, offset, or cursor params
- Create/update endpoints typically return the created/updated object

## References
- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas

> Generated from the official API spec by [LAP](https://lap.sh)