Note:createOffer call, and then make one or more subsequent updateOffer calls to complete the offer and prepare to publish the offer. Upon first creating an offer, the following fields are required in"
},
{
"info": {
"name": "getOffer",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.ebay.com{basePath}/offer/:offerId",
"params": [
{
"name": "offerId",
"value": "",
"type": "path",
"description": "This path parameter specifies the unique identifier of the offer that is to be retrieved.
Use the getOffers method to retrieve offer IDs."
}
],
"auth": {
"type": "oauth2",
"flow": "authorization_code",
"authorizationUrl": "https://auth.ebay.com/oauth2/authorize",
"accessTokenUrl": "https://api.ebay.com/identity/v1/oauth2/token",
"credentials": {
"clientId": "{{clientId}}",
"clientSecret": "{{clientSecret}}"
}
}
},
"docs": "This call retrieves a specific published or unpublished offer. The unique identifier of the offer (offerId) is passed in at the end of the call URI.The authorization header is the only required HTTP header for this call. See the HTTP request headers section for more information.
"
},
{
"info": {
"name": "updateOffer",
"type": "http"
},
"http": {
"method": "PUT",
"url": "https://api.ebay.com{basePath}/offer/:offerId",
"headers": [
{
"name": "Content-Language",
"value": ""
},
{
"name": "Content-Type",
"value": ""
}
],
"params": [
{
"name": "offerId",
"value": "",
"type": "path",
"description": "This path parameter specifies the unique identifier of the offer being updated.
Use the getOffers method to retrieve offer IDs."
}
],
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "oauth2",
"flow": "authorization_code",
"authorizationUrl": "https://auth.ebay.com/oauth2/authorize",
"accessTokenUrl": "https://api.ebay.com/identity/v1/oauth2/token",
"credentials": {
"clientId": "{{clientId}}",
"clientSecret": "{{clientSecret}}"
}
}
},
"docs": "This call updates an existing offer. An existing offer may be in published state (active eBay listing), or in an unpublished state and yet to be published with the publishOffer call. The unique identifier (offerId) for the offer to update is passed in at the end of the call URI.
The updateOffer call does a complete replacement of the existing offer object, so all fields that make up the current offer object are required, regardless of w"
},
{
"info": {
"name": "deleteOffer",
"type": "http"
},
"http": {
"method": "DELETE",
"url": "https://api.ebay.com{basePath}/offer/:offerId",
"params": [
{
"name": "offerId",
"value": "",
"type": "path",
"description": "This path parameter specifies the unique identifier of the offer being deleted.
Use the getOffers method to retrieve offer IDs."
}
],
"auth": {
"type": "oauth2",
"flow": "authorization_code",
"authorizationUrl": "https://auth.ebay.com/oauth2/authorize",
"accessTokenUrl": "https://api.ebay.com/identity/v1/oauth2/token",
"credentials": {
"clientId": "{{clientId}}",
"clientSecret": "{{clientSecret}}"
}
}
},
"docs": "If used against an unpublished offer, this call will permanently delete that offer. In the case of a published offer (or live eBay listing), a successful call will either end the single-variation listing associated with the offer, or it will remove that product variation from the eBay listing and also automatically remove that product variation from the inventory item group. In the case of a multiple-variation listing, the deleteOffer will not remove the product variation from t"
},
{
"info": {
"name": "getListingFees",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://api.ebay.com{basePath}/offer/get_listing_fees",
"headers": [
{
"name": "Content-Type",
"value": ""
}
],
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "oauth2",
"flow": "authorization_code",
"authorizationUrl": "https://auth.ebay.com/oauth2/authorize",
"accessTokenUrl": "https://api.ebay.com/identity/v1/oauth2/token",
"credentials": {
"clientId": "{{clientId}}",
"clientSecret": "{{clientSecret}}"
}
}
},
"docs": "This call is used to retrieve the expected listing fees for up to 250 unpublished offers. An array of one or more offerId values are passed in under the offers container.
In the response payload, all listing fees are grouped by eBay marketplace, and listing fees per offer are not shown. A fees container will be returned for each eBay marketplace where the seller is selling the products associated with the specified offers.
Error"
},
{
"info": {
"name": "publishOffer",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://api.ebay.com{basePath}/offer/:offerId/publish/",
"params": [
{
"name": "offerId",
"value": "",
"type": "path",
"description": "This path parameter specifies the unique identifier of the offer that is to be published.
Use the getOffers method to retrieve offer IDs."
}
],
"auth": {
"type": "oauth2",
"flow": "authorization_code",
"authorizationUrl": "https://auth.ebay.com/oauth2/authorize",
"accessTokenUrl": "https://api.ebay.com/identity/v1/oauth2/token",
"credentials": {
"clientId": "{{clientId}}",
"clientSecret": "{{clientSecret}}"
}
}
},
"docs": "Note: Each listing can be revised up to 250 times in one calendar day. If this revision threshold is reached, the seller will be blocked from revising the item until the next calendar day.
This call is used to convert an unpublished offer into a published offer, or live eBay listing. The unique identifier of the offer (offerId) is passed in at the end of the call URI.
For those who prefer to publish multiple offers (up to"
},
{
"info": {
"name": "publishOfferByInventoryItemGroup",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://api.ebay.com{basePath}/offer/publish_by_inventory_item_group/",
"headers": [
{
"name": "Content-Type",
"value": ""
}
],
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "oauth2",
"flow": "authorization_code",
"authorizationUrl": "https://auth.ebay.com/oauth2/authorize",
"accessTokenUrl": "https://api.ebay.com/identity/v1/oauth2/token",
"credentials": {
"clientId": "{{clientId}}",
"clientSecret": "{{clientSecret}}"
}
}
},
"docs": "Note: Please note that any eBay listing created using the Inventory API cannot be revised or relisted using the Trading API calls.
Note: Each listing can be revised up to 250 times in one calendar day. If this revision threshold is reached, the seller will be blocked from revising the item until the next calendar day.
This call is used to convert all unpublished offers associated with an invento"
},
{
"info": {
"name": "withdrawOffer",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://api.ebay.com{basePath}/offer/:offerId/withdraw",
"params": [
{
"name": "offerId",
"value": "",
"type": "path",
"description": "This path parameter specifies the unique identifier of the offer that is to be withdrawn.
Use the getOffers method to retrieve offer IDs."
}
],
"auth": {
"type": "oauth2",
"flow": "authorization_code",
"authorizationUrl": "https://auth.ebay.com/oauth2/authorize",
"accessTokenUrl": "https://api.ebay.com/identity/v1/oauth2/token",
"credentials": {
"clientId": "{{clientId}}",
"clientSecret": "{{clientSecret}}"
}
}
},
"docs": "This call is used to end a single-variation listing that is associated with the specified offer. This call is used in place of the deleteOffer call if the seller only wants to end the listing associated with the offer but does not want to delete the offer object. With this call, the offer object remains, but it goes into the unpublished state, and will require a publishOffer call to relist the offer.
To end a multiple-variation listing that is associated "
},
{
"info": {
"name": "withdrawOfferByInventoryItemGroup",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://api.ebay.com{basePath}/offer/withdraw_by_inventory_item_group",
"headers": [
{
"name": "Content-Type",
"value": ""
}
],
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "oauth2",
"flow": "authorization_code",
"authorizationUrl": "https://auth.ebay.com/oauth2/authorize",
"accessTokenUrl": "https://api.ebay.com/identity/v1/oauth2/token",
"credentials": {
"clientId": "{{clientId}}",
"clientSecret": "{{clientSecret}}"
}
}
},
"docs": "This call is used to end a multiple-variation eBay listing that is associated with the specified inventory item group. This call only ends multiple-variation eBay listing associated with the inventory item group but does not delete the inventory item group object. Similarly, this call also does not delete any of the offers associated with the inventory item group, but instead all of these offers go into the unpublished state. If the seller wanted to relist the multiple-variation eBay listing, th"
}
]
}
],
"bundled": true
}