{"files":{"SKILL.md":"---\nname: negotiation-api\ndescription: \"Negotiation API skill. Use when working with Negotiation for find_eligible_items, send_offer_to_interested_buyers. Covers 2 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Negotiation API\nAPI version: v1.1.0\n\n## Auth\nOAuth2\n\n## Base URL\nhttps://api.ebay.com/sell/negotiation/v1\n\n## Setup\n1. Configure auth: OAuth2\n2. 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.\n3. POST /send_offer_to_interested_buyers -- create first send_offer_to_interested_buyer\n\n## Endpoints\n2 endpoints across 2 groups. See references/api-spec.lap for full details.\n\n### Find_eligible_items\n| Method | Path | Description |\n|--------|------|-------------|\n| 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. |\n\n### Send_offer_to_interested_buyers\n| Method | Path | Description |\n|--------|------|-------------|\n| 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. |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"List all find_eligible_items?\" -> GET /find_eligible_items\n- \"Create a send_offer_to_interested_buyer?\" -> POST /send_offer_to_interested_buyers\n- \"How to authenticate?\" -> See Auth section above\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n- Paginated endpoints accept limit/offset or cursor parameters\n- Create/update endpoints return the modified resource on success\n- Error responses include status codes and descriptions in the spec\n\n## References\n- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas\n\n> Generated from the official API spec by [LAP](https://lap.sh)\n","references/api-spec.lap":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api Negotiation API\n@base https://api.ebay.com/sell/negotiation/v1\n@version v1.1.0\n@auth OAuth2\n@endpoints 2\n@toc find_eligible_items(1), send_offer_to_interested_buyers(1)\n\n@group find_eligible_items\n@endpoint GET /find_eligible_items\n@desc 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.\n@required {X-EBAY-C-MARKETPLACE-ID: str # The eBay marketplace on which you want to search for eligible listings. For a complete list of supported marketplaces, see Negotiation API requirements and restrictions.}\n@optional {limit: str # This query parameter specifies the maximum number of items to return from the result set on a page in the paginated response.Minimum: 1Maximum: 200Default: 10, offset: str # This query parameter specifies the number of results to skip in the result set before returning the first result in the paginated response.  Combine offset with the limit query parameter to control the items returned in the response. For example, if you supply an offset of 0 and a limit of 10, the first page of the response contains the first 10 results from the complete list of items retrieved by the call. If offset is 10 and limit is 20, the first page of the response contains items 11-30 from the complete result set. Default: 0}\n@returns(200) {eligibleItems: [map], href: str, limit: int(int32), next: str, offset: int(int32), prev: str, total: int(int32)} # Success\n@returns(204) No Content\n@errors {400: Bad Request, 500: Internal Server Error}\n\n@endgroup\n\n@group send_offer_to_interested_buyers\n@endpoint POST /send_offer_to_interested_buyers\n@desc 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.\n@required {X-EBAY-C-MARKETPLACE-ID: str # The eBay marketplace on which your listings with \"eligible\" buyers appear.  For a complete list of supported marketplaces, see Negotiation API requirements and restrictions., Content-Type: str # 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.}\n@optional {allowCounterOffer: bool # If set to true, the buyer is allowed to make a counter-offer to the seller's offer.  Note: Currently, you must set this field to false; counter-offers are not supported in this release.  Default: false, message: str # A seller-defined message related to the offer being made.  This message is sent to the list of \"interested\" buyers.  To increase the conversion rate of the offers a seller makes to buyers, eBay recommends you always add a customized message to your offers.  Maximum length: 2,000 characters, offerDuration: map{unit: str, value: int(int32)} # A complex type that specifies a period of time using a specified time-measurement unit., offeredItems: [map{discountPercentage: str, listingId: str, price: map, quantity: int(int32)}] # An array of objects where each object contains the details of an offer and the ID of the listing on which the offer is being made.  Note that the service does not currently support the creation of multiple offers with a single call to sendOfferToInterestedBuyer. With this, each request can target only one listing at a time and you must populate this array with a single element that contains the details of one offer.}\n@returns(200) {offers: [map]} # Success\n@errors {400: Bad Request, 409: Conflict, 500: Internal Server Error}\n\n@endgroup\n\n@end\n"}}