---
name: negotiation-api
description: "Negotiation API skill. Use when working with Negotiation for find_eligible_items, send_offer_to_interested_buyers. Covers 2 endpoints."
version: 1.0.0
generator: lapsh
---

# Negotiation API
API version: v1.1.0

## Auth
OAuth2

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

## Setup
1. Configure auth: OAuth2
2. GET /find_eligible_items -- this method evaluates a seller's current listings and returns the set of ids that are eligible for a seller-initiated discount offer to a buyer.  a listing id is returned only when one or more buyers have shown an "interest" in the listing.  if any buyers have shown interest in a listing, the seller can initiate a "negotiation" with them by calling sendoffertointerestedbuyers, which sends all interested buyers a message that offers the listing at a discount.  for details about how to create seller offers to buyers, see sending offers to buyers.
3. POST /send_offer_to_interested_buyers -- create first send_offer_to_interested_buyer

## Endpoints
2 endpoints across 2 groups. See references/api-spec.lap for full details.

### Find_eligible_items
| Method | Path | Description |
|--------|------|-------------|
| GET | /find_eligible_items | This method evaluates a seller's current listings and returns the set of IDs that are eligible for a seller-initiated discount offer to a buyer.  A listing ID is returned only when one or more buyers have shown an "interest" in the listing.  If any buyers have shown interest in a listing, the seller can initiate a "negotiation" with them by calling sendOfferToInterestedBuyers, which sends all interested buyers a message that offers the listing at a discount.  For details about how to create seller offers to buyers, see Sending offers to buyers. |

### Send_offer_to_interested_buyers
| Method | Path | Description |
|--------|------|-------------|
| POST | /send_offer_to_interested_buyers | This method sends eligible buyers offers to purchase items in a listing at a discount.  When a buyer has shown interest in a listing, they become "eligible" to receive a seller-initiated offer to purchase the item(s).  Sellers use findEligibleItems to get the set of listings that have interested buyers. If a listing has interested buyers, sellers can use this method (sendOfferToInterestedBuyers) to send an offer to the buyers who are interested in the listing. The offer gives buyers the ability to purchase the associated listings at a discounted price.  For details about how to create seller offers to buyers, see Sending offers to buyers. |

## Common Questions
Match user requests to endpoints in references/api-spec.lap. Key patterns:
- "List all find_eligible_items?" -> GET /find_eligible_items
- "Create a send_offer_to_interested_buyer?" -> POST /send_offer_to_interested_buyers
- "How to authenticate?" -> See Auth section above

## Response Tips
- Check response schemas in references/api-spec.lap for field details
- Paginated endpoints accept limit/offset or cursor parameters
- Create/update endpoints return the modified resource on success
- Error responses include status codes and descriptions in the spec

## 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)