{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"20874a59-a59d-430e-b08c-2b6cb17f7f8b","name":"Seller Hub API","description":"# **API Overview**\n\nThe Yavolo API enables external applications to securely interact with the Yavolo platform. It allows you to automate various tasks, including creating products, managing listings, and exporting orders.\n\n# Getting Started\n\nThe fastest way to get started with the Yavolo API is to click the Run in Postman button at the top of this page. All the endpoints documented here are available in the Seller Hub Postman collection.\n\nYou can also explore and interact with the API using our OpenAPI specification, available in JSON format at: [https://resource.yavolo.co.uk/assets/api/yavolo.openapi.json](https://resource.yavolo.co.uk/assets/api/yavolo.openapi.json)\n\nPostman is a free tool that helps developers run and debug API requests. You can download it from [https://www.getpostman.com/](https://www.getpostman.com/).\n\n# Authorization Token Management\n\nThe authorisation token can be managed through the [Connection Manager](https://yavolo.co.uk/seller-hub/account/connections-manager), which allows sellers to maintain control over their API access.\n\nThe Connection Manager can be accessed via the Seller Hub.\n\n# Security Practices\n\nThe authorisation token must be treated with the same level of security as a password and kept strictly confidential. It should never be shared, exposed in code, or stored in publicly accessible locations. If compromised, the token should be revoked and regenerated immediately to prevent unauthorised access.\n\n# Usage Limits\n\nEach request type (**POST, GET, PUT, and DELETE**) has an hourly usage limit, designed to accommodate the needs of most sellers.\n\nIf you find that you are regularly reaching the limit, we may be able to adjust it to better suit your requirements. Please contact the Yavolo Seller Support Team by creating a ticket in the Seller Hub for further assistance.\n\n# Variables\n\nThroughout this documentation, various variables are represented in the format {{name}}. When making API requests, these placeholders must be replaced with the appropriate values.\n\nThe table below provides examples of commonly used variables and the values you should include when calling the relevant endpoints.\n\n| **Variable** | **Example** |\n| --- | --- |\n| {{ baseUrl }} | [https://yavolo.co.uk/api/](https://yavolo.co.uk/api/) |\n| {{ bearerToken }} | Your unique token can be generated in the Seller Hub Connections Manager |\n| {{ deliveryId }} | This is unique to your account, typically this is a whole digit number, for example 42 |\n| {{ productId }} | This is unique to your account, typically this is a whole digit number, for example 458 |\n| {{ orderId }} | This is unique to your account, typically this is a whole digit number, for example 445 |\n\n# Product Upload\n\nThe Yavolo marketplace has a single entry for each product from a manufacturer, with multiple sellers able to list the same product.\n\nThe Yavolo product upload process happens in two parts:\n\n1. **Initial Product Upload** – Sellers must use the **POST** Add Product API to upload the essential information about a product to the Yavolo system.\n    \n\n<img src=\"https://content.pstmn.io/1fa7d3cf-a5d6-42fc-bfe5-d31530a132b3/QVBJLURpYWdyYW0uanBn\">\n\n1. **Attribute & Additional Data Upload** – Once the initial upload is complete, the seller will receive a product ID. They can then use this product ID to call the **GET** Product Detail endpoint, which will return any required category-specific attributes that need to be added. These attributes can then be submitted using the **POST** Update Product API.\n    \n\nThis two-step process ensures that all products are accurately structured with the necessary attributes for their respective categories.\n\n# API Change Log\n\n| **Date** | **Description** |\n| --- | --- |\n| 20th Feb 2025 | Initial API Release |\n| 28th May 2025 | Added example API response |","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"39263213","team":6783547,"collectionId":"20874a59-a59d-430e-b08c-2b6cb17f7f8b","publishedId":"2sAYXFhcAc","public":true,"publicUrl":"https://resource.api.yavolo.co.uk","privateUrl":"https://go.postman.co/documentation/39263213-20874a59-a59d-430e-b08c-2b6cb17f7f8b","customColor":{"top-bar":"f9ede1","right-sidebar":"f9ede1","highlight":"ff6275"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":"The Yavolo API enables external applications to securely interact with the Yavolo platform. It allows you to automate various tasks, including creating products, managing listings, and exporting orders."},{"name":"title","value":"Yavolo Seller API Documentation"}],"appearance":{"default":"dark","themes":[{"name":"dark","logo":"https://content.pstmn.io/0d57159f-c0df-469c-bbba-dc77aa33f9b8/WWF2b2xvX0xvZ29fcGluay5wbmc=","colors":{"top-bar":"640529","right-sidebar":"640529","highlight":"ff6275"}},{"name":"light","logo":"https://content.pstmn.io/0d57159f-c0df-469c-bbba-dc77aa33f9b8/WWF2b2xvX0xvZ29fcGluay5wbmc=","colors":{"top-bar":"f9ede1","right-sidebar":"f9ede1","highlight":"ff6275"}}]}},"version":"8.10.1","publishDate":"2025-02-18T16:14:47.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"Yavolo Seller API Documentation","description":"The Yavolo API enables external applications to securely interact with the Yavolo platform. It allows you to automate various tasks, including creating products, managing listings, and exporting orders."},"logos":{"logoLight":"https://content.pstmn.io/0d57159f-c0df-469c-bbba-dc77aa33f9b8/WWF2b2xvX0xvZ29fcGluay5wbmc=","logoDark":"https://content.pstmn.io/0d57159f-c0df-469c-bbba-dc77aa33f9b8/WWF2b2xvX0xvZ29fcGluay5wbmc="}},"statusCode":200},"environments":[{"name":"Production","id":"9102c1de-c32e-46ea-9b44-36ea301117a0","owner":"39263213","values":[{"key":"baseUrl","value":"","enabled":true,"type":"default"},{"key":"bearerToken","value":"","enabled":true,"type":"default"},{"key":"productId","value":"","enabled":true,"type":"default"},{"key":"deliveryId","value":"","enabled":true,"type":"default"},{"key":"orderId","value":"","enabled":true,"type":"default"}],"published":true}],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/e1b89302786acf56defe1cce33f93a42b3379c9d97ae6e7fcefa5cdf254805ee","favicon":"https://res.cloudinary.com/postman/image/upload/v1739894452/team/8faa8a30780669971a500be330873828.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"},{"label":"Production","value":"39263213-9102c1de-c32e-46ea-9b44-36ea301117a0"}],"canonicalUrl":"https://resource.api.yavolo.co.uk/view/metadata/2sAYXFhcAc"}