{
  "info": {
    "name": "Phoneo — Partner API (v1)",
    "_postman_id": "phoneo-partner-v1-public",
    "description": "Read-only inventory feed for partner storefronts.\n\n**Every endpoint is a GET.** Your key cannot change anything inside Phoneo.\n\n**Setup**\n1. Import this collection\n2. Import `phoneo-partner-api.postman_environment.json` as an environment\n3. Put your key (`phn_live_...`) in `partnerKey`\n4. Run **Ping** first\n\n**Base URL:** {{baseUrl}}/api/partner/v1\n\nDocs: https://seller.phoneo.in/developers/partner-api\nSupport: support@phoneo.in",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "item": [
    {
      "name": "Partner API (X-Partner-Key)",
      "description": "All partner endpoints. Every one is read-only.",
      "item": [
        {
          "name": "Ping",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Partner-Key",
                "value": "{{partnerKey}}"
              },
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/partner/v1/ping",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "partner",
                "v1",
                "ping"
              ]
            },
            "description": "Checks your key and IP allowlist. Needs no particular permission — call this first."
          }
        },
        {
          "name": "Shops",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Partner-Key",
                "value": "{{partnerKey}}"
              },
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/partner/v1/shops",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "partner",
                "v1",
                "shops"
              ]
            },
            "description": "The shops assigned to you. `handle` identifies a shop; pass it to `/products?shop=`."
          }
        },
        {
          "name": "Products — full catalog (page 1)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Partner-Key",
                "value": "{{partnerKey}}"
              },
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/partner/v1/products?limit=100",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "partner",
                "v1",
                "products"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "100"
                },
                {
                  "key": "cursor",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "shop",
                  "value": "{{shopHandle}}",
                  "disabled": true
                },
                {
                  "key": "source_type",
                  "value": "used_phones",
                  "disabled": true
                },
                {
                  "key": "main_category_id",
                  "value": "",
                  "disabled": true
                }
              ]
            },
            "description": "First full import. Pass `paging.next_cursor` back as `cursor` until `has_more` is false."
          }
        },
        {
          "name": "Products — delta sync (removed included)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Partner-Key",
                "value": "{{partnerKey}}"
              },
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/partner/v1/products?updated_since={{updatedSince}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "partner",
                "v1",
                "products"
              ],
              "query": [
                {
                  "key": "updated_since",
                  "value": "{{updatedSince}}"
                }
              ]
            },
            "description": "The most important call. With `updated_since`, items with `status: \"removed\"` come back too — take them off your site, or a sold phone stays on sale."
          }
        },
        {
          "name": "Product — single",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Partner-Key",
                "value": "{{partnerKey}}"
              },
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/partner/v1/products/{{productKey}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "partner",
                "v1",
                "products",
                "{{productKey}}"
              ]
            },
            "description": "One item by composite key, e.g. `used_phones:1042`. Items outside your scope return 404."
          }
        },
        {
          "name": "Availability — bulk check",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Partner-Key",
                "value": "{{partnerKey}}"
              },
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/partner/v1/products/availability?keys={{productKey}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "partner",
                "v1",
                "products",
                "availability"
              ],
              "query": [
                {
                  "key": "keys",
                  "value": "{{productKey}}"
                }
              ]
            },
            "description": "Call before confirming any order. Comma-separated keys, up to 200."
          }
        },
        {
          "name": "Categories",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Partner-Key",
                "value": "{{partnerKey}}"
              },
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/partner/v1/categories",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "partner",
                "v1",
                "categories"
              ]
            },
            "description": "Categories that currently hold a product you can see."
          }
        }
      ]
    }
  ]
}