{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"41225269-906c-4028-81c8-fd09dd78ecdb","name":"MPE v1","description":"The Marketplace Engine API is organised around [REST principles](http://en.wikipedia.org/wiki/Representational_State_Transfer). It uses predictable resource-oriented URLs, standard HTTP verbs, and response codes. It also accepts and returns [JSON-encoded](https://www.json.org/json-en.html) request and response bodies.\n\n# Authentication\n\nThe Marketplace Engine API uses Oauth2 for authentication. In order to connect and authenticate with the API and begin consuming endpoints and receiving responses, you will need an access token. The access token will have to be included in all subsequent requests.\n\nThere are two types of grant access supported by the API that will return the access token:\n\n#### Password Grant Client\n\nThe OAuth 2.0 Password Grant Type is a way to get an access token in the context of a user.\n\nOnce your account is setup you will be provided with a Client ID , Client Secret and user.\n\nThe `/oauth/token` endpoint will return the access token for this grant type.\n\n#### Client Credentials Grant Client\n\nThe OAuth 2.0 Client Credentials Grant Type is suitable for machine-to-machine authentication in order to obtain an access token outside of the context of a user.\n\n> The `/oauth/token` endpoint will return the access token for the grant_type = 'client_credentials' \n  \n\n# Headers\n\n`X-MPE-ORIGIN - required` - It should be the fully qualified domain name of the front end site. e.g mymarketplace.com. The `X-MPE-ORIGIN` request header indicates the hostname that _caused_ the request. For example, if a user agent needs to request resources included in a page, or fetched by scripts that it executes, then the origin of the page must be included in the request.\n\n`X-Locale-ID - optional` - A tenant will be able configure multiple locales to enter and display content in any language. Pass in the `X-Locale-ID` inside the request header to retrieve data only for that locale id else retrieve the content for all locales.\n\n`X-CURRENCY-CODE - optional` - A tenant can configure multiple currencies to enter and display monetary values in. Pass in the `X-Currency-Code` inside the request header to retrieve the monetary values converted to your desired one. Display conversions are performed using exchange rates provided by a third party API ([https://fixer.io/](https://fixer.io/)).","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"15930153","collectionId":"41225269-906c-4028-81c8-fd09dd78ecdb","publishedId":"UV5TEyfM","public":true,"publicUrl":"https://api.docs.markko.me","privateUrl":"https://go.postman.co/documentation/15930153-41225269-906c-4028-81c8-fd09dd78ecdb","customColor":{"top-bar":"171717","right-sidebar":"404040","highlight":"4F46E5"},"documentationLayout":"classic-single-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"dark","themes":[{"name":"dark","logo":null,"colors":{"top-bar":"171717","right-sidebar":"404040","highlight":"4F46E5"}},{"name":"light","logo":null,"colors":{"top-bar":"171717","right-sidebar":"404040","highlight":"4F46E5"}}]}},"version":"8.10.1","publishDate":"2024-05-14T09:23:46.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":null,"logoDark":null}},"statusCode":200},"environments":[{"name":"MPE DOCUMENTATION","id":"4192a7ed-3327-4434-92ba-59cb63d88a54","owner":"15930153","values":[{"key":"base_path","value":"https://api.markko.me","enabled":true},{"key":"client_id","value":"your-client-id","enabled":true},{"key":"client_secret","value":"your-client-secret","enabled":true},{"key":"access_token","value":null,"enabled":true},{"key":"bearer_token","value":"","enabled":true},{"key":"refresh_token","value":null,"enabled":true},{"key":"x-mpe-origin","value":"markko.me","enabled":true},{"key":"x-mpe-dashboard-origin","value":"dashboard.markko.me","enabled":true},{"key":"client_cc_id","value":"your-cc-client-id","enabled":true,"type":"default"},{"key":"client_cc_secret","value":"your-cc-client-secret","enabled":true,"type":"default"},{"key":"customer_email","value":"your-email","enabled":true,"type":"default"},{"key":"customer_password","value":"your-password","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/768118b36f06c94b0306958b980558e6915839447e859fe16906e29d683976f0","favicon":"https://markko.me/favicon.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":"MPE DOCUMENTATION","value":"15930153-4192a7ed-3327-4434-92ba-59cb63d88a54"}],"canonicalUrl":"https://api.docs.markko.me/view/metadata/UV5TEyfM"}