@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api Negotiation API
@base https://api.ebay.com/sell/negotiation/v1
@version v1.1.0
@auth OAuth2
@endpoints 2
@toc find_eligible_items(1), send_offer_to_interested_buyers(1)

@group find_eligible_items
@endpoint GET /find_eligible_items
@required {X-EBAY-C-MARKETPLACE-ID: str}
@optional {limit: str, offset: str}
@returns(200) {eligibleItems: [map], href: str, limit: int(int32), next: str, offset: int(int32), prev: str, total: int(int32)}
@returns(204)
@errors {400, 500}

@endgroup

@group send_offer_to_interested_buyers
@endpoint POST /send_offer_to_interested_buyers
@required {X-EBAY-C-MARKETPLACE-ID: str, Content-Type: str}
@optional {allowCounterOffer: bool, message: str, offerDuration: map{unit: str, value: int(int32)}, offeredItems: [map{discountPercentage: str, listingId: str, price: map, quantity: int(int32)}]}
@returns(200) {offers: [map]}
@errors {400, 409, 500}

@endgroup

@end