{"info":{"_postman_id":"4477aff6-b762-48ac-8e9c-0f92d0a3de45","name":"Getmobil Marketplace API | v1","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"description":"<html><head></head><body></body></html>","owner":"38975909","collectionId":"4477aff6-b762-48ac-8e9c-0f92d0a3de45","publishedId":"2sB3dMyBfv","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-12-23T07:09:16.000Z"},"item":[{"name":"marketplace","item":[{"name":"v1","item":[{"name":"auth","item":[{"name":"/marketplace/v1/auth (Authentication)","id":"95f4fd75-c9fc-4d1f-87cc-8b0ba1cc4fe8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"client_id\": 15,\n    \"client_secret\": \"4VoN3OrfiHGVoPg9dsLUiccG7ALdhNky\"\n}","options":{"raw":{"language":"json"}}},"url":"{{basePublicUrl}}/marketplace/v1/auth","description":"<p>Summary<br />Obtain an access token for Getmobil Marketplace Public API usage.</p>\n<p>Purpose<br />This endpoint exchanges a client_id and client_secret for a short-lived access_token used to authorize subsequent Marketplace API requests.</p>\n<p>HTTP Method and Endpoint<br />POST {{basePublicUrl}}/marketplace/v1/auth</p>\n<p>Required Headers</p>\n<ul>\n<li>Content-Type: application/json</li>\n</ul>\n<p>Environment Variables</p>\n<ul>\n<li>basePublicUrl: Base public API URL. Set in the active environment (Localhost) and referenced in the request URL.</li>\n</ul>\n<p>Request Body</p>\n<ul>\n<li><p>Content-Type: application/json (raw)</p>\n</li>\n<li><p>Schema<br />  {<br />  \"type\": \"object\",<br />  \"properties\": {</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>      \"client_id\": { \"type\": \"integer\" },\n      \"client_secret\": { \"type\": \"string\" }\n\n</code></pre><p>  },<br />  \"required\": [\"client_id\", \"client_secret\"]<br />  }</p>\n</li>\n<li><p>Example<br />  {<br />  \"client_id\": 15,<br />  \"client_secret\": \"4VoN3OrfiHGVoPg9dsLUiccG7ALdhNky\"<br />  }</p>\n</li>\n</ul>\n<p>Successful Response Example (200 OK)<br />{<br />\"access_token\": \"eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJ...\"<br />}</p>\n<p>Usage Notes</p>\n<ul>\n<li><p>Security: Treat client_id and client_secret as sensitive. Do not commit secrets to source control. Prefer storing via Postman variables marked as secret, or in a secure vault.</p>\n</li>\n<li><p>Token Handling: On success, store access_token in an environment variable (e.g., token) and send it as an Authorization header (Bearer ) on subsequent requests.<br />  Example test snippet:<br />  pm.test(\"Store access token\", function () {<br />  const json = pm.response.json();<br />  pm.expect(json.access_token).to.exist;<br />  pm.environment.set(\"token\", json.access_token);<br />  });</p>\n</li>\n<li><p>Error Handling: Common errors include 400 (invalid body), 401/403 (invalid credentials), and 429 (rate limited). Inspect response body for error details and ensure the basePublicUrl points to the correct environment.</p>\n</li>\n<li><p>Expiry/Refresh: If tokens expire, call this endpoint again to obtain a new token.</p>\n</li>\n<li><p>Rate Limits: Respect any documented rate limits to avoid throttling.</p>\n</li>\n</ul>\n","urlObject":{"path":["marketplace","v1","auth"],"host":["{{basePublicUrl}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"95f4fd75-c9fc-4d1f-87cc-8b0ba1cc4fe8"}],"id":"52f84715-787b-4bfd-89f2-1a708e66192c","description":"<p>{{basePublicUrl}}</p>\n","_postman_id":"52f84715-787b-4bfd-89f2-1a708e66192c"},{"name":"sku","item":[{"name":"/marketplace/v1/sku (Fetch Sku List To Map)","id":"073687f5-7ac2-48e7-a260-df377cc73b40","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{vault:authorization-secret}}"}]},"isInherited":false},"method":"GET","header":[],"url":"{{basePublicUrl}}/marketplace/v1/sku","description":"<p><strong>Description</strong></p>\n<p>Returns a paginated list of SKUs that can be used to map products in the marketplace.</p>\n<p><strong>Auth</strong></p>\n<p>Bearer Token required. - {{vault:authorization-secret}}</p>\n<p><strong>Query Parameters (optional)</strong></p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Required</th>\n<th>Type</th>\n<th>Example</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>pageNumber</td>\n<td>No</td>\n<td>integer</td>\n<td>1</td>\n<td>Page index</td>\n</tr>\n<tr>\n<td>pageSize</td>\n<td>No</td>\n<td>integer</td>\n<td>20</td>\n<td>Number of items per page</td>\n</tr>\n</tbody>\n</table>\n</div><p><strong>Success Response (200)</strong></p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>{\n        \"sku\": \"9999010120013\",\n        \"title\": \"Apple iPhone 11 - 128 GB - Beyaz\"\n    },\n    {\n        \"sku\": \"9999110120013\",\n        \"title\": \"Apple iPhone 11 - 128 GB - Beyaz\"\n    },\n    {\n        \"sku\": \"9999010130013\",\n        \"title\": \"Apple iPhone 11 - 128 GB - Beyaz\"\n    },\n    ....\n\n</code></pre>","urlObject":{"path":["marketplace","v1","sku"],"host":["{{basePublicUrl}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"073687f5-7ac2-48e7-a260-df377cc73b40"},{"name":"/marketplace/v1/sku/:sku (Fetch Single Sku)","id":"e7e9e25a-6b62-4ab1-95a4-4415446a27e1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{vault:authorization-secret}}"}]},"isInherited":false},"method":"GET","header":[],"url":"{{basePublicUrl}}/marketplace/v1/sku/:sku","description":"<p><strong>Description</strong></p>\n<p>Returns detailed information for a single SKU.</p>\n<p><strong>Auth</strong></p>\n<p>Bearer Token required. - {{vault:authorization-secret}}</p>\n<p><strong>Path Parameters</strong></p>\n<ul>\n<li><code>sku</code> – SKU stock code of the product.</li>\n</ul>\n<p><strong>Success Response (200)</strong></p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>{\n    \"sku\": \"9999010120013\",\n    \"title\": \"Apple iPhone 11 - 128 GB - Beyaz\"\n}\n\n</code></pre><p><strong>Errors</strong></p>\n<ul>\n<li>404 if SKU does not exist.</li>\n</ul>\n","urlObject":{"path":["marketplace","v1","sku",":sku"],"host":["{{basePublicUrl}}"],"query":[],"variable":[{"type":"any","value":"9999010120013","key":"sku"}]}},"response":[],"_postman_id":"e7e9e25a-6b62-4ab1-95a4-4415446a27e1"}],"id":"e8fa1c50-5440-4616-ab1b-4f6ca224d968","_postman_id":"e8fa1c50-5440-4616-ab1b-4f6ca224d968","description":""},{"name":"devices","item":[{"name":"/marketplace/v1/devices (List Devices)","id":"4ef85c99-d80c-4bde-828a-e0647a98d493","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{vault:authorization-secret}}"}]},"isInherited":false},"method":"GET","header":[],"url":"{{basePublicUrl}}/marketplace/v1/devices?pageNumber=1&pageSize=5","description":"<p><strong>Description</strong></p>\n<p>Returns a paginated list of partner devices registered in the marketplace.</p>\n<p><strong>Auth</strong></p>\n<p>Bearer Token required.</p>\n<p><strong>Query Parameters (optional)</strong></p>\n<ul>\n<li><p><code>pageNumber</code> (integer) – Page index (starting from 1).</p>\n</li>\n<li><p><code>pageSize</code> (integer) – Items per page.</p>\n</li>\n</ul>\n<p><strong>Success Response (200)</strong></p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>{\n    \"current_page\": 1,\n    \"page_size\": 5,\n    \"total_items\": 20,\n    \"total_pages\": 4,\n    \"items\": [\n        {\n            \"id\": 46270818,\n            \"manufacturer\": \"Apple\",\n            \"device_name\": \"iPhone 12 Pro\",\n            \"sku\": \"9999010110087\",\n            \"imei\": \"031220250000011\",\n            \"storage\": \"128 GB\",\n            \"color\": \"Pasifik Mavisi\",\n            \"vendor_name\": \"ApiUserVendor\",\n            \"vendor_id\": 1266,\n            \"vendor_price\": 54321,\n            \"created_at\": \"2025-12-03T07:00:55\"\n        },\n        {\n            \"id\": 46270819,\n            \"manufacturer\": \"Apple\",\n            \"device_name\": \"iPhone 12 Pro\",\n            \"sku\": \"9999010110087\",\n            \"imei\": \"031220250000012\",\n            \"storage\": \"128 GB\",\n            \"color\": \"Pasifik Mavisi\",\n            \"vendor_name\": \"ApiUserVendor\",\n            \"vendor_id\": 1266,\n            \"vendor_price\": 54321,\n            \"created_at\": \"2025-12-03T07:13:56\"\n        },\n        {\n            \"id\": 46270820,\n            \"manufacturer\": \"Apple\",\n            \"device_name\": \"iPhone 13\",\n            \"sku\": \"9999010140111\",\n            \"imei\": \"031220250000013\",\n            \"storage\": \"256 GB\",\n            \"color\": \"Yıldız Işığı\",\n            \"vendor_name\": \"ApiUserVendor\",\n            \"vendor_id\": 1266,\n            \"vendor_price\": 22222,\n            \"created_at\": \"2025-12-03T07:14:51\"\n        },\n        {\n            \"id\": 46270821,\n            \"manufacturer\": \"Apple\",\n            \"device_name\": \"iPhone 13\",\n            \"sku\": \"9999010140111\",\n            \"imei\": \"031220250000014\",\n            \"storage\": \"256 GB\",\n            \"color\": \"Yıldız Işığı\",\n            \"vendor_name\": \"ApiUserVendor\",\n            \"vendor_id\": 1266,\n            \"vendor_price\": 22222,\n            \"created_at\": \"2025-12-03T07:18:05\"\n        },\n        {\n            \"id\": 46270822,\n            \"manufacturer\": \"Apple\",\n            \"device_name\": \"iPhone 13\",\n            \"sku\": \"9999010140111\",\n            \"imei\": \"031220250000015\",\n            \"storage\": \"256 GB\",\n            \"color\": \"Yıldız Işığı\",\n            \"vendor_name\": \"ApiUserVendor\",\n            \"vendor_id\": 1266,\n            \"vendor_price\": 22222,\n            \"created_at\": \"2025-12-03T07:23:26\"\n        }\n    ]\n}\n\n</code></pre>","urlObject":{"path":["marketplace","v1","devices"],"host":["{{basePublicUrl}}"],"query":[{"key":"pageNumber","value":"1"},{"key":"pageSize","value":"5"}],"variable":[]}},"response":[],"_postman_id":"4ef85c99-d80c-4bde-828a-e0647a98d493"},{"name":"/marketplace/v1/devices (Create Device)","id":"181037c4-3075-49a0-b24b-32dcc8d367f4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{vault:authorization-secret}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n    \"sku\": \"9999010120013\",\n    \"sell_price\": 25000,\n    \"imei\": \"22322343244234299\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"{{basePublicUrl}}/marketplace/v1/devices","description":"<p><strong>Description</strong></p>\n<p>Registers a single device in the marketplace inventory.</p>\n<p><strong>Auth</strong></p>\n<p>Bearer Token required. - {{vault:authorization-secret}}</p>\n<p><strong>Request Body (JSON)</strong></p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>{\n    \"sku\": \"9999010120013\",\n    \"sell_price\": 25000,\n    \"imei\": \"22322343244234299\"\n}\n\n</code></pre><p><strong>Business Rules</strong></p>\n<ul>\n<li><p><code>imei</code> must be unique.</p>\n</li>\n<li><p><code>sell_price</code> must be a positive integer.</p>\n</li>\n</ul>\n<p><strong>Success Response (200)</strong></p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>200 OK\n\n</code></pre><p><strong>Errors</strong></p>\n<ul>\n<li>422 if IMEI already exists or validation fails.</li>\n</ul>\n","urlObject":{"path":["marketplace","v1","devices"],"host":["{{basePublicUrl}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"181037c4-3075-49a0-b24b-32dcc8d367f4"},{"name":"/marketplace/v1/devices/batch (Create Batch Devices)","id":"cf1caea5-82db-41ac-be7c-f4eac6541923","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{vault:authorization-secret}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n    \"devices\": [\n        {\n            \"sku\": \"9999010120013\",\n            \"sell_price\": 25000,\n            \"imei\": \"223223432442311112\"\n        },\n        {\n            \"sku\": \"9999010120014\",\n            \"sell_price\": 10000,\n            \"imei\": \"223223432442341111\"\n        }\n    ]\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"{{basePublicUrl}}/marketplace/v1/devices/batch","description":"<p><strong>Description</strong></p>\n<p>Registers multiple devices in a single request.</p>\n<p><strong>Auth</strong></p>\n<p>Bearer Token required.</p>\n<p><strong>Request Body (JSON)</strong></p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>{\n  \"devices\": [\n    {\n      \"sku\": \"9999110243795\",\n      \"sell_price\": 23456,\n      \"imei\": \"351234567890111\"\n    },\n    {\n      \"sku\": \"9999110243796\",\n      \"sell_price\": 34567,\n      \"imei\": \"351234567890222\"\n    }\n  ]\n}\n\n</code></pre><p><strong>Business Rules</strong></p>\n<ul>\n<li><p>All IMEIs in the batch must be unique.</p>\n</li>\n<li><p>Each device must follow the same rules as <code>Create Device</code>.</p>\n</li>\n</ul>\n<p><strong>Success Response (200/201)</strong></p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>200 OK\n\n</code></pre><p><strong>Errors</strong></p>\n<ul>\n<li>422 with message like if imei entered more than one.<br />   \"title\": \"Lütfen girilen imei bilgilerini kontrol ediniz aynı imeiden 1 den fazla girilemez\",}</li>\n</ul>\n","urlObject":{"path":["marketplace","v1","devices","batch"],"host":["{{basePublicUrl}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"cf1caea5-82db-41ac-be7c-f4eac6541923"},{"name":"/marketplace/v1/devices/:sku/price (Update Price Of Sku)","id":"f1e9998c-1659-4912-80c8-9672e3edd925","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"body":{"mode":"formdata","formdata":[]},"url":"{{basePublicUrl}}/marketplace/v1/devices/:sku/price","description":"<p><strong>Description</strong></p>\n<p>Updates the selling price for all devices belonging to a specific SKU.</p>\n<hr />\n<h3 id=\"auth\">Auth</h3>\n<p>Bearer Token required.</p>\n<hr />\n<h3 id=\"path-parameters\">Path Parameters</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Required</th>\n<th>Example</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>sku</code></td>\n<td>string</td>\n<td>✔</td>\n<td>9999010120013</td>\n<td>SKU of the devices to update</td>\n</tr>\n</tbody>\n</table>\n</div><p>Postman URL örneği:<br /><code>/marketplace/v1/devices/</code>9999010120013<code>/price</code></p>\n<hr />\n<h3 id=\"request-body-json\">Request Body (JSON)</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>{\n  \"sell_price\": 39999\n}\n\n</code></pre><p><strong>Validation Rules</strong></p>\n<ul>\n<li><p><code>sell_price</code> must be a positive integer</p>\n</li>\n<li><p>SKU must exist for this partner</p>\n</li>\n</ul>\n<hr />\n<h3 id=\"success-response-200\">Success Response (200)</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>200 OK\n\n</code></pre><hr />\n<h3 id=\"❌-error-responses\">❌ Error Responses</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Status</th>\n<th>Meaning</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>400</td>\n<td>Bad Request</td>\n<td>Invalid or missing body</td>\n</tr>\n<tr>\n<td>404</td>\n<td>Not Found</td>\n<td>SKU not found for partner</td>\n</tr>\n<tr>\n<td>422</td>\n<td>Validation Error</td>\n<td>Price constraints violated</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h2 id=\"🔎-summary\">🔎 Summary</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Feature</th>\n<th>Status</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>Body</td>\n<td>✔ Required</td>\n</tr>\n<tr>\n<td>Path Variable</td>\n<td>✔ Required</td>\n</tr>\n<tr>\n<td>Query Params</td>\n<td>❌ Not used</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"path":["marketplace","v1","devices",":sku","price"],"host":["{{basePublicUrl}}"],"query":[],"variable":[{"type":"any","value":"9999010120013","key":"sku"}]}},"response":[],"_postman_id":"f1e9998c-1659-4912-80c8-9672e3edd925"},{"name":"/marketplace/v1/devices/:deviceId/price (Delete Device)","id":"46a75c7d-42b0-4aa1-8eab-e1aafd3cec0b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{vault:authorization-secret}}"}]},"isInherited":false},"method":"DELETE","header":[],"body":{"mode":"raw","raw":"{\n    \"sell_price\": 34000\n}","options":{"raw":{"language":"json"}}},"url":"{{basePublicUrl}}/marketplace/v1/devices/:deviceId","description":"<p><strong>(Delete Device by Trade-In Device ID)</strong></p>\n<p><strong>Description</strong></p>\n<p>Removes the device from sale by deleting its marketplace registration using the Trade-in device identifier.</p>\n<p>Once removed, the device becomes unavailable in the marketplace.</p>\n<hr />\n<h3 id=\"auth\">Auth</h3>\n<p>Bearer Token required.</p>\n<hr />\n<h3 id=\"path-parameters\">Path Parameters</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Required</th>\n<th>Example</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>deviceId</code></td>\n<td>integer</td>\n<td>✔</td>\n<td><code>20211999</code></td>\n<td>Unique Trade-in Device ID assigned during creation</td>\n</tr>\n</tbody>\n</table>\n</div><p>Example Request URL:<br /><code>/marketplace/v1/devices/20211999/price</code></p>\n<hr />\n<h3 id=\"request-body\">Request Body</h3>\n<p>No body required.</p>\n<p>(Ensure <em>raw body</em> is empty)</p>\n<p>Params : deviceId - tradein_id</p>\n<hr />\n<h3 id=\"success-response-200\">Success Response (200)</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>{\n  \"deviceId\": 20211999,\n}\n\n</code></pre><hr />\n<h3 id=\"error-responses\">Error Responses</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Status</th>\n<th>Meaning</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>404</td>\n<td>Not Found</td>\n<td>There is no any data.</td>\n</tr>\n<tr>\n<td>401/403</td>\n<td>Unauthorized</td>\n<td>Missing or invalid token</td>\n</tr>\n<tr>\n<td>405</td>\n<td>Method Not Allowed</td>\n<td>Endpoint may not be enabled in this environment</td>\n</tr>\n<tr>\n<td>500+</td>\n<td>Server Error</td>\n<td>Marketplace internal issue</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h3 id=\"notes\">Notes</h3>\n<ul>\n<li><p>Device must exist and be <strong>previously created</strong> via <code>/devices</code> or <code>/devices/batch</code></p>\n</li>\n<li><p>After deletion, device cannot be listed or sold until re-added</p>\n</li>\n</ul>\n<hr />\n<h3 id=\"tldr\">TL;DR</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Feature</th>\n<th>Status</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>Path Param <code>deviceId</code></td>\n<td>✔ Required</td>\n</tr>\n<tr>\n<td>Body</td>\n<td>❌ Not used</td>\n</tr>\n<tr>\n<td>Effect</td>\n<td>Device will be removed from database.</td>\n</tr>\n</tbody>\n</table>\n</div><p><strong>404 NOT FOUND EXPLANATION</strong></p>\n<p>{<br />\"title\": \"Cihaz bulunamadı\",<br />\"status\": 404,<br />\"trace_id\": \"00-b7fbbb7a2d4c3782268a4f3a66974dd5-0b2369938972f482-00\"<br />}</p>\n","urlObject":{"path":["marketplace","v1","devices",":deviceId"],"host":["{{basePublicUrl}}"],"query":[],"variable":[{"type":"any","value":"45685519","key":"deviceId"}]}},"response":[],"_postman_id":"46a75c7d-42b0-4aa1-8eab-e1aafd3cec0b"}],"id":"9184340b-45f9-403b-bc6f-f291f044fb13","_postman_id":"9184340b-45f9-403b-bc6f-f291f044fb13","description":""},{"name":"orders","item":[{"name":"/marketplace/v1/orders (List Orders)","id":"892491ce-890c-45f4-89d7-570018a7731c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{vault:authorization-secret}}"}]},"isInherited":false},"method":"GET","header":[],"url":"{{basePublicUrl}}/marketplace/v1/orders?pageNumber=1&pageSize=50&state=NEW&startDate=1974-08-29T17:30:31.774Z&endDate=2025-08-29T17:30:31.774Z","description":"<p><strong>Description</strong></p>\n<p>Returns a paginated list of orders created for the partner.</p>\n<p><strong>Auth</strong></p>\n<p>Bearer Token required.</p>\n<p><strong>Query Parameters</strong></p>\n<ul>\n<li><p><code>pageNumber</code> (integer) - starts from 1</p>\n</li>\n<li><p><code>pageSize</code> (integer)</p>\n</li>\n<li><p>Optional filters: <code>state</code>, startDate, endDate, etc.</p>\n</li>\n</ul>\n<p><strong>Success Response (200)</strong></p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>{\n  \"metadata\": {\n    \"new_count\": 1,\n    \"shipped_count\": 0,\n    \"cancelled_count\": 0,\n    \"delivered_count\": 0,\n    \"could_not_delivered_count\": 0\n  },\n  \"items\": [\n    {\n      \"package_id\": 4776,\n      \"order_number\": \"ONGMN977008153\",\n      \"cargo_state\": \"Preparing\",\n      \"created_at\": \"2025-12-03T13:45:56.183908\",\n      \"customer\": {\n        \"name\": \"Lorin Test\",\n        \"phone\": \"5392295086\",\n        \"email\": \"lorintest@getmobil.com\"\n        ....\n      }\n    }\n  ]\n}\n\n</code></pre>","urlObject":{"path":["marketplace","v1","orders"],"host":["{{basePublicUrl}}"],"query":[{"key":"pageNumber","value":"1"},{"key":"pageSize","value":"50"},{"key":"state","value":"NEW"},{"description":{"content":"<p>ISO 8601 UTC datetime</p>\n","type":"text/plain"},"key":"startDate","value":"1974-08-29T17:30:31.774Z"},{"description":{"content":"<p>ISO 8601 UTC datetime</p>\n","type":"text/plain"},"key":"endDate","value":"2025-08-29T17:30:31.774Z"},{"disabled":true,"key":"orderNumber","value":"string"}],"variable":[]}},"response":[],"_postman_id":"892491ce-890c-45f4-89d7-570018a7731c"},{"name":"/marketplace/v1/orders/:packageId (Get Order Detail)","id":"3c666a20-ad69-45d5-8cb3-a56abfde1dc2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{vault:authorization-secret}}"}]},"isInherited":false},"method":"GET","header":[],"url":"{{basePublicUrl}}/marketplace/v1/orders/:packageId","description":"<p><strong>Description</strong></p>\n<p>Returns detailed information for a specific order/package.</p>\n<p><strong>Auth</strong></p>\n<p>Bearer Token required.</p>\n<p><strong>Path Parameters</strong></p>\n<ul>\n<li><code>packageId</code> (string) – Unique package/order identifier.</li>\n</ul>\n<p><strong>Success Response (200)</strong></p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>{\n    \"package_id\": 4776,\n    \"order_number\": \"ONGMN97708153\",\n    \"cargo_state\": \"Preparing\",\n    \"created_at\": \"2025-12-03T13:45:56.183908\",\n    \"customer\": {\n        \"name\": \"Lorn Test\",\n        \"phone\": \"5392295806\",\n        \"email\": \"lorin@getmobil.com\",\n        \"delivery_address\": \"adres tarihi / AŞAĞIBELEMEDİK MAHALLESİ / KARAİSALI / ADANA\"\n    },\n    \"items\": [\n        {\n            \"sku\": \"9999010120013\",\n            \"title\": \"Apple iPhone 11 - 128 GB - Beyaz\",\n            \"price\": 25000,\n            \"brand\": \"Apple\",\n            \"model\": \"Apple iPhone 11 128 GB\",\n            \"condition\": \"fair\"\n        }\n    ],\n    \"tracking_number\": null,\n    \"tracking_url\": null\n}\n\n</code></pre><p><strong>Errors</strong></p>\n<ul>\n<li>404 if package not found.</li>\n</ul>\n","urlObject":{"path":["marketplace","v1","orders",":packageId"],"host":["{{basePublicUrl}}"],"query":[],"variable":[{"type":"any","value":"1","key":"packageId"}]}},"response":[],"_postman_id":"3c666a20-ad69-45d5-8cb3-a56abfde1dc2"},{"name":"/marketplace/v1/orders/:packageId/shipment (Create Shipment Label)","id":"52ba7a90-0fee-4bec-a777-2adc09522353","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{vault:authorization-secret}}"}]},"isInherited":false},"method":"POST","header":[],"url":"{{basePublicUrl}}/marketplace/v1/orders/:packageId/shipment?provider=","description":"<p><strong>Description</strong></p>\n<p>Creates a shipment / cargo label for a given package using the selected provider.</p>\n<p><strong>Auth</strong></p>\n<p>Bearer Token required.</p>\n<p><strong>Path Parameters</strong></p>\n<ul>\n<li><code>packageId</code> – Package identifier.</li>\n</ul>\n<p><strong>Query Parameters</strong></p>\n<ul>\n<li><code>provider</code> – Shipment provider code (e.g. <code>YURTICI</code>).</li>\n</ul>\n<p><strong>Request Body</strong></p>\n<p>Usually empty, unless otherwise specified in the integration spec.</p>\n<p><strong>Success Response (200)</strong></p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>{\n  \"trackingNumber\": \"YT123456789TR\",\n}\n\n</code></pre><p><strong>Errors</strong></p>\n<ul>\n<li><p>400/422 if package is not eligible for shipment.</p>\n</li>\n<li><p>502 if underlying shipment service / provider is unavailable.</p>\n</li>\n</ul>\n","urlObject":{"path":["marketplace","v1","orders",":packageId","shipment"],"host":["{{basePublicUrl}}"],"query":[{"key":"provider","value":""}],"variable":[{"type":"any","value":"1","key":"packageId"}]}},"response":[],"_postman_id":"52ba7a90-0fee-4bec-a777-2adc09522353"},{"name":"/marketplace/v1/orders/:packageId/invoice (Load Invoice to Order)","id":"1967178b-ea1e-4016-ae5d-bdb5f60c7e79","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{vault:authorization-secret}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"multipart/form-data"}],"body":{"mode":"formdata","formdata":[{"key":"invoice","type":"file","value":null},{"key":"invoiceNumber","value":"INV1234","type":"text","uuid":"aa325bea-8336-416c-a034-dbbe5d442f2f"}]},"url":"{{basePublicUrl}}/marketplace/v1/orders/:packageId/invoice","description":"<p><strong>Description</strong></p>\n<p>Uploads or triggers generation of an invoice file for the given package.</p>\n<p><strong>Auth</strong></p>\n<p>Bearer Token required.</p>\n<p>Body</p>\n<p><strong>Path Parameters</strong></p>\n<ul>\n<li><code>packageId</code> (string).</li>\n</ul>\n<p><strong>Request Body - Form data</strong></p>\n<p>Invoice - file or img</p>\n<p>Invoice id - text or string</p>\n<p><strong>Success Response (200)</strong></p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>{\n 200 OK\n}\n\n</code></pre><hr />\n<p><strong>422 Unprocessable Entity</strong></p>\n<p>{ \"title\": \"Aktif bir fatura zaten mevcut. Yeni fatura oluşturamazsınız.\",</p>\n<p>\"status\": 422,</p>\n<p>\"trace_id\": \"00-7af1161be0f63867e1740a3763342b1f-02ffe57ff54eaec1-00\"}</p>\n","urlObject":{"path":["marketplace","v1","orders",":packageId","invoice"],"host":["{{basePublicUrl}}"],"query":[],"variable":[{"type":"any","value":"-762325","key":"packageId"}]}},"response":[],"_postman_id":"1967178b-ea1e-4016-ae5d-bdb5f60c7e79"}],"id":"23c7d741-efde-4e0b-a85b-f9b19e3b9de2","_postman_id":"23c7d741-efde-4e0b-a85b-f9b19e3b9de2","description":""},{"name":"webhooks","item":[{"name":"/marketplace/v1/webhooks (Get Order Webhook Url)","id":"80bc859d-c51f-4a60-ba95-55caf30ad9c4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{vault:authorization-secret}}"}]},"isInherited":false},"method":"GET","header":[],"url":"{{basePublicUrl}}/marketplace/v1/webhooks","description":"<p><strong>Description</strong></p>\n<p>Returns the active webhook configuration for the partner.</p>\n<p><strong>Auth</strong></p>\n<p>Bearer Token required.</p>\n<p><strong>Success Response (200)</strong></p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>{\n    \"order_webhook_url\": \"https://getmobil-webhook.com/webhook/order\"\n}\n\n</code></pre><hr />\n","urlObject":{"path":["marketplace","v1","webhooks"],"host":["{{basePublicUrl}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"80bc859d-c51f-4a60-ba95-55caf30ad9c4"},{"name":"/marketplace/v1/webhooks (Update Order Webhook Url)","id":"ab0ab564-a293-4b10-b64d-d2ce48299c3f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{vault:authorization-secret}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"url\": \"https://getmobil-webhook.com/webhook/order\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"{{basePublicUrl}}/marketplace/v1/webhooks","description":"<p><strong>Description</strong></p>\n<p>Creates or updates webhook URLs used by Getmobil to notify the partner about events.</p>\n<p><strong>Auth</strong></p>\n<p>Bearer Token required.</p>\n<p><strong>Request Body (JSON)</strong></p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>{\n\"url\": \"https://getmobil-webhook.com/webhook/order\"\n}\n\n</code></pre><p><strong>Success Response (200)</strong></p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>{\n  200 OK\n}\n\n</code></pre><hr />\n","urlObject":{"path":["marketplace","v1","webhooks"],"host":["{{basePublicUrl}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"ab0ab564-a293-4b10-b64d-d2ce48299c3f"}],"id":"81056c25-dae9-4578-bbc4-40ad1c5f13a9","_postman_id":"81056c25-dae9-4578-bbc4-40ad1c5f13a9","description":""}],"id":"aef9079a-27a8-4ba3-b2a8-d307cce4cd85","_postman_id":"aef9079a-27a8-4ba3-b2a8-d307cce4cd85","description":""}],"id":"2510d4cd-191f-457c-b7d5-0b3c2ebfb87a","_postman_id":"2510d4cd-191f-457c-b7d5-0b3c2ebfb87a","description":""}],"event":[{"listen":"prerequest","script":{"id":"602f44b4-1173-4632-9874-6afaf5884507","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"deb522d1-b31e-4e9b-872f-76cbf13d98a4","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"variable":[{"id":"8d1a199c-8c1d-42bf-ad43-fc76c59ff4a7","key":"baseP","value":"http://localhost:5188/"}]}