# Snapdeal Seller APIs Documentation

> APIs to seamlessly integrate with Snapdeal Seller Platform

## API Reference
- [Overview](https://sellerapis.snapdeal.com/reference/overview.md)
- [API Picker](https://sellerapis.snapdeal.com/reference/api-picker.md)
- [Http Status codes](https://sellerapis.snapdeal.com/reference/http-status-codes.md)
- [API Authentication](https://sellerapis.snapdeal.com/reference/api-authentication.md)
- [API Authorization:](https://sellerapis.snapdeal.com/reference/api-authorization.md)
- [Seller Notifications](https://sellerapis.snapdeal.com/reference/description-1.md)
- [Seller Notification Registration](https://sellerapis.snapdeal.com/reference/seller-notification-registration.md): With this api seller can subscribe for getting notifications
- [Seller Notification  De-Registration](https://sellerapis.snapdeal.com/reference/seller-notification-de-registration.md): With this api seller can cancel the subscription of getting Notifications.
- [Seller Onboarding](https://sellerapis.snapdeal.com/reference/description.md)
- [Get Primary Categories](https://sellerapis.snapdeal.com/reference/getonboardingprimarycategories.md): Returns the list of primary categories, that can be used as input while registering the seller.
- [Lead Registration](https://sellerapis.snapdeal.com/reference/lead-registration.md): Lead Registration API can be used to create a lead level seller registration on Snapdeal. Partners can use this API to initiate seller registration on Snapdeal. Once this API is successfully executed, Snapdeal onboarding team will follow up with Seller to complete the seller registration process
- [Seller Registration](https://sellerapis.snapdeal.com/reference/seller-registration.md): Seller Registration API is used to do complete registration of a seller. This requires lead level registration as a pre-requisite.
- [Get Seller Profile](https://sellerapis.snapdeal.com/reference/get-seller-profile.md): Use this API to get basic details of the seller, irrespective of whether s/he is on-boarded through API.  Partners can leverage this API to get seller details like Email, Phone Number, & Company Name, once seller authorizes them to access the data.
- [Product Listing](https://sellerapis.snapdeal.com/reference/description-3.md)
- [Get Categories](https://sellerapis.snapdeal.com/reference/get-categories.md): Get parent categories for given search key .if search key is not provided it will give all perent categories
- [Get Children for Category](https://sellerapis.snapdeal.com/reference/get-children-for-category.md): Get the children categories for given categoryId
- [Get Search for category](https://sellerapis.snapdeal.com/reference/get-search-for-category.md): This API allows you to search a category by name. The response is structured to the level depending upon what is the sub-cat or product that results in search.
- [Get Attributes for category](https://sellerapis.snapdeal.com/reference/get-attributes-for-category.md): Returns the Attributes for given category. Attributes denote the inputs needed to list a product in that category.
- [Get Search Seller Product](https://sellerapis.snapdeal.com/reference/get-search-seller-product.md): The API searches the products the seller owns. Returns all matching search key. for eg: /products/search?key=mobile will result in all products matching mobile attribute entries.
- [Get Search All  Products](https://sellerapis.snapdeal.com/reference/get-search-other-seller-product.md): This API is required when list an existing products. The seller can search existing products from other sellers and add to his portfolio.
- [Post Listing of New Product](https://sellerapis.snapdeal.com/reference/post-listing.md): API to be used for listing a new product.
- [Post Listing of New Product with external Image Urls](https://sellerapis.snapdeal.com/reference/post-listing-of-new-product-with-external-image-urls.md): API to be used for listing a new product with external Image urls(CDN, Dropbox)
- [Prelisting Financials](https://sellerapis.snapdeal.com/reference/prelisting-financials.md): To compute the financials before creating a new product. Once the seller enters the values of the all the mandatory attributes fetched through the category attributes API, this API can be called to compute the financials based on the entered information.
- [Post upload image](https://sellerapis.snapdeal.com/reference/post-upload-image.md): The API uploads image and returns the reference which is required to be passed to the post Listing API .
- [Post listing of Existing product](https://sellerapis.snapdeal.com/reference/post-listing-of-existing-product.md): Add existing product on Snapdeal to the seller's catalog.
- [Edit Listing](https://sellerapis.snapdeal.com/reference/edit-listing.md): API to be used for edit listing.
- [Get Listing Image Configuration](https://sellerapis.snapdeal.com/reference/get-listing-image-configuration.md): Get the basic rules for the images to be uploaded to Snapdeal. This API only gives basic details, and for details information, refer to Seller Panel.
- [Get Result](https://sellerapis.snapdeal.com/reference/get-result.md): Returns the detailed status for the given uploadid
- [Get Seller's Result](https://sellerapis.snapdeal.com/reference/get-sellers-result.md): Returns the uploaded status (price, listing, inventory) of the products with in the given time range in chronological order
- [Track Listing](https://sellerapis.snapdeal.com/reference/track-listing.md): Through this api you can track the listing by sending either uploadId or sku in the request.
- [Inventory Management](https://sellerapis.snapdeal.com/reference/description-4.md)
- [Get Inventory Bulk](https://sellerapis.snapdeal.com/reference/get-inventory-bulk.md): Returns the seller's inventories for the given SUPCs with a limit of 10.
- [Get Inventory Single](https://sellerapis.snapdeal.com/reference/get-inventory-single.md): Returns inventory level for a particular SUPC
- [Post update Inventory for the Product](https://sellerapis.snapdeal.com/reference/post-update-inventory-for-the-product.md): To change inventory levels of upto 1000 SUPCs
- [Get Result](https://sellerapis.snapdeal.com/reference/get-result2.md): Returns the detailed status for the given uploadid
- [Get Update Result](https://sellerapis.snapdeal.com/reference/get-sellers-result-1.md): Returns the uploaded status (price, listing, inventory) of the products with in the given time range
- [Pricing Management](https://sellerapis.snapdeal.com/reference/description-5.md)
- [Get Price Bulk](https://sellerapis.snapdeal.com/reference/get-price-bulk.md): Returns the pricing details for the given SUPCs with a limit of 10.
- [Get Price Single](https://sellerapis.snapdeal.com/reference/get-price-single.md): Returns the  pricing details for the given SUPC
- [Post Update Price](https://sellerapis.snapdeal.com/reference/post-update-price.md): Post updates on the seller's price for the given SUPCs with a limit of 1000.
- [Get Result](https://sellerapis.snapdeal.com/reference/get-result3.md): Returns the detailed status for the given uploadid
- [Get Update Result](https://sellerapis.snapdeal.com/reference/get-sellers-result-2.md): Returns the uploaded status (price, listing, inventory) of the products with in the given time range
- [Order Management](https://sellerapis.snapdeal.com/reference/description-2.md)
- [/orders/new](https://sellerapis.snapdeal.com/reference/ordersnew.md): This API will be used to get the orders in  Pending for fulfilment (PFF) & Print  (PRNT) state in descending order of created time. API also provides the filter to get the orders based on the order status(PFF or PRNT). If the buyer has ordered multiple quantities of a product then each quantity will be treated as one single item(subOrder) and those number of items will be returned under that package.
- [/orders/new/{packageReferenceCode}](https://sellerapis.snapdeal.com/reference/ordersn.md): This api will be used to get the order with given orderId which is  in  Pending for fulfillment (PFF) & Print  (PRNT) state.
- [/orders/completed](https://sellerapis.snapdeal.com/reference/orderscompleted-1.md): This api will be used to get the orders in In_transit & fulfilled state.
- [/orders/completed/{packageReferenceCode}](https://sellerapis.snapdeal.com/reference/orderscompletedorderid1.md): This api will be used to get the order with given orderId which is  in  In_transit & fulfilled state.
- [/suborders/cancelled](https://sellerapis.snapdeal.com/reference/suborderscancelled.md): This api will returns the  orders in cancelled state
- [/suborders/cancelled/{suborderCode}](https://sellerapis.snapdeal.com/reference/suborderscancelledsuborderid.md): This api will be used to get the order with given suborderCode which is  in  cancelled state .
- [/suborders/allCancelledOrders](https://sellerapis.snapdeal.com/reference/subordersallCancelledOrders.md): This api will be used to get the order with given suborderCode which got cancelled post manifest.
- [/dropship/manifest](https://sellerapis.snapdeal.com/reference/dropshipmanifest.md): Provides all manifest in given date range with ALL/PRINTED/UNPRINTED status.
- [/dropship/manifest/{code}/orders](https://sellerapis.snapdeal.com/reference/dropshipmanifestcodeorders.md): Provides all orders in manifest sheet for given code.
- [/vendorself/manifest](https://sellerapis.snapdeal.com/reference/vendorselfmanifest.md): All manifest in given date range with ALL/PRINTED/UNPRINTED status.
- [/vendorself/manifest/{code}/orders](https://sellerapis.snapdeal.com/reference/vendorselfmanifestcodeorders-1.md): Provides All orders in manifest sheet for given manifest code
- [/ocplus/stn](https://sellerapis.snapdeal.com/reference/ocplusstn.md): All stn sheets in given date range with ALL/PRINTED/UNPRINTED status.
- [/ocplus/stn/{handOverCode}/orders](https://sellerapis.snapdeal.com/reference/ocplusstnsellerocloccodeorders.md): Returns All orders in stn sheet for given stn code
- [/oneship/hos](https://sellerapis.snapdeal.com/reference/oneshiphos.md): All hos sheets in given date range with ALL/PRINTED/UNPRINTED status.
- [/oneship/hos/{code}/orders](https://sellerapis.snapdeal.com/reference/oneshiphoscodeorders-1.md): Returns All orders in hos sheet for given code
- [/seller/config](https://sellerapis.snapdeal.com/reference/sellerconfig.md): Returns the  seller config values
- [/orders/suborder/bulk/status](https://sellerapis.snapdeal.com/reference/orderssuborderbulkstatus.md): This API updates the status of a suborder. Allowed status in Out of Stock. Multiple updates are allowed at a time. Here we need to use "siReferenceCode" of suborder as key.  siReferenceCode : This is associated with item(suborder) level. This value can be fetched from "/orders/new/{packageReferenceCode}" api under packages -> items -> siReferenceCode
- [/orders/suborder/bulk/imei](https://sellerapis.snapdeal.com/reference/orderssuborderbulkimei-1.md): This API updates the IMEI number/ Serial no. of a suborder. Multiple updates are allowed.
- [/orders/invoice](https://sellerapis.snapdeal.com/reference/ordersinvoice-1.md): This API updates the Invoice code of an order. Multiple updates are allowed.
- [/seller/invoices](https://sellerapis.snapdeal.com/reference/sellerinvoices-1.md): This API adds a set of invoice numbers for a seller. Can update series for a single seller at a time.
- [/orders/split](https://sellerapis.snapdeal.com/reference/orderssplit-1.md): This API splits the order into multiple orders. All the "siReferenceCode" of the package has to be provided in the request. Can split only one package at a time.  siReferenceCode : This is associated with item(suborder) level. This value can be fetched from "/orders/new/{packageReferenceCode}" api under packages -> items -> siReferenceCode  After getting response as "split successfully", "orders/new" api has to be called to get the new splitted packages.  Example: If an package contains 4 items (4 suborders) and we want to split it into 3 packages containing (1,2,1) items, then request will be like in below mentioned example.
- [/orders/trackingDetails](https://sellerapis.snapdeal.com/reference/orderstrackingdetails-1.md): This API updates the tracking details of an order like courier name, awb no. of the package. Multiple updates are allowed.
- [/oneship/hos](https://sellerapis.snapdeal.com/reference/oneshiphos-1.md): This API creates HOS handover with the given order codes. Here orderCodes means packageReferenceCode
- [/oneship/hos/{id}](https://sellerapis.snapdeal.com/reference/oneshiphosid-1.md): This API adds orders to an existing HOS handover. Here orderCodes means packageReferenceCode
- [/oneship/hos/print](https://sellerapis.snapdeal.com/reference/oneshiphosprint-1.md): This API prints the HOS handover. Can print only single HOS at a time.
- [/oneship/hos/reprint](https://sellerapis.snapdeal.com/reference/oneshiphosreprint.md): This API reprints the HOS handover. Can reprint only single HOS at a time.
- [/vendorself/manifest](https://sellerapis.snapdeal.com/reference/vendorselfmanifest-2.md): This API creates Manifest handover with the given order codes. Here orderCodes means packageReferenceCode
- [/vendorself/manifest/{id}](https://sellerapis.snapdeal.com/reference/vendorselfmanifestid-1.md): This API adds orders to an existing Manifest handover. Here orderCodes means packageReferenceCode
- [/vendorself/manifest/print](https://sellerapis.snapdeal.com/reference/vendorselfmanifestprint-1.md): This API prints the Manifest handover. Can print only single Manifest at a time.
- [/vendorself/manifest/reprint](https://sellerapis.snapdeal.com/reference/vendorselfmanifestreprint-1.md): This API reprints the Manifest handover. Can reprint only single Manifest at a time.
- [/dropship/manifest](https://sellerapis.snapdeal.com/reference/dropshipmanifest-2.md): This API creates Manifest handover with the given order codes. Here orderCodes means packageReferenceCode
- [/dropship/manifest/{id}](https://sellerapis.snapdeal.com/reference/dropshipmanifestid-1.md): This API adds orders to an existing Manifest handover. Here orderCodes means packageReferenceCode
- [/dropship/manifest/print](https://sellerapis.snapdeal.com/reference/dropshipmanifestprint-1.md): This API prints the Manifest handover. Can print only single Manifest at a time.
- [/dropship/manifest/reprint](https://sellerapis.snapdeal.com/reference/dropshipmanifestreprint-1.md): This API reprints the Manifest handover. Can reprint only single Manifest at a time.
- [/ocplus/stn](https://sellerapis.snapdeal.com/reference/ocplusstn-2.md): This API creates STN handover with the given order codes. Here orderCodes means packageReferenceCode
- [/ocplus/stn/{handOverCode}](https://sellerapis.snapdeal.com/reference/ocplusstnsellerocloccode-1.md): This API adds orders to an existing STN handover. Here orderCodes means packageReferenceCode
- [/ocplus/stn/print](https://sellerapis.snapdeal.com/reference/ocplusstnprint-1.md): This API prints the STN handover. Can print only single STN at a time.
- [/ocplus/stn/reprint](https://sellerapis.snapdeal.com/reference/ocplusstnreprint-1.md): This API reprints the STN handover. Can reprint only single STN at a time.
- [/orders/bulk/status](https://sellerapis.snapdeal.com/reference/ordersbulkstatus-1.md): This API updates the status of an order. Multiple updates are allowed.
- [/orders/print](https://sellerapis.snapdeal.com/reference/ordersprint-1.md): This API prints packslip and invoice for given orders.  OrderCodes here means packageReferenceCodes.
- [/orders/reprint](https://sellerapis.snapdeal.com/reference/ordersreprint-1.md): This API reprints packslip and invoice for a given order. Can reprint only single packslip and invoice at a time.
- [Return Management](https://sellerapis.snapdeal.com/reference/description-6.md)
- [/disputes/issuecategories](https://sellerapis.snapdeal.com/reference/disputesissuecategories.md): This Api gives all  Dispute Categories
- [/returns/completed](https://sellerapis.snapdeal.com/reference/returnscompleted.md): This API will provide all completed returns of seller  in the given date range
- [/returns/completed/suborder/{subOrderId}](https://sellerapis.snapdeal.com/reference/returnscompletedsubordersuborderid.md): This API will provides Completed Returns Details Of Given SubOrderId
- [/returns/pending](https://sellerapis.snapdeal.com/reference/returnspending.md): This API will provide all  pending returns of seller in the given date range
- [/returns/pending/suborder/{subOrderId}](https://sellerapis.snapdeal.com/reference/returnspendingsubordersuborderid.md): This API will provides Pending Returns Details Of Given SubOrderId
- [/oneship/rtv/{rtvListCode}/packs](https://sellerapis.snapdeal.com/reference/oneshiprtvrtvlistcodepacks.md): This API  Returns All the OneShip Center Return packages for given rtvListCode
- [/ocplus/rtv/{rtvListCode}/packs](https://sellerapis.snapdeal.com/reference/ocplusrtvrtvlistcodepacks.md): This API  Returns All the OcPlus Center Return packages for given rtvListCode
- [/returns/courier/status](https://sellerapis.snapdeal.com/reference/courierstatus.md): This API updates the courier return status. Allowed returnAction is ACCEPT for now. Multiple updates are allowed.
- [/returns/oneship/status](https://sellerapis.snapdeal.com/reference/returnsoneshipstatus.md): This API updates the oneship return status. Allowed returnAction is ACCEPT for now. Multiple updates are allowed.
- [/returns/ocplus/status](https://sellerapis.snapdeal.com/reference/returnsocplusstatus.md): This API updates the OCPlus return status. Allowed returnAction is ACCEPT for now. Multiple updates are allowed.
- [/returns/buyer/status](https://sellerapis.snapdeal.com/reference/returnsbuyerstatus.md): This API updates the buyer return status. Allowed returnAction is ACCEPT for now. Multiple updates are allowed.
- [Payment Management](https://sellerapis.snapdeal.com/reference/description-7.md)
- [/payments/commissioninvoice](https://sellerapis.snapdeal.com/reference/paymentscommissioninvoice.md): This API returns commission invoice list of a seller in a given date range.
- [/payments](https://sellerapis.snapdeal.com/reference/payments.md): This API returns settled payments list of a seller in a given date range.
- [/payments/transactions](https://sellerapis.snapdeal.com/reference/paymentstransactions.md): This API returns Report id which should be used to get download link to download transactions report. Seller can get transactions report in a range of date.
- [/payments/transactions/reports/{reportId}](https://sellerapis.snapdeal.com/reference/paymentstransactionsreportsreportid.md): This API returns download link for the report related to the given reportId
- [/campaigns/v2/product](https://sellerapis.snapdeal.com/reference/campaignsv2product.md): Creates a Product Ad Campaign for a seller for the supplied SUPCs. Once campaign is created it remains in the Draft state unless seller changes the status.
- [/campaigns/v2/list](https://sellerapis.snapdeal.com/reference/campaignsv2list.md): This returns the list of campaigns along with the corresponding reporting data. Campaigns are filtered according to the statuses, supc and product name passed in the request. Report data is returned for the date range sent in the request.
- [/campaigns/status](https://sellerapis.snapdeal.com/reference/testinput.md): This is used to update the statuses of the campaigns. Multiple campaigns can be updated at a time and status for each is returned in the response array.
- [/billing/neftDetails](https://sellerapis.snapdeal.com/reference/billingneftdetails-1.md): Returns the NEFT Details for fund transfer.
- [/seller/payment/summary](https://sellerapis.snapdeal.com/reference/sellerpaymentsummary.md): Returns different types of amounts for the seller. Funds available, COD limit, eligible limit, percentage of COD eligible for ads etc.
- [/seller/payment](https://sellerapis.snapdeal.com/reference/sellerpayment.md): This is used for adding funds from the COD balance of the seller.
- [/seller/products/v2/list](https://sellerapis.snapdeal.com/reference/sellerproductsv2list-1.md): Returns the paginated list of products details from the supc supplied in the request.
- [/seller/report/summary](https://sellerapis.snapdeal.com/reference/sellerreportsummary.md): Get the summary of report for the seller. It returns total sales, spends and conversions of the seller till now along with his current funds.
- [/seller/getSellerInfo](https://sellerapis.snapdeal.com/reference/sellergetsellerinfo.md): Gets seller details for the email id and seller code passed in the header.
- [/seller/v2/signUp](https://sellerapis.snapdeal.com/reference/sellerv2signup.md): Signs up the seller and create account using the email ID and sellerCode sent in the request.
- [/seller/v2/notification](https://sellerapis.snapdeal.com/reference/sellerv2notification-1.md): Get seller details like ratings, balance and notification message
- [/seller/report/summary/v2](https://sellerapis.snapdeal.com/reference/sellerreportsummaryv2.md): Get key metrics of seller for last 7 days 0 clicks, impressions, conversions etc.
- [/seller/categories/v2](https://sellerapis.snapdeal.com/reference/sellercategoriesv2.md): Get seller side categories for a seller
- [/seller/v2/info](https://sellerapis.snapdeal.com/reference/sellerv2info.md): get seller details to create recurring campaigns and provide loan options.
- [seller/payment/notification](https://sellerapis.snapdeal.com/reference/sellerpaymentnotification.md): Update notification status of the payment transaction entry in DB.
- [/campaigns/anyCampaign](https://sellerapis.snapdeal.com/reference/campaignsanycampaign.md): Returns true if the seller has any campaigns.
- [seller/v1/setupCampaign](https://sellerapis.snapdeal.com/reference/sellerv1setupcampaign.md): Create campaigns based on categories passed in the request.
- [/seller/v1/setupPayment](https://sellerapis.snapdeal.com/reference/sellerv1setuppayment.md): Set up recurring payment for the campaign ID's in the request.
- [/seller](https://sellerapis.snapdeal.com/reference/seller.md): Get seller details corresponding to seller code passed as parameter.
- [/seller/payment/notification](https://sellerapis.snapdeal.com/reference/sellerpaymentnotification-1.md): get seller payment details for a particular seller and mode.

## Changelog
- [1st Feb 2017](https://sellerapis.snapdeal.com/changelog/1st-feb-2017.md)
- [7th Oct 2016](https://sellerapis.snapdeal.com/changelog/7th-oct-2016.md)
- [22nd Aug 2106](https://sellerapis.snapdeal.com/changelog/22nd-aug-2106.md)
- [19th July 2016](https://sellerapis.snapdeal.com/changelog/19th-july-2016.md)
- [21st Jun 2016](https://sellerapis.snapdeal.com/changelog/21st-jun-2016.md)
- [10th Jun 2106](https://sellerapis.snapdeal.com/changelog/10th-jun-2106.md)
- [3rd May 2016](https://sellerapis.snapdeal.com/changelog/3rd-may-2016.md)
- [25th May 2016](https://sellerapis.snapdeal.com/changelog/25th-may-2016.md)