{
  "info": {
    "_postman_id": "5e11e5a0-7e5e-4a1e-9b0c-000000000001",
    "name": "resell.store API",
    "description": "Everything you can do in resell.store, your code can do too.\n\nSet the `apiKey` variable to your secret key from resell.store/tools/api. Docs: https://docs.resell.store/api",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.resell.store/v1",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "",
      "type": "secret"
    }
  ],
  "item": [
    {
      "name": "Account",
      "item": [
        {
          "name": "Who this key belongs to",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/me",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "me"
              ]
            },
            "description": "The person behind the key, what the key may do, their shops and how many requests they've made this month. A good first call to check a key works."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "GET",
                "url": "{{baseUrl}}/me"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"account\",\n  \"id\": \"usr_7Qm2\",\n  \"name\": \"Maya Rivera\",\n  \"email\": \"maya@example.com\",\n  \"key\": {\n    \"kind\": \"api\",\n    \"scopes\": [\n      \"read\",\n      \"shops\",\n      \"listings\",\n      \"messages\",\n      \"offers\",\n      \"orders\",\n      \"buying\",\n      \"webhooks\"\n    ],\n    \"ask_first\": [],\n    \"max_offer\": null\n  },\n  \"shops\": [\n    {\n      \"object\": \"shop\",\n      \"slug\": \"maya\",\n      \"name\": \"Maya's closet\",\n      \"url\": \"https://maya.resell.store\"\n    }\n  ],\n  \"usage\": {\n    \"requests\": 1240,\n    \"limit\": 10000\n  }\n}"
            }
          ]
        },
        {
          "name": "What needs you",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/inbox",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "inbox"
              ]
            },
            "description": "Everything waiting on you right now, across all your shops: offers to answer, sales to ship and unread messages from buyers, plus counters waiting on you as a buyer. The same list as the badge in the app."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "GET",
                "url": "{{baseUrl}}/inbox"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"inbox\",\n  \"offers_to_answer\": [\n    {\n      \"object\": \"offer\",\n      \"id\": \"off_1\",\n      \"status\": \"open\",\n      \"amount\": 150,\n      \"listing\": {\n        \"title\": \"Yellow dutch oven, 5.5 qt\"\n      }\n    }\n  ],\n  \"sales_to_ship\": [],\n  \"unread_threads\": 2,\n  \"counters_to_answer\": [],\n  \"unread_as_buyer\": 0\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Shops",
      "item": [
        {
          "name": "List your shops",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/shops",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "shops"
              ]
            },
            "description": "Every shop you own, oldest first, with how many listings are live, drafts and sold."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "GET",
                "url": "{{baseUrl}}/shops"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"list\",\n  \"data\": [\n    {\n      \"object\": \"shop\",\n      \"id\": \"c0a8…\",\n      \"slug\": \"maya\",\n      \"name\": \"Maya's closet\",\n      \"about\": \"Clothes and kitchen things I don't use any more.\",\n      \"category\": \"Clothes\",\n      \"location\": \"Portland, OR\",\n      \"tone\": \"lemon\",\n      \"visibility\": \"public\",\n      \"paused\": false,\n      \"url\": \"https://maya.resell.store\",\n      \"picture_url\": null,\n      \"agent\": {\n        \"answer_questions\": true,\n        \"haggle\": true,\n        \"lowest_percent\": 15,\n        \"ask_hold\": true\n      },\n      \"counts\": {\n        \"live\": 12,\n        \"drafts\": 2,\n        \"sold\": 20\n      },\n      \"created_at\": \"2026-09-03T17:20:00.000Z\"\n    }\n  ],\n  \"total\": 1,\n  \"has_more\": false\n}"
            }
          ]
        },
        {
          "name": "Open a shop",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/shops",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "shops"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Maya's kitchen\",\n  \"slug\": \"maya-kitchen\",\n  \"category\": \"Home\",\n  \"visibility\": \"public\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Opens a new shop at {slug}.resell.store. Slugs are unique across resell.store.\n\nNeeds the `shops` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/shops"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"shop\",\n  \"id\": \"c0a8…\",\n  \"slug\": \"maya-kitchen\",\n  \"name\": \"Maya's kitchen\",\n  \"about\": \"Clothes and kitchen things I don't use any more.\",\n  \"category\": \"Clothes\",\n  \"location\": \"Portland, OR\",\n  \"tone\": \"lemon\",\n  \"visibility\": \"public\",\n  \"paused\": false,\n  \"url\": \"https://maya-kitchen.resell.store\",\n  \"picture_url\": null,\n  \"agent\": {\n    \"answer_questions\": true,\n    \"haggle\": true,\n    \"lowest_percent\": 15,\n    \"ask_hold\": true\n  },\n  \"counts\": {\n    \"live\": 12,\n    \"drafts\": 2,\n    \"sold\": 20\n  },\n  \"created_at\": \"2026-09-03T17:20:00.000Z\"\n}"
            }
          ]
        },
        {
          "name": "Get a shop",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/shops/:slug",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "shops",
                ":slug"
              ],
              "variable": [
                {
                  "key": "slug",
                  "value": "",
                  "description": "The slug."
                }
              ]
            },
            "description": "One of your shops by its slug, with this week's numbers."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "GET",
                "url": "{{baseUrl}}/shops/:slug"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"shop\",\n  \"id\": \"c0a8…\",\n  \"slug\": \"maya\",\n  \"name\": \"Maya's closet\",\n  \"about\": \"Clothes and kitchen things I don't use any more.\",\n  \"category\": \"Clothes\",\n  \"location\": \"Portland, OR\",\n  \"tone\": \"lemon\",\n  \"visibility\": \"public\",\n  \"paused\": false,\n  \"url\": \"https://maya.resell.store\",\n  \"picture_url\": null,\n  \"agent\": {\n    \"answer_questions\": true,\n    \"haggle\": true,\n    \"lowest_percent\": 15,\n    \"ask_hold\": true\n  },\n  \"counts\": {\n    \"live\": 12,\n    \"drafts\": 2,\n    \"sold\": 20\n  },\n  \"created_at\": \"2026-09-03T17:20:00.000Z\",\n  \"stats\": {\n    \"views\": 1606,\n    \"views_7d\": 214,\n    \"followers\": 105,\n    \"likes\": 48,\n    \"shares\": 9,\n    \"offers_waiting\": 2\n  }\n}"
            }
          ]
        },
        {
          "name": "Change a shop",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/shops/:slug",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "shops",
                ":slug"
              ],
              "variable": [
                {
                  "key": "slug",
                  "value": "",
                  "description": "The slug."
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"about\": \"Clothes, shoes and a few kitchen things.\",\n  \"haggle\": true,\n  \"lowest_percent\": 20\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Change any of the shop's settings. Send only what changes. A new `slug` moves the store to a new address.\n\nNeeds the `shops` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "PATCH",
                "url": "{{baseUrl}}/shops/:slug"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"shop\",\n  \"id\": \"c0a8…\",\n  \"slug\": \"maya\",\n  \"name\": \"Maya's closet\",\n  \"about\": \"Clothes and kitchen things I don't use any more.\",\n  \"category\": \"Clothes\",\n  \"location\": \"Portland, OR\",\n  \"tone\": \"lemon\",\n  \"visibility\": \"public\",\n  \"paused\": false,\n  \"url\": \"https://maya.resell.store\",\n  \"picture_url\": null,\n  \"agent\": {\n    \"answer_questions\": true,\n    \"haggle\": true,\n    \"lowest_percent\": 15,\n    \"ask_hold\": true\n  },\n  \"counts\": {\n    \"live\": 12,\n    \"drafts\": 2,\n    \"sold\": 20\n  },\n  \"created_at\": \"2026-09-03T17:20:00.000Z\"\n}"
            }
          ]
        },
        {
          "name": "Delete a shop",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/shops/:slug",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "shops",
                ":slug"
              ],
              "variable": [
                {
                  "key": "slug",
                  "value": "",
                  "description": "The slug."
                }
              ]
            },
            "description": "Deletes the shop, its listings and their photos. This can't be undone. A shop with sales can't be deleted (the orders keep a record of it); pause it instead.\n\nNeeds the `shops` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "DELETE",
                "url": "{{baseUrl}}/shops/:slug"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"shop\",\n  \"slug\": \"maya-kitchen\",\n  \"deleted\": true\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Listings",
      "item": [
        {
          "name": "List your listings",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/listings?status=live&limit=2",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "listings"
              ],
              "query": [
                {
                  "key": "status",
                  "value": "live"
                },
                {
                  "key": "limit",
                  "value": "2",
                  "description": "How many to return, 1 to 100. Default 25."
                },
                {
                  "key": "shop",
                  "value": "",
                  "description": "A shop slug. Leave out for every shop.",
                  "disabled": true
                },
                {
                  "key": "offset",
                  "value": "",
                  "description": "How many to skip, for the next page.",
                  "disabled": true
                }
              ]
            },
            "description": "Listings across your shops, most recently changed first. Filter by shop or status."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "GET",
                "url": "{{baseUrl}}/listings?status=live&limit=2"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"list\",\n  \"data\": [\n    {\n      \"object\": \"listing\",\n      \"id\": \"8d1e6c2a-…\",\n      \"shop\": \"maya\",\n      \"status\": \"live\",\n      \"visibility\": \"everyone\",\n      \"step\": \"publish\",\n      \"name\": \"Le Creuset dutch oven\",\n      \"title\": \"Yellow Le Creuset dutch oven, 5.5 qt\",\n      \"one_liner\": \"The good one, barely used, ready for soup season\",\n      \"description\": \"Bought it for a recipe I made twice. No chips…\",\n      \"category\": \"Kitchen\",\n      \"price\": 185,\n      \"lowest_price\": 160,\n      \"shipping\": 18,\n      \"take_offers\": true,\n      \"fields\": [\n        {\n          \"key\": \"brand\",\n          \"label\": \"Brand\",\n          \"value\": \"Le Creuset\",\n          \"source\": \"agent\"\n        },\n        {\n          \"key\": \"condition\",\n          \"label\": \"Condition\",\n          \"value\": \"Like new\",\n          \"source\": \"you\"\n        }\n      ],\n      \"photos\": [\n        {\n          \"id\": \"3f…\",\n          \"url\": \"https://files.resell.store/…\",\n          \"alt\": null,\n          \"source\": null,\n          \"is_video\": false\n        }\n      ],\n      \"url\": \"https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt\",\n      \"edit_url\": \"https://resell.store/listings/8d1e6c2a-…\",\n      \"stats\": {\n        \"views\": 214,\n        \"views_7d\": 61,\n        \"likes\": 12,\n        \"shares\": 3,\n        \"offers\": 2,\n        \"offers_waiting\": 1\n      },\n      \"research\": {\n        \"identified\": \"Le Creuset Signature round dutch oven, 5.5 qt, Soleil\",\n        \"category\": \"Kitchen\",\n        \"confidence\": \"high\",\n        \"suggested_price\": 185,\n        \"price_range\": {\n          \"low\": 160,\n          \"high\": 210\n        },\n        \"summary\": \"Sells quickly between $160 and $210 in this colour.\"\n      },\n      \"published_at\": \"2026-09-28T16:02:11.000Z\",\n      \"sold_at\": null,\n      \"created_at\": \"2026-09-28T15:40:00.000Z\",\n      \"updated_at\": \"2026-09-28T16:02:11.000Z\"\n    }\n  ],\n  \"total\": 12,\n  \"has_more\": true\n}"
            }
          ]
        },
        {
          "name": "Make a listing",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/listings",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "listings"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"shop\": \"maya\",\n  \"title\": \"Yellow Le Creuset dutch oven, 5.5 qt\",\n  \"price\": 185,\n  \"lowest_price\": 160,\n  \"fields\": {\n    \"Brand\": \"Le Creuset\",\n    \"Condition\": \"Like new\"\n  },\n  \"publish\": true\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Makes a draft in one of your shops. Give it what you know: a `prompt` (\"yellow le creuset dutch oven, 5.5 qt, used twice\") is enough for the research agent to work out the rest; or set the title, price and details yourself. Add `research: true` to look it up and suggest a price (poll GET /listings/:id/research). Add `publish: true` to put it live straight away, if it has a title and a price.\n\nNeeds the `listings` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/listings"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"listing\",\n  \"id\": \"8d1e6c2a-…\",\n  \"shop\": \"maya\",\n  \"status\": \"live\",\n  \"visibility\": \"everyone\",\n  \"step\": \"publish\",\n  \"name\": \"Le Creuset dutch oven\",\n  \"title\": \"Yellow Le Creuset dutch oven, 5.5 qt\",\n  \"one_liner\": \"The good one, barely used, ready for soup season\",\n  \"description\": \"Bought it for a recipe I made twice. No chips…\",\n  \"category\": \"Kitchen\",\n  \"price\": 185,\n  \"lowest_price\": 160,\n  \"shipping\": 18,\n  \"take_offers\": true,\n  \"fields\": [\n    {\n      \"key\": \"brand\",\n      \"label\": \"Brand\",\n      \"value\": \"Le Creuset\",\n      \"source\": \"agent\"\n    },\n    {\n      \"key\": \"condition\",\n      \"label\": \"Condition\",\n      \"value\": \"Like new\",\n      \"source\": \"you\"\n    }\n  ],\n  \"photos\": [\n    {\n      \"id\": \"3f…\",\n      \"url\": \"https://files.resell.store/…\",\n      \"alt\": null,\n      \"source\": null,\n      \"is_video\": false\n    }\n  ],\n  \"url\": \"https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt\",\n  \"edit_url\": \"https://resell.store/listings/8d1e6c2a-…\",\n  \"stats\": {\n    \"views\": 214,\n    \"views_7d\": 61,\n    \"likes\": 12,\n    \"shares\": 3,\n    \"offers\": 2,\n    \"offers_waiting\": 1\n  },\n  \"research\": {\n    \"identified\": \"Le Creuset Signature round dutch oven, 5.5 qt, Soleil\",\n    \"category\": \"Kitchen\",\n    \"confidence\": \"high\",\n    \"suggested_price\": 185,\n    \"price_range\": {\n      \"low\": 160,\n      \"high\": 210\n    },\n    \"summary\": \"Sells quickly between $160 and $210 in this colour.\"\n  },\n  \"published_at\": \"2026-09-28T16:02:11.000Z\",\n  \"sold_at\": null,\n  \"created_at\": \"2026-09-28T15:40:00.000Z\",\n  \"updated_at\": \"2026-09-28T16:02:11.000Z\"\n}"
            }
          ]
        },
        {
          "name": "Get a listing",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/listings/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "listings",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "description": "Everything about one of your listings: its words, details, photos, research and numbers."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "GET",
                "url": "{{baseUrl}}/listings/:id"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"listing\",\n  \"id\": \"8d1e6c2a-…\",\n  \"shop\": \"maya\",\n  \"status\": \"live\",\n  \"visibility\": \"everyone\",\n  \"step\": \"publish\",\n  \"name\": \"Le Creuset dutch oven\",\n  \"title\": \"Yellow Le Creuset dutch oven, 5.5 qt\",\n  \"one_liner\": \"The good one, barely used, ready for soup season\",\n  \"description\": \"Bought it for a recipe I made twice. No chips…\",\n  \"category\": \"Kitchen\",\n  \"price\": 185,\n  \"lowest_price\": 160,\n  \"shipping\": 18,\n  \"take_offers\": true,\n  \"fields\": [\n    {\n      \"key\": \"brand\",\n      \"label\": \"Brand\",\n      \"value\": \"Le Creuset\",\n      \"source\": \"agent\"\n    },\n    {\n      \"key\": \"condition\",\n      \"label\": \"Condition\",\n      \"value\": \"Like new\",\n      \"source\": \"you\"\n    }\n  ],\n  \"photos\": [\n    {\n      \"id\": \"3f…\",\n      \"url\": \"https://files.resell.store/…\",\n      \"alt\": null,\n      \"source\": null,\n      \"is_video\": false\n    }\n  ],\n  \"url\": \"https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt\",\n  \"edit_url\": \"https://resell.store/listings/8d1e6c2a-…\",\n  \"stats\": {\n    \"views\": 214,\n    \"views_7d\": 61,\n    \"likes\": 12,\n    \"shares\": 3,\n    \"offers\": 2,\n    \"offers_waiting\": 1\n  },\n  \"research\": {\n    \"identified\": \"Le Creuset Signature round dutch oven, 5.5 qt, Soleil\",\n    \"category\": \"Kitchen\",\n    \"confidence\": \"high\",\n    \"suggested_price\": 185,\n    \"price_range\": {\n      \"low\": 160,\n      \"high\": 210\n    },\n    \"summary\": \"Sells quickly between $160 and $210 in this colour.\"\n  },\n  \"published_at\": \"2026-09-28T16:02:11.000Z\",\n  \"sold_at\": null,\n  \"created_at\": \"2026-09-28T15:40:00.000Z\",\n  \"updated_at\": \"2026-09-28T16:02:11.000Z\"\n}"
            }
          ]
        },
        {
          "name": "Change a listing",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/listings/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "listings",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"price\": 170,\n  \"fields\": {\n    \"Condition\": \"Very good\"\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Change the words, price, details or who can see it. Send only what changes; `null` clears a field. Changes to a live listing show straight away.\n\nNeeds the `listings` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "PATCH",
                "url": "{{baseUrl}}/listings/:id"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"listing\",\n  \"id\": \"8d1e6c2a-…\",\n  \"shop\": \"maya\",\n  \"status\": \"live\",\n  \"visibility\": \"everyone\",\n  \"step\": \"publish\",\n  \"name\": \"Le Creuset dutch oven\",\n  \"title\": \"Yellow Le Creuset dutch oven, 5.5 qt\",\n  \"one_liner\": \"The good one, barely used, ready for soup season\",\n  \"description\": \"Bought it for a recipe I made twice. No chips…\",\n  \"category\": \"Kitchen\",\n  \"price\": 185,\n  \"lowest_price\": 160,\n  \"shipping\": 18,\n  \"take_offers\": true,\n  \"fields\": [\n    {\n      \"key\": \"brand\",\n      \"label\": \"Brand\",\n      \"value\": \"Le Creuset\",\n      \"source\": \"agent\"\n    },\n    {\n      \"key\": \"condition\",\n      \"label\": \"Condition\",\n      \"value\": \"Like new\",\n      \"source\": \"you\"\n    }\n  ],\n  \"photos\": [\n    {\n      \"id\": \"3f…\",\n      \"url\": \"https://files.resell.store/…\",\n      \"alt\": null,\n      \"source\": null,\n      \"is_video\": false\n    }\n  ],\n  \"url\": \"https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt\",\n  \"edit_url\": \"https://resell.store/listings/8d1e6c2a-…\",\n  \"stats\": {\n    \"views\": 214,\n    \"views_7d\": 61,\n    \"likes\": 12,\n    \"shares\": 3,\n    \"offers\": 2,\n    \"offers_waiting\": 1\n  },\n  \"research\": {\n    \"identified\": \"Le Creuset Signature round dutch oven, 5.5 qt, Soleil\",\n    \"category\": \"Kitchen\",\n    \"confidence\": \"high\",\n    \"suggested_price\": 185,\n    \"price_range\": {\n      \"low\": 160,\n      \"high\": 210\n    },\n    \"summary\": \"Sells quickly between $160 and $210 in this colour.\"\n  },\n  \"published_at\": \"2026-09-28T16:02:11.000Z\",\n  \"sold_at\": null,\n  \"created_at\": \"2026-09-28T15:40:00.000Z\",\n  \"updated_at\": \"2026-09-28T16:02:11.000Z\"\n}"
            }
          ]
        },
        {
          "name": "Delete a listing",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/listings/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "listings",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "description": "Deletes a listing and its photos. Listings that have sold stay on record and can't be deleted.\n\nNeeds the `listings` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "DELETE",
                "url": "{{baseUrl}}/listings/:id"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"listing\",\n  \"id\": \"8d1e6c2a-…\",\n  \"deleted\": true\n}"
            }
          ]
        },
        {
          "name": "Put a listing live",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/listings/:id/publish",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "listings",
                ":id",
                "publish"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"visibility\": \"everyone\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Publishes it on your store, at a link made from the title. With `visibility: \"link\"` it stays out of search and the store page. Needs a title and a price.\n\nNeeds the `listings` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/listings/:id/publish"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"listing\",\n  \"id\": \"8d1e6c2a-…\",\n  \"shop\": \"maya\",\n  \"status\": \"live\",\n  \"visibility\": \"everyone\",\n  \"step\": \"publish\",\n  \"name\": \"Le Creuset dutch oven\",\n  \"title\": \"Yellow Le Creuset dutch oven, 5.5 qt\",\n  \"one_liner\": \"The good one, barely used, ready for soup season\",\n  \"description\": \"Bought it for a recipe I made twice. No chips…\",\n  \"category\": \"Kitchen\",\n  \"price\": 185,\n  \"lowest_price\": 160,\n  \"shipping\": 18,\n  \"take_offers\": true,\n  \"fields\": [\n    {\n      \"key\": \"brand\",\n      \"label\": \"Brand\",\n      \"value\": \"Le Creuset\",\n      \"source\": \"agent\"\n    },\n    {\n      \"key\": \"condition\",\n      \"label\": \"Condition\",\n      \"value\": \"Like new\",\n      \"source\": \"you\"\n    }\n  ],\n  \"photos\": [\n    {\n      \"id\": \"3f…\",\n      \"url\": \"https://files.resell.store/…\",\n      \"alt\": null,\n      \"source\": null,\n      \"is_video\": false\n    }\n  ],\n  \"url\": \"https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt\",\n  \"edit_url\": \"https://resell.store/listings/8d1e6c2a-…\",\n  \"stats\": {\n    \"views\": 214,\n    \"views_7d\": 61,\n    \"likes\": 12,\n    \"shares\": 3,\n    \"offers\": 2,\n    \"offers_waiting\": 1\n  },\n  \"research\": {\n    \"identified\": \"Le Creuset Signature round dutch oven, 5.5 qt, Soleil\",\n    \"category\": \"Kitchen\",\n    \"confidence\": \"high\",\n    \"suggested_price\": 185,\n    \"price_range\": {\n      \"low\": 160,\n      \"high\": 210\n    },\n    \"summary\": \"Sells quickly between $160 and $210 in this colour.\"\n  },\n  \"published_at\": \"2026-09-28T16:02:11.000Z\",\n  \"sold_at\": null,\n  \"created_at\": \"2026-09-28T15:40:00.000Z\",\n  \"updated_at\": \"2026-09-28T16:02:11.000Z\"\n}"
            }
          ]
        },
        {
          "name": "Take a listing down",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/listings/:id/unpublish",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "listings",
                ":id",
                "unpublish"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "description": "Back to a draft. It keeps its link for when it goes back up.\n\nNeeds the `listings` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/listings/:id/unpublish"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"listing\",\n  \"id\": \"8d1e6c2a-…\",\n  \"shop\": \"maya\",\n  \"status\": \"draft\",\n  \"visibility\": \"everyone\",\n  \"step\": \"publish\",\n  \"name\": \"Le Creuset dutch oven\",\n  \"title\": \"Yellow Le Creuset dutch oven, 5.5 qt\",\n  \"one_liner\": \"The good one, barely used, ready for soup season\",\n  \"description\": \"Bought it for a recipe I made twice. No chips…\",\n  \"category\": \"Kitchen\",\n  \"price\": 185,\n  \"lowest_price\": 160,\n  \"shipping\": 18,\n  \"take_offers\": true,\n  \"fields\": [\n    {\n      \"key\": \"brand\",\n      \"label\": \"Brand\",\n      \"value\": \"Le Creuset\",\n      \"source\": \"agent\"\n    },\n    {\n      \"key\": \"condition\",\n      \"label\": \"Condition\",\n      \"value\": \"Like new\",\n      \"source\": \"you\"\n    }\n  ],\n  \"photos\": [\n    {\n      \"id\": \"3f…\",\n      \"url\": \"https://files.resell.store/…\",\n      \"alt\": null,\n      \"source\": null,\n      \"is_video\": false\n    }\n  ],\n  \"url\": \"https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt\",\n  \"edit_url\": \"https://resell.store/listings/8d1e6c2a-…\",\n  \"stats\": {\n    \"views\": 214,\n    \"views_7d\": 61,\n    \"likes\": 12,\n    \"shares\": 3,\n    \"offers\": 2,\n    \"offers_waiting\": 1\n  },\n  \"research\": {\n    \"identified\": \"Le Creuset Signature round dutch oven, 5.5 qt, Soleil\",\n    \"category\": \"Kitchen\",\n    \"confidence\": \"high\",\n    \"suggested_price\": 185,\n    \"price_range\": {\n      \"low\": 160,\n      \"high\": 210\n    },\n    \"summary\": \"Sells quickly between $160 and $210 in this colour.\"\n  },\n  \"published_at\": null,\n  \"sold_at\": null,\n  \"created_at\": \"2026-09-28T15:40:00.000Z\",\n  \"updated_at\": \"2026-09-28T16:02:11.000Z\"\n}"
            }
          ]
        },
        {
          "name": "Mark sold elsewhere",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/listings/:id/mark-sold",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "listings",
                ":id",
                "mark-sold"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "description": "For something that sold somewhere else. Sales through resell.store mark themselves sold.\n\nNeeds the `listings` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/listings/:id/mark-sold"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"listing\",\n  \"id\": \"8d1e6c2a-…\",\n  \"shop\": \"maya\",\n  \"status\": \"sold\",\n  \"visibility\": \"everyone\",\n  \"step\": \"publish\",\n  \"name\": \"Le Creuset dutch oven\",\n  \"title\": \"Yellow Le Creuset dutch oven, 5.5 qt\",\n  \"one_liner\": \"The good one, barely used, ready for soup season\",\n  \"description\": \"Bought it for a recipe I made twice. No chips…\",\n  \"category\": \"Kitchen\",\n  \"price\": 185,\n  \"lowest_price\": 160,\n  \"shipping\": 18,\n  \"take_offers\": true,\n  \"fields\": [\n    {\n      \"key\": \"brand\",\n      \"label\": \"Brand\",\n      \"value\": \"Le Creuset\",\n      \"source\": \"agent\"\n    },\n    {\n      \"key\": \"condition\",\n      \"label\": \"Condition\",\n      \"value\": \"Like new\",\n      \"source\": \"you\"\n    }\n  ],\n  \"photos\": [\n    {\n      \"id\": \"3f…\",\n      \"url\": \"https://files.resell.store/…\",\n      \"alt\": null,\n      \"source\": null,\n      \"is_video\": false\n    }\n  ],\n  \"url\": \"https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt\",\n  \"edit_url\": \"https://resell.store/listings/8d1e6c2a-…\",\n  \"stats\": {\n    \"views\": 214,\n    \"views_7d\": 61,\n    \"likes\": 12,\n    \"shares\": 3,\n    \"offers\": 2,\n    \"offers_waiting\": 1\n  },\n  \"research\": {\n    \"identified\": \"Le Creuset Signature round dutch oven, 5.5 qt, Soleil\",\n    \"category\": \"Kitchen\",\n    \"confidence\": \"high\",\n    \"suggested_price\": 185,\n    \"price_range\": {\n      \"low\": 160,\n      \"high\": 210\n    },\n    \"summary\": \"Sells quickly between $160 and $210 in this colour.\"\n  },\n  \"published_at\": \"2026-09-28T16:02:11.000Z\",\n  \"sold_at\": null,\n  \"created_at\": \"2026-09-28T15:40:00.000Z\",\n  \"updated_at\": \"2026-09-28T16:02:11.000Z\"\n}"
            }
          ]
        },
        {
          "name": "Relist",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/listings/:id/relist",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "listings",
                ":id",
                "relist"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "description": "Puts a sold listing (or a draft) back up, at the same link.\n\nNeeds the `listings` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/listings/:id/relist"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"listing\",\n  \"id\": \"8d1e6c2a-…\",\n  \"shop\": \"maya\",\n  \"status\": \"live\",\n  \"visibility\": \"everyone\",\n  \"step\": \"publish\",\n  \"name\": \"Le Creuset dutch oven\",\n  \"title\": \"Yellow Le Creuset dutch oven, 5.5 qt\",\n  \"one_liner\": \"The good one, barely used, ready for soup season\",\n  \"description\": \"Bought it for a recipe I made twice. No chips…\",\n  \"category\": \"Kitchen\",\n  \"price\": 185,\n  \"lowest_price\": 160,\n  \"shipping\": 18,\n  \"take_offers\": true,\n  \"fields\": [\n    {\n      \"key\": \"brand\",\n      \"label\": \"Brand\",\n      \"value\": \"Le Creuset\",\n      \"source\": \"agent\"\n    },\n    {\n      \"key\": \"condition\",\n      \"label\": \"Condition\",\n      \"value\": \"Like new\",\n      \"source\": \"you\"\n    }\n  ],\n  \"photos\": [\n    {\n      \"id\": \"3f…\",\n      \"url\": \"https://files.resell.store/…\",\n      \"alt\": null,\n      \"source\": null,\n      \"is_video\": false\n    }\n  ],\n  \"url\": \"https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt\",\n  \"edit_url\": \"https://resell.store/listings/8d1e6c2a-…\",\n  \"stats\": {\n    \"views\": 214,\n    \"views_7d\": 61,\n    \"likes\": 12,\n    \"shares\": 3,\n    \"offers\": 2,\n    \"offers_waiting\": 1\n  },\n  \"research\": {\n    \"identified\": \"Le Creuset Signature round dutch oven, 5.5 qt, Soleil\",\n    \"category\": \"Kitchen\",\n    \"confidence\": \"high\",\n    \"suggested_price\": 185,\n    \"price_range\": {\n      \"low\": 160,\n      \"high\": 210\n    },\n    \"summary\": \"Sells quickly between $160 and $210 in this colour.\"\n  },\n  \"published_at\": \"2026-09-28T16:02:11.000Z\",\n  \"sold_at\": null,\n  \"created_at\": \"2026-09-28T15:40:00.000Z\",\n  \"updated_at\": \"2026-09-28T16:02:11.000Z\"\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Photos",
      "item": [
        {
          "name": "Add photos",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/listings/:id/photos",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "listings",
                ":id",
                "photos"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "body": {
              "mode": "formdata",
              "formdata": [
                {
                  "key": "file",
                  "type": "file",
                  "src": []
                }
              ]
            },
            "description": "Upload pictures as multipart form data (one or more `file` parts, up to 10 MB each, plus one video up to 40 MB), or send `urls` and we'll download them. New photos go at the end; your first own photo is always the cover.\n\nNeeds the `listings` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/listings/:id/photos"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"list\",\n  \"data\": [\n    {\n      \"id\": \"3f…\",\n      \"url\": \"https://files.resell.store/…\",\n      \"alt\": null,\n      \"source\": null,\n      \"is_video\": false\n    }\n  ],\n  \"total\": 1,\n  \"has_more\": false\n}"
            }
          ]
        },
        {
          "name": "Reorder photos",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/listings/:id/photos/order",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "listings",
                ":id",
                "photos",
                "order"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"photo_ids\": [\n    \"3f…\",\n    \"9a…\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Send every photo id in the order you want. The first must be one of your own photos (not a web picture or the video).\n\nNeeds the `listings` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "PUT",
                "url": "{{baseUrl}}/listings/:id/photos/order"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"list\",\n  \"data\": [\n    {\n      \"id\": \"3f…\",\n      \"url\": \"https://files.resell.store/…\",\n      \"alt\": null,\n      \"source\": null,\n      \"is_video\": false\n    }\n  ],\n  \"total\": 1,\n  \"has_more\": false\n}"
            }
          ]
        },
        {
          "name": "Remove a photo",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/listings/:id/photos/:photoId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "listings",
                ":id",
                "photos",
                ":photoId"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                },
                {
                  "key": "photoId",
                  "value": "",
                  "description": "The photoId."
                }
              ]
            },
            "description": "Needs the `listings` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "DELETE",
                "url": "{{baseUrl}}/listings/:id/photos/:photoId"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"list\",\n  \"data\": [],\n  \"total\": 0,\n  \"has_more\": false\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Research",
      "item": [
        {
          "name": "Look it up",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/listings/:id/research",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "listings",
                ":id",
                "research"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "description": "Starts the research agent on a listing: it works out what the item is from the photo and words, finds it in the catalog, checks second-hand prices and suggests a price. It runs in the background for about a minute; poll GET /listings/:id/research. If a run is already going, you get that one.\n\nNeeds the `listings` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/listings/:id/research"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"research_run\",\n  \"id\": \"run_…\",\n  \"listing\": \"8d1e6c2a-…\",\n  \"status\": \"running\",\n  \"steps\": []\n}"
            }
          ]
        },
        {
          "name": "Research results",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/listings/:id/research",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "listings",
                ":id",
                "research"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "description": "The latest research run: each step's progress while it's `running`, then the findings when it's `done`: what it is, a price range and suggested price, facts, where the prices came from and questions worth answering."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "GET",
                "url": "{{baseUrl}}/listings/:id/research"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"research_run\",\n  \"id\": \"run_…\",\n  \"listing\": \"8d1e6c2a-…\",\n  \"status\": \"done\",\n  \"steps\": [\n    {\n      \"key\": \"identify\",\n      \"state\": \"done\",\n      \"title\": \"Look at your photo\",\n      \"detail\": \"Le Creuset Signature, 5.5 qt\"\n    }\n  ],\n  \"findings\": {\n    \"identified\": \"Le Creuset Signature round dutch oven, 5.5 qt, Soleil\",\n    \"category\": \"Kitchen\",\n    \"confidence\": \"high\",\n    \"price\": {\n      \"min\": 120,\n      \"max\": 260,\n      \"band_low\": 160,\n      \"band_high\": 210,\n      \"suggested\": 185\n    },\n    \"facts\": [\n      {\n        \"label\": \"Retail price\",\n        \"value\": \"$420\"\n      }\n    ],\n    \"questions\": [\n      {\n        \"field\": \"condition\",\n        \"ask\": \"Any chips or stains inside?\"\n      }\n    ],\n    \"summary\": \"Sells quickly between $160 and $210 in this colour.\"\n  }\n}"
            }
          ]
        },
        {
          "name": "Look up an item",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/research",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "research"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"query\": \"Le Creuset dutch oven 5.5 qt yellow\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Shortcut for \"what's this worth?\": makes a draft from your words (and optional picture URLs) and starts the research agent on it. Poll GET /listings/:id/research with the listing id you get back. Delete the draft if you don't want to sell it.\n\nNeeds the `listings` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/research"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"research_run\",\n  \"id\": \"run_…\",\n  \"listing\": \"8d1e6c2a-…\",\n  \"status\": \"running\",\n  \"steps\": []\n}"
            }
          ]
        },
        {
          "name": "Write the words",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/listings/:id/words",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "listings",
                ":id",
                "words"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"tone\": \"Straight to the point\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "The writing agent writes (or rewrites) the title, one-liner, description and teaser from the listing's details and research, in a tone you pick, and puts them on the listing. `instruction` can be \"shorter\", \"longer\", \"take\" (a fresh take) or anything you'd say to a writer.\n\nNeeds the `listings` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/listings/:id/words"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"listing_words\",\n  \"listing\": \"8d1e6c2a-…\",\n  \"tone\": \"Straight to the point\",\n  \"title\": \"Le Creuset dutch oven, 5.5 qt, Soleil yellow\",\n  \"one_liner\": \"Used twice. No chips, no stains.\",\n  \"description\": \"Signature round dutch oven in Soleil…\",\n  \"teaser\": \"Used twice, like new\"\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Offers",
      "item": [
        {
          "name": "List offers",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/offers?status=open",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "offers"
              ],
              "query": [
                {
                  "key": "status",
                  "value": "open"
                },
                {
                  "key": "role",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "listing",
                  "value": "",
                  "description": "Only offers on this listing id.",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "",
                  "description": "How many to return, 1 to 100. Default 25.",
                  "disabled": true
                },
                {
                  "key": "offset",
                  "value": "",
                  "description": "How many to skip, for the next page.",
                  "disabled": true
                }
              ]
            },
            "description": "Offers on your listings (`role=seller`, the default) or offers you've made (`role=buyer`), newest first. Status is as of now: an open offer past its deadline reads `expired`."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "GET",
                "url": "{{baseUrl}}/offers?status=open"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"list\",\n  \"data\": [\n    {\n      \"object\": \"offer\",\n      \"id\": \"5b0f…\",\n      \"status\": \"open\",\n      \"amount\": 150,\n      \"counter\": null,\n      \"agreed\": 150,\n      \"note\": \"Could pick up this weekend.\",\n      \"deposit\": null,\n      \"expires_at\": \"2026-10-04T18:00:00.000Z\",\n      \"responded_at\": null,\n      \"created_at\": \"2026-10-02T18:00:00.000Z\",\n      \"listing\": {\n        \"id\": \"8d1e6c2a-…\",\n        \"title\": \"Yellow Le Creuset dutch oven, 5.5 qt\",\n        \"price\": 185,\n        \"status\": \"live\",\n        \"photo\": \"https://files.resell.store/…\",\n        \"url\": \"https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt\"\n      },\n      \"shop\": {\n        \"slug\": \"maya\",\n        \"name\": \"Maya's closet\"\n      },\n      \"buyer\": {\n        \"name\": \"Jess\"\n      }\n    }\n  ],\n  \"total\": 1,\n  \"has_more\": false\n}"
            }
          ]
        },
        {
          "name": "Get an offer",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/offers/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "offers",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "description": "One offer, on your listing or made by you."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "GET",
                "url": "{{baseUrl}}/offers/:id"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"offer\",\n  \"id\": \"5b0f…\",\n  \"status\": \"open\",\n  \"amount\": 150,\n  \"counter\": null,\n  \"agreed\": 150,\n  \"note\": \"Could pick up this weekend.\",\n  \"deposit\": null,\n  \"expires_at\": \"2026-10-04T18:00:00.000Z\",\n  \"responded_at\": null,\n  \"created_at\": \"2026-10-02T18:00:00.000Z\",\n  \"listing\": {\n    \"id\": \"8d1e6c2a-…\",\n    \"title\": \"Yellow Le Creuset dutch oven, 5.5 qt\",\n    \"price\": 185,\n    \"status\": \"live\",\n    \"photo\": \"https://files.resell.store/…\",\n    \"url\": \"https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt\"\n  },\n  \"shop\": {\n    \"slug\": \"maya\",\n    \"name\": \"Maya's closet\"\n  },\n  \"buyer\": {\n    \"name\": \"Jess\"\n  }\n}"
            }
          ]
        },
        {
          "name": "Accept an offer",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/offers/:id/accept",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "offers",
                ":id",
                "accept"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Says yes. The buyer gets an email and 48 hours to pay the offered amount.\n\nNeeds the `offers` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/offers/:id/accept"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"offer\",\n  \"id\": \"5b0f…\",\n  \"status\": \"accepted\",\n  \"amount\": 150,\n  \"counter\": null,\n  \"agreed\": 150,\n  \"note\": \"Could pick up this weekend.\",\n  \"deposit\": null,\n  \"expires_at\": \"2026-10-04T18:00:00.000Z\",\n  \"responded_at\": \"2026-10-02T19:00:00.000Z\",\n  \"created_at\": \"2026-10-02T18:00:00.000Z\",\n  \"listing\": {\n    \"id\": \"8d1e6c2a-…\",\n    \"title\": \"Yellow Le Creuset dutch oven, 5.5 qt\",\n    \"price\": 185,\n    \"status\": \"live\",\n    \"photo\": \"https://files.resell.store/…\",\n    \"url\": \"https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt\"\n  },\n  \"shop\": {\n    \"slug\": \"maya\",\n    \"name\": \"Maya's closet\"\n  },\n  \"buyer\": {\n    \"name\": \"Jess\"\n  }\n}"
            }
          ]
        },
        {
          "name": "Decline an offer",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/offers/:id/decline",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "offers",
                ":id",
                "decline"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Says no, kindly. The buyer gets an email.\n\nNeeds the `offers` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/offers/:id/decline"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"offer\",\n  \"id\": \"5b0f…\",\n  \"status\": \"declined\",\n  \"amount\": 150,\n  \"counter\": null,\n  \"agreed\": 150,\n  \"note\": \"Could pick up this weekend.\",\n  \"deposit\": null,\n  \"expires_at\": \"2026-10-04T18:00:00.000Z\",\n  \"responded_at\": \"2026-10-02T19:00:00.000Z\",\n  \"created_at\": \"2026-10-02T18:00:00.000Z\",\n  \"listing\": {\n    \"id\": \"8d1e6c2a-…\",\n    \"title\": \"Yellow Le Creuset dutch oven, 5.5 qt\",\n    \"price\": 185,\n    \"status\": \"live\",\n    \"photo\": \"https://files.resell.store/…\",\n    \"url\": \"https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt\"\n  },\n  \"shop\": {\n    \"slug\": \"maya\",\n    \"name\": \"Maya's closet\"\n  },\n  \"buyer\": {\n    \"name\": \"Jess\"\n  }\n}"
            }
          ]
        },
        {
          "name": "Counter an offer",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/offers/:id/counter",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "offers",
                ":id",
                "counter"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"amount\": 170\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Names your price. It has to sit between their offer and your asking price. The buyer has 48 hours to take it.\n\nNeeds the `offers` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/offers/:id/counter"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"offer\",\n  \"id\": \"5b0f…\",\n  \"status\": \"countered\",\n  \"amount\": 150,\n  \"counter\": 170,\n  \"agreed\": 170,\n  \"note\": \"Could pick up this weekend.\",\n  \"deposit\": null,\n  \"expires_at\": \"2026-10-04T18:00:00.000Z\",\n  \"responded_at\": \"2026-10-02T19:00:00.000Z\",\n  \"created_at\": \"2026-10-02T18:00:00.000Z\",\n  \"listing\": {\n    \"id\": \"8d1e6c2a-…\",\n    \"title\": \"Yellow Le Creuset dutch oven, 5.5 qt\",\n    \"price\": 185,\n    \"status\": \"live\",\n    \"photo\": \"https://files.resell.store/…\",\n    \"url\": \"https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt\"\n  },\n  \"shop\": {\n    \"slug\": \"maya\",\n    \"name\": \"Maya's closet\"\n  },\n  \"buyer\": {\n    \"name\": \"Jess\"\n  }\n}"
            }
          ]
        },
        {
          "name": "Make an offer",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/offers",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "offers"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"listing\": \"8d1e6c2a-…\",\n  \"amount\": 150,\n  \"note\": \"Could pick up this weekend.\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Offers a price on a live listing that takes offers. It has to be under the asking price. The seller has 48 hours to answer; a new offer on the same listing replaces your last one.\n\nNeeds the `buying` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/offers"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"offer\",\n  \"id\": \"5b0f…\",\n  \"status\": \"open\",\n  \"amount\": 150,\n  \"counter\": null,\n  \"agreed\": 150,\n  \"note\": \"Could pick up this weekend.\",\n  \"deposit\": null,\n  \"expires_at\": \"2026-10-04T18:00:00.000Z\",\n  \"responded_at\": null,\n  \"created_at\": \"2026-10-02T18:00:00.000Z\",\n  \"listing\": {\n    \"id\": \"8d1e6c2a-…\",\n    \"title\": \"Yellow Le Creuset dutch oven, 5.5 qt\",\n    \"price\": 185,\n    \"status\": \"live\",\n    \"photo\": \"https://files.resell.store/…\",\n    \"url\": \"https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt\"\n  },\n  \"shop\": {\n    \"slug\": \"maya\",\n    \"name\": \"Maya's closet\"\n  }\n}"
            }
          ]
        },
        {
          "name": "Withdraw your offer",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/offers/:id/withdraw",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "offers",
                ":id",
                "withdraw"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "description": "Takes back an offer that's still open or countered.\n\nNeeds the `buying` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/offers/:id/withdraw"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"offer\",\n  \"id\": \"5b0f…\",\n  \"status\": \"withdrawn\",\n  \"amount\": 150,\n  \"counter\": null,\n  \"agreed\": 150,\n  \"note\": \"Could pick up this weekend.\",\n  \"deposit\": null,\n  \"expires_at\": \"2026-10-04T18:00:00.000Z\",\n  \"responded_at\": null,\n  \"created_at\": \"2026-10-02T18:00:00.000Z\",\n  \"listing\": {\n    \"id\": \"8d1e6c2a-…\",\n    \"title\": \"Yellow Le Creuset dutch oven, 5.5 qt\",\n    \"price\": 185,\n    \"status\": \"live\",\n    \"photo\": \"https://files.resell.store/…\",\n    \"url\": \"https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt\"\n  },\n  \"shop\": {\n    \"slug\": \"maya\",\n    \"name\": \"Maya's closet\"\n  }\n}"
            }
          ]
        },
        {
          "name": "Take the counter",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/offers/:id/accept-counter",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "offers",
                ":id",
                "accept-counter"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "description": "Agrees to the seller's counter. You then have 48 hours to pay (see POST /checkout).\n\nNeeds the `buying` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/offers/:id/accept-counter"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"offer\",\n  \"id\": \"5b0f…\",\n  \"status\": \"accepted\",\n  \"amount\": 150,\n  \"counter\": null,\n  \"agreed\": 150,\n  \"note\": \"Could pick up this weekend.\",\n  \"deposit\": null,\n  \"expires_at\": \"2026-10-04T18:00:00.000Z\",\n  \"responded_at\": null,\n  \"created_at\": \"2026-10-02T18:00:00.000Z\",\n  \"listing\": {\n    \"id\": \"8d1e6c2a-…\",\n    \"title\": \"Yellow Le Creuset dutch oven, 5.5 qt\",\n    \"price\": 185,\n    \"status\": \"live\",\n    \"photo\": \"https://files.resell.store/…\",\n    \"url\": \"https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt\"\n  },\n  \"shop\": {\n    \"slug\": \"maya\",\n    \"name\": \"Maya's closet\"\n  }\n}"
            }
          ]
        },
        {
          "name": "Turn down the counter",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/offers/:id/decline-counter",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "offers",
                ":id",
                "decline-counter"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "description": "Says no to the seller's counter. The offer ends.\n\nNeeds the `buying` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/offers/:id/decline-counter"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"offer\",\n  \"id\": \"5b0f…\",\n  \"status\": \"declined\",\n  \"amount\": 150,\n  \"counter\": null,\n  \"agreed\": 150,\n  \"note\": \"Could pick up this weekend.\",\n  \"deposit\": null,\n  \"expires_at\": \"2026-10-04T18:00:00.000Z\",\n  \"responded_at\": null,\n  \"created_at\": \"2026-10-02T18:00:00.000Z\",\n  \"listing\": {\n    \"id\": \"8d1e6c2a-…\",\n    \"title\": \"Yellow Le Creuset dutch oven, 5.5 qt\",\n    \"price\": 185,\n    \"status\": \"live\",\n    \"photo\": \"https://files.resell.store/…\",\n    \"url\": \"https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt\"\n  },\n  \"shop\": {\n    \"slug\": \"maya\",\n    \"name\": \"Maya's closet\"\n  }\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Sales",
      "item": [
        {
          "name": "List sales",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/sales?status=paid",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "sales"
              ],
              "query": [
                {
                  "key": "status",
                  "value": "paid",
                  "description": "`paid` means it's waiting for you to ship."
                },
                {
                  "key": "limit",
                  "value": "",
                  "description": "How many to return, 1 to 100. Default 25.",
                  "disabled": true
                },
                {
                  "key": "offset",
                  "value": "",
                  "description": "How many to skip, for the next page.",
                  "disabled": true
                }
              ]
            },
            "description": "What's sold across your shops, newest first: who bought it, where it ships, and what you get once the money's released."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "GET",
                "url": "{{baseUrl}}/sales?status=paid"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"list\",\n  \"data\": [\n    {\n      \"object\": \"order\",\n      \"id\": \"a71c…\",\n      \"status\": \"paid\",\n      \"item\": 170,\n      \"shipping\": 18,\n      \"total\": 188,\n      \"delivery\": \"tracked\",\n      \"tracking_number\": null,\n      \"offer\": \"5b0f…\",\n      \"listing\": {\n        \"id\": \"8d1e6c2a-…\",\n        \"title\": \"Yellow Le Creuset dutch oven, 5.5 qt\",\n        \"price\": 185,\n        \"status\": \"live\",\n        \"photo\": \"https://files.resell.store/…\",\n        \"url\": \"https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt\"\n      },\n      \"shop\": {\n        \"slug\": \"maya\",\n        \"name\": \"Maya's closet\"\n      },\n      \"buyer\": {\n        \"name\": \"Jess\"\n      },\n      \"ship_to\": {\n        \"name\": \"Jess Park\",\n        \"address\": \"12 Elm St, Portland, OR 97201\",\n        \"country\": \"United States\"\n      },\n      \"payout\": {\n        \"provider\": \"paypal\",\n        \"platform_fee\": 17,\n        \"paypal_fee\": 6.86,\n        \"seller_net\": 164.14,\n        \"released_at\": null\n      },\n      \"paid_at\": \"2026-10-02T18:30:00.000Z\",\n      \"shipped_at\": null,\n      \"delivered_at\": null,\n      \"completed_at\": null\n    }\n  ],\n  \"total\": 1,\n  \"has_more\": false\n}"
            }
          ]
        },
        {
          "name": "Get a sale",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/sales/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "sales",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "description": ""
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "GET",
                "url": "{{baseUrl}}/sales/:id"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"order\",\n  \"id\": \"a71c…\",\n  \"status\": \"paid\",\n  \"item\": 170,\n  \"shipping\": 18,\n  \"total\": 188,\n  \"delivery\": \"tracked\",\n  \"tracking_number\": null,\n  \"offer\": \"5b0f…\",\n  \"listing\": {\n    \"id\": \"8d1e6c2a-…\",\n    \"title\": \"Yellow Le Creuset dutch oven, 5.5 qt\",\n    \"price\": 185,\n    \"status\": \"live\",\n    \"photo\": \"https://files.resell.store/…\",\n    \"url\": \"https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt\"\n  },\n  \"shop\": {\n    \"slug\": \"maya\",\n    \"name\": \"Maya's closet\"\n  },\n  \"buyer\": {\n    \"name\": \"Jess\"\n  },\n  \"ship_to\": {\n    \"name\": \"Jess Park\",\n    \"address\": \"12 Elm St, Portland, OR 97201\",\n    \"country\": \"United States\"\n  },\n  \"payout\": {\n    \"provider\": \"paypal\",\n    \"platform_fee\": 17,\n    \"paypal_fee\": 6.86,\n    \"seller_net\": 164.14,\n    \"released_at\": null\n  },\n  \"paid_at\": \"2026-10-02T18:30:00.000Z\",\n  \"shipped_at\": null,\n  \"delivered_at\": null,\n  \"completed_at\": null\n}"
            }
          ]
        },
        {
          "name": "Mark shipped",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/sales/:id/ship",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "sales",
                ":id",
                "ship"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"tracking_number\": \"9400111899223197428490\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Says it's in the post, with a tracking number if you have one. The buyer gets an email with the tracking link. The money is released when they confirm it arrived.\n\nNeeds the `orders` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/sales/:id/ship"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"order\",\n  \"id\": \"a71c…\",\n  \"status\": \"shipped\",\n  \"item\": 170,\n  \"shipping\": 18,\n  \"total\": 188,\n  \"delivery\": \"tracked\",\n  \"tracking_number\": \"9400111899223197428490\",\n  \"offer\": \"5b0f…\",\n  \"listing\": {\n    \"id\": \"8d1e6c2a-…\",\n    \"title\": \"Yellow Le Creuset dutch oven, 5.5 qt\",\n    \"price\": 185,\n    \"status\": \"live\",\n    \"photo\": \"https://files.resell.store/…\",\n    \"url\": \"https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt\"\n  },\n  \"shop\": {\n    \"slug\": \"maya\",\n    \"name\": \"Maya's closet\"\n  },\n  \"buyer\": {\n    \"name\": \"Jess\"\n  },\n  \"ship_to\": {\n    \"name\": \"Jess Park\",\n    \"address\": \"12 Elm St, Portland, OR 97201\",\n    \"country\": \"United States\"\n  },\n  \"payout\": {\n    \"provider\": \"paypal\",\n    \"platform_fee\": 17,\n    \"paypal_fee\": 6.86,\n    \"seller_net\": 164.14,\n    \"released_at\": null\n  },\n  \"paid_at\": \"2026-10-02T18:30:00.000Z\",\n  \"shipped_at\": \"2026-10-03T15:00:00.000Z\",\n  \"delivered_at\": null,\n  \"completed_at\": null\n}"
            }
          ]
        },
        {
          "name": "Cancel a sale you can't send",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/sales/:id/cancel",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "sales",
                ":id",
                "cancel"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "description": "Before it ships. The buyer gets everything back and the listing goes back on sale. Needs a full API key.\n\nNeeds the `orders` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/sales/:id/cancel"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"problem\",\n  \"order\": \"a71c…\",\n  \"order_status\": \"cancelled\",\n  \"refunded\": 188,\n  \"problem\": null\n}"
            }
          ]
        },
        {
          "name": "Get the problem on a sale",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/sales/:id/problem",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "sales",
                ":id",
                "problem"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "description": ""
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "GET",
                "url": "{{baseUrl}}/sales/:id/problem"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"problem\",\n  \"order\": \"a71c…\",\n  \"order_status\": \"shipped\",\n  \"refunded\": 0,\n  \"problem\": {\n    \"id\": \"d3f0…\",\n    \"status\": \"open\",\n    \"source\": \"buyer\",\n    \"reason\": \"damaged\",\n    \"details\": \"The lid arrived chipped.\",\n    \"refund_offered\": null,\n    \"escalated_at\": null,\n    \"resolved_at\": null,\n    \"created_at\": \"2026-10-05T10:00:00.000Z\",\n    \"events\": [\n      {\n        \"side\": \"buyer\",\n        \"kind\": \"opened\",\n        \"body\": \"The lid arrived chipped.\",\n        \"amount\": null,\n        \"created_at\": \"2026-10-05T10:00:00.000Z\"\n      }\n    ]\n  }\n}"
            }
          ]
        },
        {
          "name": "Refund for a problem",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/sales/:id/problem/refund",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "sales",
                ":id",
                "problem",
                "refund"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"amount\": 40,\n  \"note\": \"Sorry about the lid.\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "With `amount`, offers that much back for the buyer to take or leave. Without it, refunds everything now. Needs a full API key.\n\nNeeds the `orders` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/sales/:id/problem/refund"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"problem\",\n  \"order\": \"a71c…\",\n  \"order_status\": \"shipped\",\n  \"refunded\": 0,\n  \"problem\": {\n    \"id\": \"d3f0…\",\n    \"status\": \"open\",\n    \"source\": \"buyer\",\n    \"reason\": \"damaged\",\n    \"details\": \"The lid arrived chipped.\",\n    \"refund_offered\": 40,\n    \"escalated_at\": null,\n    \"resolved_at\": null,\n    \"created_at\": \"2026-10-05T10:00:00.000Z\",\n    \"events\": [\n      {\n        \"side\": \"buyer\",\n        \"kind\": \"opened\",\n        \"body\": \"The lid arrived chipped.\",\n        \"amount\": null,\n        \"created_at\": \"2026-10-05T10:00:00.000Z\"\n      }\n    ]\n  }\n}"
            }
          ]
        },
        {
          "name": "Reply about a problem",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/sales/:id/problem/reply",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "sales",
                ":id",
                "problem",
                "reply"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"body\": \"Could you send a photo?\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Needs the `orders` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/sales/:id/problem/reply"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"problem\",\n  \"order\": \"a71c…\",\n  \"order_status\": \"shipped\",\n  \"refunded\": 0,\n  \"problem\": {\n    \"id\": \"d3f0…\",\n    \"status\": \"open\",\n    \"source\": \"buyer\",\n    \"reason\": \"damaged\",\n    \"details\": \"The lid arrived chipped.\",\n    \"refund_offered\": null,\n    \"escalated_at\": null,\n    \"resolved_at\": null,\n    \"created_at\": \"2026-10-05T10:00:00.000Z\",\n    \"events\": [\n      {\n        \"side\": \"buyer\",\n        \"kind\": \"opened\",\n        \"body\": \"The lid arrived chipped.\",\n        \"amount\": null,\n        \"created_at\": \"2026-10-05T10:00:00.000Z\"\n      }\n    ]\n  }\n}"
            }
          ]
        },
        {
          "name": "Ask resell.store to step in",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/sales/:id/problem/escalate",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "sales",
                ":id",
                "problem",
                "escalate"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "We read both sides and decide. The money stays held until then.\n\nNeeds the `orders` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/sales/:id/problem/escalate"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"problem\",\n  \"order\": \"a71c…\",\n  \"order_status\": \"shipped\",\n  \"refunded\": 0,\n  \"problem\": {\n    \"id\": \"d3f0…\",\n    \"status\": \"escalated\",\n    \"source\": \"buyer\",\n    \"reason\": \"damaged\",\n    \"details\": \"The lid arrived chipped.\",\n    \"refund_offered\": null,\n    \"escalated_at\": null,\n    \"resolved_at\": null,\n    \"created_at\": \"2026-10-05T10:00:00.000Z\",\n    \"events\": [\n      {\n        \"side\": \"buyer\",\n        \"kind\": \"opened\",\n        \"body\": \"The lid arrived chipped.\",\n        \"amount\": null,\n        \"created_at\": \"2026-10-05T10:00:00.000Z\"\n      }\n    ]\n  }\n}"
            }
          ]
        },
        {
          "name": "List reviews of your shops",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/reviews",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "reviews"
              ],
              "query": [
                {
                  "key": "shop",
                  "value": "",
                  "description": "A shop's slug, to list just that one.",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "offset",
                  "value": "",
                  "disabled": true
                }
              ]
            },
            "description": "Every review on your shops, newest first, including private ones (only you see those) and any resell.store took down (`hidden`)."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "GET",
                "url": "{{baseUrl}}/reviews"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"list\",\n  \"data\": [\n    {\n      \"object\": \"review\",\n      \"id\": \"5b2e…\",\n      \"rating\": 5,\n      \"body\": \"Exactly like the photos, and packed with a little note.\",\n      \"from\": \"Priya\",\n      \"created_at\": \"2026-10-05T10:00:00.000Z\",\n      \"reply\": {\n        \"body\": \"Thank you, Priya! Enjoy it.\",\n        \"created_at\": \"2026-10-05T12:00:00.000Z\"\n      },\n      \"listing\": {\n        \"id\": \"8d1e6c2a-…\",\n        \"title\": \"Linen wrap dress\",\n        \"url\": \"https://maya.resell.store/linen-wrap-dress\"\n      },\n      \"shop\": {\n        \"slug\": \"maya\",\n        \"name\": \"Maya's closet\"\n      },\n      \"order\": \"a71c…\",\n      \"public\": true,\n      \"hidden\": false\n    }\n  ],\n  \"total\": 1,\n  \"has_more\": false\n}"
            }
          ]
        },
        {
          "name": "Reply to a review",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/reviews/:id/reply",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "reviews",
                ":id",
                "reply"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"body\": \"Thank you, Priya! Enjoy it.\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Answer a review on one of your shops. It shows under the review. There's one reply per review; sending again changes it.\n\nNeeds the `shops` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/reviews/:id/reply"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"review\",\n  \"id\": \"5b2e…\",\n  \"rating\": 5,\n  \"body\": \"Exactly like the photos, and packed with a little note.\",\n  \"from\": \"Priya\",\n  \"created_at\": \"2026-10-05T10:00:00.000Z\",\n  \"reply\": {\n    \"body\": \"Thank you, Priya! Enjoy it.\",\n    \"created_at\": \"2026-10-05T12:00:00.000Z\"\n  },\n  \"listing\": {\n    \"id\": \"8d1e6c2a-…\",\n    \"title\": \"Linen wrap dress\",\n    \"url\": \"https://maya.resell.store/linen-wrap-dress\"\n  },\n  \"shop\": {\n    \"slug\": \"maya\",\n    \"name\": \"Maya's closet\"\n  },\n  \"order\": \"a71c…\",\n  \"public\": true,\n  \"hidden\": false\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Buying",
      "item": [
        {
          "name": "List your orders",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/orders",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "orders"
              ],
              "query": [
                {
                  "key": "status",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "",
                  "description": "How many to return, 1 to 100. Default 25.",
                  "disabled": true
                },
                {
                  "key": "offset",
                  "value": "",
                  "description": "How many to skip, for the next page.",
                  "disabled": true
                }
              ]
            },
            "description": "Things you've bought, newest first."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "GET",
                "url": "{{baseUrl}}/orders"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"list\",\n  \"data\": [\n    {\n      \"object\": \"order\",\n      \"id\": \"a71c…\",\n      \"status\": \"shipped\",\n      \"item\": 170,\n      \"shipping\": 18,\n      \"total\": 188,\n      \"delivery\": \"tracked\",\n      \"tracking_number\": null,\n      \"offer\": \"5b0f…\",\n      \"listing\": {\n        \"id\": \"8d1e6c2a-…\",\n        \"title\": \"Yellow Le Creuset dutch oven, 5.5 qt\",\n        \"price\": 185,\n        \"status\": \"live\",\n        \"photo\": \"https://files.resell.store/…\",\n        \"url\": \"https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt\"\n      },\n      \"shop\": {\n        \"slug\": \"maya\",\n        \"name\": \"Maya's closet\"\n      },\n      \"ship_to\": {\n        \"name\": \"Jess Park\",\n        \"address\": \"12 Elm St, Portland, OR 97201\",\n        \"country\": \"United States\"\n      },\n      \"paid_at\": \"2026-10-02T18:30:00.000Z\",\n      \"shipped_at\": null,\n      \"delivered_at\": null,\n      \"completed_at\": null\n    }\n  ],\n  \"total\": 1,\n  \"has_more\": false\n}"
            }
          ]
        },
        {
          "name": "Get an order",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/orders/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "orders",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "description": ""
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "GET",
                "url": "{{baseUrl}}/orders/:id"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"order\",\n  \"id\": \"a71c…\",\n  \"status\": \"paid\",\n  \"item\": 170,\n  \"shipping\": 18,\n  \"total\": 188,\n  \"delivery\": \"tracked\",\n  \"tracking_number\": null,\n  \"offer\": \"5b0f…\",\n  \"listing\": {\n    \"id\": \"8d1e6c2a-…\",\n    \"title\": \"Yellow Le Creuset dutch oven, 5.5 qt\",\n    \"price\": 185,\n    \"status\": \"live\",\n    \"photo\": \"https://files.resell.store/…\",\n    \"url\": \"https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt\"\n  },\n  \"shop\": {\n    \"slug\": \"maya\",\n    \"name\": \"Maya's closet\"\n  },\n  \"ship_to\": {\n    \"name\": \"Jess Park\",\n    \"address\": \"12 Elm St, Portland, OR 97201\",\n    \"country\": \"United States\"\n  },\n  \"paid_at\": \"2026-10-02T18:30:00.000Z\",\n  \"shipped_at\": null,\n  \"delivered_at\": null,\n  \"completed_at\": null\n}"
            }
          ]
        },
        {
          "name": "It arrived, all good",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/orders/:id/confirm",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "orders",
                ":id",
                "confirm"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "description": "Confirms the item arrived as described. This releases the held money to the seller, so only call it once you have it.\n\nNeeds the `buying` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/orders/:id/confirm"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"order\",\n  \"id\": \"a71c…\",\n  \"status\": \"completed\",\n  \"item\": 170,\n  \"shipping\": 18,\n  \"total\": 188,\n  \"delivery\": \"tracked\",\n  \"tracking_number\": null,\n  \"offer\": \"5b0f…\",\n  \"listing\": {\n    \"id\": \"8d1e6c2a-…\",\n    \"title\": \"Yellow Le Creuset dutch oven, 5.5 qt\",\n    \"price\": 185,\n    \"status\": \"live\",\n    \"photo\": \"https://files.resell.store/…\",\n    \"url\": \"https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt\"\n  },\n  \"shop\": {\n    \"slug\": \"maya\",\n    \"name\": \"Maya's closet\"\n  },\n  \"ship_to\": {\n    \"name\": \"Jess Park\",\n    \"address\": \"12 Elm St, Portland, OR 97201\",\n    \"country\": \"United States\"\n  },\n  \"paid_at\": \"2026-10-02T18:30:00.000Z\",\n  \"shipped_at\": null,\n  \"delivered_at\": null,\n  \"completed_at\": null\n}"
            }
          ]
        },
        {
          "name": "Get a checkout link",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/checkout",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "checkout"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"listing\": \"8d1e6c2a-…\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Paying always happens with a person at the wheel: this gives you the checkout page for a listing (at an accepted offer's price, if you have one) to open in a browser, where the buyer pays with PayPal. Nothing is charged by this call.\n\nNeeds the `buying` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/checkout"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"checkout_link\",\n  \"listing\": \"8d1e6c2a-…\",\n  \"price\": 185,\n  \"url\": \"https://resell.store/checkout/8d1e6c2a-…\"\n}"
            }
          ]
        },
        {
          "name": "Cancel an order that hasn't shipped",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/orders/:id/cancel",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "orders",
                ":id",
                "cancel"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "description": "Once the ship-by date (3 days after paying) has passed without it shipping, the buyer can call it off and gets everything back.\n\nNeeds the `buying` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/orders/:id/cancel"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"problem\",\n  \"order\": \"a71c…\",\n  \"order_status\": \"cancelled\",\n  \"refunded\": 188,\n  \"problem\": null\n}"
            }
          ]
        },
        {
          "name": "Get the problem on an order",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/orders/:id/problem",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "orders",
                ":id",
                "problem"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "description": "The latest problem reported on an order, with everything both sides said. `problem` is null if there's never been one."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "GET",
                "url": "{{baseUrl}}/orders/:id/problem"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"problem\",\n  \"order\": \"a71c…\",\n  \"order_status\": \"shipped\",\n  \"refunded\": 0,\n  \"problem\": {\n    \"id\": \"d3f0…\",\n    \"status\": \"open\",\n    \"source\": \"buyer\",\n    \"reason\": \"damaged\",\n    \"details\": \"The lid arrived chipped.\",\n    \"refund_offered\": null,\n    \"escalated_at\": null,\n    \"resolved_at\": null,\n    \"created_at\": \"2026-10-05T10:00:00.000Z\",\n    \"events\": [\n      {\n        \"side\": \"buyer\",\n        \"kind\": \"opened\",\n        \"body\": \"The lid arrived chipped.\",\n        \"amount\": null,\n        \"created_at\": \"2026-10-05T10:00:00.000Z\"\n      }\n    ]\n  }\n}"
            }
          ]
        },
        {
          "name": "Report a problem",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/orders/:id/problem",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "orders",
                ":id",
                "problem"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"reason\": \"damaged\",\n  \"details\": \"The lid arrived chipped.\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "For an order that's shipped. The seller is told, and the held money isn't released until it's sorted.\n\nNeeds the `buying` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/orders/:id/problem"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"problem\",\n  \"order\": \"a71c…\",\n  \"order_status\": \"shipped\",\n  \"refunded\": 0,\n  \"problem\": {\n    \"id\": \"d3f0…\",\n    \"status\": \"open\",\n    \"source\": \"buyer\",\n    \"reason\": \"damaged\",\n    \"details\": \"The lid arrived chipped.\",\n    \"refund_offered\": null,\n    \"escalated_at\": null,\n    \"resolved_at\": null,\n    \"created_at\": \"2026-10-05T10:00:00.000Z\",\n    \"events\": [\n      {\n        \"side\": \"buyer\",\n        \"kind\": \"opened\",\n        \"body\": \"The lid arrived chipped.\",\n        \"amount\": null,\n        \"created_at\": \"2026-10-05T10:00:00.000Z\"\n      }\n    ]\n  }\n}"
            }
          ]
        },
        {
          "name": "Answer a refund offer",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/orders/:id/problem/answer",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "orders",
                ":id",
                "problem",
                "answer"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"accept\": true\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Take the part refund the seller offered (the rest goes to them and the order is done), or turn it down.\n\nNeeds the `buying` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/orders/:id/problem/answer"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"problem\",\n  \"order\": \"a71c…\",\n  \"order_status\": \"completed\",\n  \"refunded\": 40,\n  \"problem\": {\n    \"id\": \"d3f0…\",\n    \"status\": \"open\",\n    \"source\": \"buyer\",\n    \"reason\": \"damaged\",\n    \"details\": \"The lid arrived chipped.\",\n    \"refund_offered\": null,\n    \"escalated_at\": null,\n    \"resolved_at\": null,\n    \"created_at\": \"2026-10-05T10:00:00.000Z\",\n    \"events\": [\n      {\n        \"side\": \"buyer\",\n        \"kind\": \"opened\",\n        \"body\": \"The lid arrived chipped.\",\n        \"amount\": null,\n        \"created_at\": \"2026-10-05T10:00:00.000Z\"\n      }\n    ]\n  }\n}"
            }
          ]
        },
        {
          "name": "Say a problem is sorted",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/orders/:id/problem/close",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "orders",
                ":id",
                "problem",
                "close"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "description": "Closes the problem without a refund. The order goes back to its usual timer and the seller is paid as normal.\n\nNeeds the `buying` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/orders/:id/problem/close"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"problem\",\n  \"order\": \"a71c…\",\n  \"order_status\": \"shipped\",\n  \"refunded\": 0,\n  \"problem\": {\n    \"id\": \"d3f0…\",\n    \"status\": \"closed\",\n    \"source\": \"buyer\",\n    \"reason\": \"damaged\",\n    \"details\": \"The lid arrived chipped.\",\n    \"refund_offered\": null,\n    \"escalated_at\": null,\n    \"resolved_at\": null,\n    \"created_at\": \"2026-10-05T10:00:00.000Z\",\n    \"events\": [\n      {\n        \"side\": \"buyer\",\n        \"kind\": \"opened\",\n        \"body\": \"The lid arrived chipped.\",\n        \"amount\": null,\n        \"created_at\": \"2026-10-05T10:00:00.000Z\"\n      }\n    ]\n  }\n}"
            }
          ]
        },
        {
          "name": "Reply about a problem",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/orders/:id/problem/reply",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "orders",
                ":id",
                "problem",
                "reply"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"body\": \"Could you send a photo?\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Needs the `buying` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/orders/:id/problem/reply"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"problem\",\n  \"order\": \"a71c…\",\n  \"order_status\": \"shipped\",\n  \"refunded\": 0,\n  \"problem\": {\n    \"id\": \"d3f0…\",\n    \"status\": \"open\",\n    \"source\": \"buyer\",\n    \"reason\": \"damaged\",\n    \"details\": \"The lid arrived chipped.\",\n    \"refund_offered\": null,\n    \"escalated_at\": null,\n    \"resolved_at\": null,\n    \"created_at\": \"2026-10-05T10:00:00.000Z\",\n    \"events\": [\n      {\n        \"side\": \"buyer\",\n        \"kind\": \"opened\",\n        \"body\": \"The lid arrived chipped.\",\n        \"amount\": null,\n        \"created_at\": \"2026-10-05T10:00:00.000Z\"\n      }\n    ]\n  }\n}"
            }
          ]
        },
        {
          "name": "Ask resell.store to step in",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/orders/:id/problem/escalate",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "orders",
                ":id",
                "problem",
                "escalate"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "We read both sides and decide. The money stays held until then.\n\nNeeds the `buying` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/orders/:id/problem/escalate"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"problem\",\n  \"order\": \"a71c…\",\n  \"order_status\": \"shipped\",\n  \"refunded\": 0,\n  \"problem\": {\n    \"id\": \"d3f0…\",\n    \"status\": \"escalated\",\n    \"source\": \"buyer\",\n    \"reason\": \"damaged\",\n    \"details\": \"The lid arrived chipped.\",\n    \"refund_offered\": null,\n    \"escalated_at\": null,\n    \"resolved_at\": null,\n    \"created_at\": \"2026-10-05T10:00:00.000Z\",\n    \"events\": [\n      {\n        \"side\": \"buyer\",\n        \"kind\": \"opened\",\n        \"body\": \"The lid arrived chipped.\",\n        \"amount\": null,\n        \"created_at\": \"2026-10-05T10:00:00.000Z\"\n      }\n    ]\n  }\n}"
            }
          ]
        },
        {
          "name": "Review an order",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/orders/:id/review",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "orders",
                ":id",
                "review"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"rating\": 5,\n  \"body\": \"Exactly like the photos, and packed with a little note.\",\n  \"public\": true\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Once an order is done (the buyer said it's all good, or the check window closed), the buyer can give it 1 to 5 stars and a few words. One review per order. Set `public` to false to send it only to the seller.\n\nNeeds the `buying` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/orders/:id/review"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"review\",\n  \"id\": \"5b2e…\",\n  \"rating\": 5,\n  \"body\": \"Exactly like the photos, and packed with a little note.\",\n  \"from\": \"Priya\",\n  \"created_at\": \"2026-10-05T10:00:00.000Z\",\n  \"reply\": null,\n  \"listing\": {\n    \"id\": \"8d1e6c2a-…\",\n    \"title\": \"Linen wrap dress\",\n    \"url\": \"https://maya.resell.store/linen-wrap-dress\"\n  },\n  \"shop\": {\n    \"slug\": \"maya\",\n    \"name\": \"Maya's closet\"\n  },\n  \"order\": \"a71c…\",\n  \"public\": true,\n  \"hidden\": false\n}"
            }
          ]
        },
        {
          "name": "Get your review of an order",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/orders/:id/review",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "orders",
                ":id",
                "review"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "description": "The review the buyer left on an order, with the seller's reply. 404 if there isn't one yet."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "GET",
                "url": "{{baseUrl}}/orders/:id/review"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"review\",\n  \"id\": \"5b2e…\",\n  \"rating\": 5,\n  \"body\": \"Exactly like the photos, and packed with a little note.\",\n  \"from\": \"Priya\",\n  \"created_at\": \"2026-10-05T10:00:00.000Z\",\n  \"reply\": {\n    \"body\": \"Thank you, Priya! Enjoy it.\",\n    \"created_at\": \"2026-10-05T12:00:00.000Z\"\n  },\n  \"listing\": {\n    \"id\": \"8d1e6c2a-…\",\n    \"title\": \"Linen wrap dress\",\n    \"url\": \"https://maya.resell.store/linen-wrap-dress\"\n  },\n  \"shop\": {\n    \"slug\": \"maya\",\n    \"name\": \"Maya's closet\"\n  },\n  \"order\": \"a71c…\",\n  \"public\": true,\n  \"hidden\": false\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Marketplace",
      "item": [
        {
          "name": "Read a store's reviews",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/stores/:slug/reviews",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "stores",
                ":slug",
                "reviews"
              ],
              "query": [
                {
                  "key": "rating",
                  "value": "",
                  "description": "Only reviews with this many stars.",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "",
                  "description": "How many to return, 1 to 50. Default 10.",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "`next_cursor` from the page before.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "slug",
                  "value": "",
                  "description": "The slug."
                }
              ]
            },
            "description": "What buyers said about a store, newest first, with the seller's replies. Only people who bought can review, and only public reviews show. No key needed. Pass `next_cursor` back as `cursor` for the next page."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "GET",
                "url": "{{baseUrl}}/stores/:slug/reviews"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"list\",\n  \"rating\": {\n    \"average\": 4.8,\n    \"count\": 12\n  },\n  \"data\": [\n    {\n      \"object\": \"review\",\n      \"id\": \"5b2e…\",\n      \"rating\": 5,\n      \"body\": \"Exactly like the photos, and packed with a little note.\",\n      \"from\": \"Priya\",\n      \"created_at\": \"2026-10-05T10:00:00.000Z\",\n      \"reply\": {\n        \"body\": \"Thank you, Priya! Enjoy it.\",\n        \"created_at\": \"2026-10-05T12:00:00.000Z\"\n      },\n      \"listing\": {\n        \"id\": \"8d1e6c2a-…\",\n        \"title\": \"Linen wrap dress\",\n        \"url\": \"https://maya.resell.store/linen-wrap-dress\"\n      },\n      \"shop\": {\n        \"slug\": \"maya\",\n        \"name\": \"Maya's closet\"\n      }\n    }\n  ],\n  \"next_cursor\": \"5b2e…\",\n  \"has_more\": true\n}"
            }
          ]
        },
        {
          "name": "Search the marketplace",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/market/search?q=dutch+oven&price=over-100",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "market",
                "search"
              ],
              "query": [
                {
                  "key": "q",
                  "value": "dutch oven",
                  "description": "What you're looking for. Leave out to browse."
                },
                {
                  "key": "price",
                  "value": "over-100",
                  "description": "any, under-25, 25-100 or over-100."
                },
                {
                  "key": "category",
                  "value": "",
                  "description": "One of: Clothing, Shoes, Bags, Home, Collectibles, Books, Tech, Kids, Garden.",
                  "disabled": true
                },
                {
                  "key": "offers",
                  "value": "",
                  "description": "Only things open to offers.",
                  "disabled": true
                },
                {
                  "key": "sort",
                  "value": "",
                  "description": "best (with a query), newest, price-asc or price-desc.",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "offset",
                  "value": "",
                  "description": "How many to skip, for the next page.",
                  "disabled": true
                }
              ]
            },
            "description": "Search everything for sale on resell.store, by words and by meaning (\"something to cook stew in\" finds dutch ovens). No key needed. With a key, each result says whether you've liked it."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "GET",
                "url": "{{baseUrl}}/market/search?q=dutch+oven&price=over-100"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"search_result\",\n  \"data\": [\n    {\n      \"object\": \"public_listing\",\n      \"id\": \"8d1e6c2a-…\",\n      \"slug\": \"yellow-le-creuset-dutch-oven-5-5-qt\",\n      \"store\": \"maya\",\n      \"title\": \"Yellow Le Creuset dutch oven, 5.5 qt\",\n      \"one_liner\": \"The good one, barely used, ready for soup season\",\n      \"price\": 185,\n      \"shipping\": 18,\n      \"photo\": \"https://files.resell.store/…\",\n      \"category\": \"Home\",\n      \"open_to_offers\": true,\n      \"sold\": false,\n      \"just_listed\": false,\n      \"url\": \"https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt\",\n      \"seller\": {\n        \"name\": \"Maya's closet\"\n      },\n      \"liked\": false\n    }\n  ],\n  \"total\": 3,\n  \"stores\": 2,\n  \"has_more\": true\n}"
            }
          ]
        },
        {
          "name": "Look at a listing",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/market/listings/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "market",
                "listings",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "description": "Everything a buyer sees on a listing's page: photos, the seller's description, details and shipping. No key needed."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "GET",
                "url": "{{baseUrl}}/market/listings/:id"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"public_listing\",\n  \"id\": \"8d1e6c2a-…\",\n  \"slug\": \"yellow-le-creuset-dutch-oven-5-5-qt\",\n  \"store\": \"maya\",\n  \"title\": \"Yellow Le Creuset dutch oven, 5.5 qt\",\n  \"one_liner\": \"The good one, barely used, ready for soup season\",\n  \"price\": 185,\n  \"shipping\": 18,\n  \"photo\": \"https://files.resell.store/…\",\n  \"category\": \"Home\",\n  \"open_to_offers\": true,\n  \"sold\": false,\n  \"just_listed\": false,\n  \"url\": \"https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt\",\n  \"seller\": {\n    \"name\": \"Maya's closet\"\n  },\n  \"liked\": false,\n  \"description\": [\n    \"Bought it for a recipe I made twice. No chips, no stains.\"\n  ],\n  \"details\": [\n    {\n      \"label\": \"Brand\",\n      \"value\": \"Le Creuset\"\n    },\n    {\n      \"label\": \"Condition\",\n      \"value\": \"Like new\"\n    },\n    {\n      \"label\": \"Offers\",\n      \"value\": \"Welcome\"\n    }\n  ],\n  \"photos\": [\n    {\n      \"url\": \"https://files.resell.store/…\",\n      \"video\": false\n    }\n  ],\n  \"listed\": \"Listed on September 28.\"\n}"
            }
          ]
        },
        {
          "name": "Browse stores",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/market/stores",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "market",
                "stores"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "",
                  "description": "How many to return, 1 to 100. Default 25.",
                  "disabled": true
                },
                {
                  "key": "offset",
                  "value": "",
                  "description": "How many to skip, for the next page.",
                  "disabled": true
                }
              ]
            },
            "description": "Every store listed on the marketplace, busiest first. No key needed."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "GET",
                "url": "{{baseUrl}}/market/stores"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"list\",\n  \"data\": [\n    {\n      \"object\": \"store\",\n      \"slug\": \"maya\",\n      \"name\": \"Maya's closet\",\n      \"owner\": \"Maya\",\n      \"tagline\": \"Clothes and kitchen things I don't use any more\",\n      \"about\": \"Clothes and kitchen things I don't use any more. Ships from Portland.\",\n      \"location\": \"Portland, OR\",\n      \"since\": \"September 2026\",\n      \"for_sale\": 12,\n      \"sold\": 20,\n      \"paused\": false,\n      \"picture_url\": null,\n      \"url\": \"https://maya.resell.store\"\n    }\n  ],\n  \"total\": 1,\n  \"has_more\": false\n}"
            }
          ]
        },
        {
          "name": "Look at a store",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/market/stores/:slug",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "market",
                "stores",
                ":slug"
              ],
              "variable": [
                {
                  "key": "slug",
                  "value": "",
                  "description": "The slug."
                }
              ]
            },
            "description": "A store, what's on its shelves and what it's sold lately. No key needed; with one, it says whether you follow it."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "GET",
                "url": "{{baseUrl}}/market/stores/:slug"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"store\",\n  \"slug\": \"maya\",\n  \"name\": \"Maya's closet\",\n  \"owner\": \"Maya\",\n  \"tagline\": \"Clothes and kitchen things I don't use any more\",\n  \"about\": \"Clothes and kitchen things I don't use any more. Ships from Portland.\",\n  \"location\": \"Portland, OR\",\n  \"since\": \"September 2026\",\n  \"for_sale\": 12,\n  \"sold\": 20,\n  \"paused\": false,\n  \"picture_url\": null,\n  \"url\": \"https://maya.resell.store\",\n  \"followers\": 105,\n  \"following\": false,\n  \"listings\": [\n    {\n      \"object\": \"public_listing\",\n      \"id\": \"8d1e6c2a-…\",\n      \"slug\": \"yellow-le-creuset-dutch-oven-5-5-qt\",\n      \"store\": \"maya\",\n      \"title\": \"Yellow Le Creuset dutch oven, 5.5 qt\",\n      \"one_liner\": \"The good one, barely used, ready for soup season\",\n      \"price\": 185,\n      \"shipping\": 18,\n      \"photo\": \"https://files.resell.store/…\",\n      \"category\": \"Home\",\n      \"open_to_offers\": true,\n      \"sold\": false,\n      \"just_listed\": false,\n      \"url\": \"https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt\",\n      \"seller\": {\n        \"name\": \"Maya's closet\"\n      },\n      \"liked\": false\n    }\n  ],\n  \"recently_sold\": [\n    {\n      \"title\": \"Linen wrap dress\",\n      \"price\": 24,\n      \"when\": \"last week\"\n    }\n  ]\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Messages",
      "item": [
        {
          "name": "List conversations",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/threads?unread=true",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "threads"
              ],
              "query": [
                {
                  "key": "unread",
                  "value": "true",
                  "description": "Only conversations waiting on you."
                },
                {
                  "key": "role",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "",
                  "description": "How many to return, 1 to 100. Default 25.",
                  "disabled": true
                },
                {
                  "key": "offset",
                  "value": "",
                  "description": "How many to skip, for the next page.",
                  "disabled": true
                }
              ]
            },
            "description": "Conversations with buyers across your shops (`role=seller`, the default) or with shops you've written to (`role=buyer`), most recent first."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "GET",
                "url": "{{baseUrl}}/threads?unread=true"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"list\",\n  \"data\": [\n    {\n      \"object\": \"thread\",\n      \"id\": \"t_91c…\",\n      \"with\": \"Jess\",\n      \"shop\": {\n        \"slug\": \"maya\",\n        \"name\": \"Maya's closet\"\n      },\n      \"listing\": {\n        \"id\": \"8d1e6c2a-…\",\n        \"title\": \"Yellow Le Creuset dutch oven, 5.5 qt\",\n        \"photo\": \"https://files.resell.store/…\",\n        \"url\": \"https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt\"\n      },\n      \"preview\": \"Is the lid included?\",\n      \"last_from\": \"them\",\n      \"unread\": true,\n      \"needs_you\": false,\n      \"last_message_at\": \"2026-10-02T17:42:00.000Z\"\n    }\n  ],\n  \"total\": 1,\n  \"has_more\": false\n}"
            }
          ]
        },
        {
          "name": "Read a conversation",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/threads/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "threads",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "description": "The whole conversation, oldest message first. Reading it here doesn't mark it read; POST /threads/:id/read does."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "GET",
                "url": "{{baseUrl}}/threads/:id"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"thread\",\n  \"id\": \"t_91c…\",\n  \"with\": \"Jess\",\n  \"shop\": {\n    \"slug\": \"maya\",\n    \"name\": \"Maya's closet\"\n  },\n  \"listing\": {\n    \"id\": \"8d1e6c2a-…\",\n    \"title\": \"Yellow Le Creuset dutch oven, 5.5 qt\",\n    \"photo\": \"https://files.resell.store/…\",\n    \"url\": \"https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt\"\n  },\n  \"preview\": \"Is the lid included?\",\n  \"last_from\": \"them\",\n  \"unread\": true,\n  \"needs_you\": false,\n  \"last_message_at\": \"2026-10-02T17:42:00.000Z\",\n  \"role\": \"seller\",\n  \"messages\": [\n    {\n      \"id\": \"m_1\",\n      \"from\": \"them\",\n      \"by_agent\": false,\n      \"body\": \"Hi! Is the lid included?\",\n      \"created_at\": \"2026-10-02T17:42:00.000Z\"\n    },\n    {\n      \"id\": \"m_2\",\n      \"from\": \"you\",\n      \"by_agent\": false,\n      \"body\": \"It is, and it fits snugly.\",\n      \"created_at\": \"2026-10-02T17:50:00.000Z\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Reply",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/threads/:id/messages",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "threads",
                ":id",
                "messages"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"body\": \"It is, and it fits snugly.\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Sends a message in a conversation, from whichever side you're on. Sending also marks it read for you.\n\nNeeds the `messages` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/threads/:id/messages"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"id\": \"m_2\",\n  \"from\": \"you\",\n  \"by_agent\": false,\n  \"body\": \"It is, and it fits snugly.\",\n  \"created_at\": \"2026-10-02T17:50:00.000Z\"\n}"
            }
          ]
        },
        {
          "name": "Mark read",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/threads/:id/read",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "threads",
                ":id",
                "read"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "description": "Needs the `messages` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/threads/:id/read"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"thread\",\n  \"id\": \"t_91c…\",\n  \"with\": \"Jess\",\n  \"shop\": {\n    \"slug\": \"maya\",\n    \"name\": \"Maya's closet\"\n  },\n  \"listing\": {\n    \"id\": \"8d1e6c2a-…\",\n    \"title\": \"Yellow Le Creuset dutch oven, 5.5 qt\",\n    \"photo\": \"https://files.resell.store/…\",\n    \"url\": \"https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt\"\n  },\n  \"preview\": \"Is the lid included?\",\n  \"last_from\": \"them\",\n  \"unread\": false,\n  \"needs_you\": false,\n  \"last_message_at\": \"2026-10-02T17:42:00.000Z\"\n}"
            }
          ]
        },
        {
          "name": "Message a shop",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/threads",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "threads"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"shop\": \"maya\",\n  \"listing\": \"8d1e6c2a-…\",\n  \"body\": \"Hi! Is the lid included?\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Writes to a shop as a buyer, about one of its listings or in general. If you've written to them about it before, the message goes in that conversation.\n\nNeeds the `buying` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/threads"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"thread\",\n  \"id\": \"t_91c…\",\n  \"with\": \"Maya's closet\",\n  \"shop\": {\n    \"slug\": \"maya\",\n    \"name\": \"Maya's closet\"\n  },\n  \"listing\": {\n    \"id\": \"8d1e6c2a-…\",\n    \"title\": \"Yellow Le Creuset dutch oven, 5.5 qt\",\n    \"photo\": \"https://files.resell.store/…\",\n    \"url\": \"https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt\"\n  },\n  \"preview\": \"Is the lid included?\",\n  \"last_from\": \"you\",\n  \"unread\": false,\n  \"needs_you\": false,\n  \"last_message_at\": \"2026-10-02T17:42:00.000Z\",\n  \"role\": \"buyer\",\n  \"messages\": []\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Stats",
      "item": [
        {
          "name": "How your shops are doing",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/stats?period=7d",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "stats"
              ],
              "query": [
                {
                  "key": "period",
                  "value": "7d",
                  "description": "7d, 30d, 90d or year (since January 1)."
                },
                {
                  "key": "shop",
                  "value": "",
                  "description": "A shop slug. Leave out for every shop.",
                  "disabled": true
                }
              ]
            },
            "description": "Earnings, views, likes, shares, followers, offers and sales for a period, each compared with the period before. Narrow it to one shop with `shop`. Money is what you made after fees."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "GET",
                "url": "{{baseUrl}}/stats?period=7d"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"stats\",\n  \"period\": \"7d\",\n  \"shop\": null,\n  \"earned\": 214,\n  \"earned_change\": 58,\n  \"things_sold\": 4,\n  \"average_sale\": 54,\n  \"days_to_sell\": 6,\n  \"metrics\": [\n    {\n      \"label\": \"Views\",\n      \"value\": 398,\n      \"note\": \"61 more than before\"\n    },\n    {\n      \"label\": \"Likes\",\n      \"value\": 12,\n      \"note\": \"48 saved right now\"\n    },\n    {\n      \"label\": \"Offers\",\n      \"value\": 5,\n      \"note\": \"2 turned into sales\"\n    }\n  ],\n  \"chart\": [\n    {\n      \"label\": \"Mon\",\n      \"dates\": \"Sep 26\",\n      \"earned\": 0\n    }\n  ],\n  \"sources\": [\n    {\n      \"label\": \"Your link\",\n      \"percent\": 44\n    }\n  ],\n  \"most_viewed\": [\n    {\n      \"title\": \"Yellow Le Creuset dutch oven, 5.5 qt\",\n      \"views\": 61,\n      \"note\": \"12 likes, 1 offer waiting\",\n      \"url\": \"https://resell.store/listings/8d1e6c2a-…\"\n    }\n  ]\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Webhooks",
      "item": [
        {
          "name": "Your webhook",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/webhooks",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "webhooks"
              ]
            },
            "description": "Where we send events, which ones, and how the last delivery went.\n\nNeeds the `webhooks` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "GET",
                "url": "{{baseUrl}}/webhooks"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"webhook\",\n  \"url\": \"https://example.com/hooks/resell\",\n  \"events\": [\n    \"listing.sold\",\n    \"offer.received\"\n  ],\n  \"enabled\": true,\n  \"secret_last4\": \"9fQa\",\n  \"last_delivery\": {\n    \"at\": \"2026-10-02T18:30:02.000Z\",\n    \"status\": 200,\n    \"error\": null\n  }\n}"
            }
          ]
        },
        {
          "name": "Set your webhook",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/webhooks",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "webhooks"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"url\": \"https://example.com/hooks/resell\",\n  \"events\": [\n    \"listing.sold\",\n    \"offer.received\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Sets the address we POST events to and which events to send. The first time, the response includes the signing `secret`; keep it to check the Resell-Signature header. Events: listing.sold, offer.received, offer.updated, question.asked, order.completed, order.problem, order.refunded, payout.sent, review.created.\n\nNeeds the `webhooks` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "PUT",
                "url": "{{baseUrl}}/webhooks"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"webhook\",\n  \"url\": \"https://example.com/hooks/resell\",\n  \"events\": [\n    \"listing.sold\",\n    \"offer.received\"\n  ],\n  \"enabled\": true,\n  \"last_delivery\": null,\n  \"secret\": \"whsec_…\"\n}"
            }
          ]
        },
        {
          "name": "Stop webhooks",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/webhooks",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "webhooks"
              ]
            },
            "description": "Needs the `webhooks` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "DELETE",
                "url": "{{baseUrl}}/webhooks"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"webhook\",\n  \"url\": null,\n  \"events\": [],\n  \"enabled\": false\n}"
            }
          ]
        },
        {
          "name": "New signing secret",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/webhooks/rotate-secret",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "webhooks",
                "rotate-secret"
              ]
            },
            "description": "Makes a new signing secret. The old one stops working at once.\n\nNeeds the `webhooks` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/webhooks/rotate-secret"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"webhook\",\n  \"url\": \"https://example.com/hooks/resell\",\n  \"events\": [\n    \"listing.sold\",\n    \"offer.received\"\n  ],\n  \"enabled\": true,\n  \"last_delivery\": {\n    \"at\": \"2026-10-02T18:30:02.000Z\",\n    \"status\": 200,\n    \"error\": null\n  },\n  \"secret\": \"whsec_…\"\n}"
            }
          ]
        },
        {
          "name": "Send a test event",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/webhooks/test",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "webhooks",
                "test"
              ]
            },
            "description": "Sends a `ping` event to your address now and tells you what your server answered.\n\nNeeds the `webhooks` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/webhooks/test"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"webhook_test\",\n  \"event\": \"evt_…\",\n  \"status\": 200,\n  \"error\": null\n}"
            }
          ]
        },
        {
          "name": "List subscriptions",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/webhooks/subscriptions",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "webhooks",
                "subscriptions"
              ]
            },
            "description": "Every extra address getting events, each with its own events: one per Zap made with the resell.store Zapier app, plus any you added yourself.\n\nNeeds the `webhooks` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "GET",
                "url": "{{baseUrl}}/webhooks/subscriptions"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"list\",\n  \"data\": [\n    {\n      \"object\": \"webhook_subscription\",\n      \"id\": \"3f9c2b1a-…\",\n      \"url\": \"https://hooks.zapier.com/hooks/standard/1234567/abcdef/\",\n      \"events\": [\n        \"listing.sold\"\n      ],\n      \"name\": \"Add sales to my sheet\",\n      \"source\": \"zapier\",\n      \"enabled\": true,\n      \"secret_last4\": \"x7Lp\",\n      \"last_delivery\": {\n        \"at\": \"2026-10-02T18:30:02.000Z\",\n        \"status\": 200,\n        \"error\": null\n      },\n      \"created_at\": \"2026-10-01T09:00:00.000Z\"\n    }\n  ],\n  \"total\": 1,\n  \"has_more\": false\n}"
            }
          ]
        },
        {
          "name": "Subscribe an address",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/webhooks/subscriptions",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "webhooks",
                "subscriptions"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"url\": \"https://hooks.zapier.com/hooks/standard/1234567/abcdef/\",\n  \"events\": [\n    \"listing.sold\"\n  ],\n  \"name\": \"Add sales to my sheet\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Starts sending some events to another address, alongside your webhook. This is the REST hook Zapier calls when a Zap is turned on; Make, n8n and Pipedream can use it the same way. Subscribing an address you already have updates its events. Answer a delivery with 410 Gone and we delete the subscription. Up to 50. The response includes its signing `secret`.\n\nNeeds the `webhooks` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/webhooks/subscriptions"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"webhook_subscription\",\n  \"id\": \"3f9c2b1a-…\",\n  \"url\": \"https://hooks.zapier.com/hooks/standard/1234567/abcdef/\",\n  \"events\": [\n    \"listing.sold\"\n  ],\n  \"name\": \"Add sales to my sheet\",\n  \"source\": \"zapier\",\n  \"enabled\": true,\n  \"last_delivery\": null,\n  \"created_at\": \"2026-10-01T09:00:00.000Z\",\n  \"secret\": \"whsec_…\"\n}"
            }
          ]
        },
        {
          "name": "Unsubscribe an address",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/webhooks/subscriptions/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "webhooks",
                "subscriptions",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "description": "Stops sending events there. Zapier calls this when a Zap is turned off or deleted.\n\nNeeds the `webhooks` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "DELETE",
                "url": "{{baseUrl}}/webhooks/subscriptions/:id"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"webhook_subscription\",\n  \"id\": \"3f9c2b1a-…\",\n  \"deleted\": true\n}"
            }
          ]
        },
        {
          "name": "Send a sample to a subscription",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/webhooks/subscriptions/:id/test",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "webhooks",
                "subscriptions",
                ":id",
                "test"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"event\": \"listing.sold\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Posts a sample event now, built from your latest real one (your newest sale for listing.sold, and so on), marked `test: true` and never retried. Handy when Zapier is waiting for a request to learn the fields.\n\nNeeds the `webhooks` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/webhooks/subscriptions/:id/test"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"webhook_test\",\n  \"event\": \"evt_…\",\n  \"type\": \"listing.sold\",\n  \"status\": 200,\n  \"error\": null\n}"
            }
          ]
        },
        {
          "name": "Sample events",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/webhooks/samples/:event",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "webhooks",
                "samples",
                ":event"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "event",
                  "value": "",
                  "description": "The event."
                }
              ]
            },
            "description": "What an event looks like, from your own latest matching things, newest first (made up if you have none yet). Each is the full event we'd POST, marked `test: true`. The Zapier app shows these when you test a trigger."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "GET",
                "url": "{{baseUrl}}/webhooks/samples/:event"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"list\",\n  \"data\": [\n    {\n      \"id\": \"evt_sample_5b0f9a123c4d\",\n      \"object\": \"event\",\n      \"type\": \"offer.received\",\n      \"created_at\": \"2026-10-02T18:00:00.000Z\",\n      \"test\": true,\n      \"data\": {\n        \"object\": {\n          \"object\": \"offer\",\n          \"id\": \"5b0f…\",\n          \"status\": \"open\",\n          \"amount\": 150,\n          \"shop\": {\n            \"slug\": \"maya\",\n            \"name\": \"Maya's closet\"\n          }\n        }\n      }\n    }\n  ],\n  \"has_more\": false\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Likes and follows",
      "item": [
        {
          "name": "Like a listing",
          "request": {
            "method": "PUT",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/market/listings/:id/like",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "market",
                "listings",
                ":id",
                "like"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "description": "Saves it to your likes (the heart). Doing it twice is fine.\n\nNeeds the `buying` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "PUT",
                "url": "{{baseUrl}}/market/listings/:id/like"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"like\",\n  \"listing\": \"8d1e6c2a-…\",\n  \"liked\": true\n}"
            }
          ]
        },
        {
          "name": "Unlike a listing",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/market/listings/:id/like",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "market",
                "listings",
                ":id",
                "like"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "description": "Needs the `buying` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "DELETE",
                "url": "{{baseUrl}}/market/listings/:id/like"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"like\",\n  \"listing\": \"8d1e6c2a-…\",\n  \"liked\": false\n}"
            }
          ]
        },
        {
          "name": "Your likes",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/likes",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "likes"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "",
                  "description": "How many to return, 1 to 100. Default 25.",
                  "disabled": true
                },
                {
                  "key": "offset",
                  "value": "",
                  "description": "How many to skip, for the next page.",
                  "disabled": true
                }
              ]
            },
            "description": "Everything you've liked: still for sale first, then sold."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "GET",
                "url": "{{baseUrl}}/likes"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"list\",\n  \"data\": [\n    {\n      \"object\": \"public_listing\",\n      \"id\": \"8d1e6c2a-…\",\n      \"slug\": \"yellow-le-creuset-dutch-oven-5-5-qt\",\n      \"store\": \"maya\",\n      \"title\": \"Yellow Le Creuset dutch oven, 5.5 qt\",\n      \"one_liner\": \"The good one, barely used, ready for soup season\",\n      \"price\": 185,\n      \"shipping\": 18,\n      \"photo\": \"https://files.resell.store/…\",\n      \"category\": \"Home\",\n      \"open_to_offers\": true,\n      \"sold\": false,\n      \"just_listed\": false,\n      \"url\": \"https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt\",\n      \"seller\": {\n        \"name\": \"Maya's closet\"\n      },\n      \"liked\": true\n    }\n  ],\n  \"total\": 1,\n  \"has_more\": false\n}"
            }
          ]
        },
        {
          "name": "Follow a store",
          "request": {
            "method": "PUT",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/market/stores/:slug/follow",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "market",
                "stores",
                ":slug",
                "follow"
              ],
              "variable": [
                {
                  "key": "slug",
                  "value": "",
                  "description": "The slug."
                }
              ]
            },
            "description": "New things from stores you follow show on your Home.\n\nNeeds the `buying` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "PUT",
                "url": "{{baseUrl}}/market/stores/:slug/follow"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"follow\",\n  \"store\": \"maya\",\n  \"following\": true\n}"
            }
          ]
        },
        {
          "name": "Unfollow a store",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/market/stores/:slug/follow",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "market",
                "stores",
                ":slug",
                "follow"
              ],
              "variable": [
                {
                  "key": "slug",
                  "value": "",
                  "description": "The slug."
                }
              ]
            },
            "description": "Needs the `buying` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "DELETE",
                "url": "{{baseUrl}}/market/stores/:slug/follow"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"follow\",\n  \"store\": \"maya\",\n  \"following\": false\n}"
            }
          ]
        },
        {
          "name": "Stores you follow",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/following",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "following"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "",
                  "description": "How many to return, 1 to 100. Default 25.",
                  "disabled": true
                },
                {
                  "key": "offset",
                  "value": "",
                  "description": "How many to skip, for the next page.",
                  "disabled": true
                }
              ]
            },
            "description": "Most recently followed first, each with its newest few listings."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "GET",
                "url": "{{baseUrl}}/following"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"list\",\n  \"data\": [\n    {\n      \"object\": \"followed_store\",\n      \"slug\": \"maya\",\n      \"name\": \"Maya's closet\",\n      \"for_sale\": 12,\n      \"has_new\": true,\n      \"newest\": [\n        {\n          \"id\": \"8d1e…\",\n          \"title\": \"Yellow Le Creuset dutch oven, 5.5 qt\",\n          \"price\": 185,\n          \"url\": \"https://maya.resell.store/…\"\n        }\n      ]\n    }\n  ],\n  \"total\": 1,\n  \"has_more\": false\n}"
            }
          ]
        },
        {
          "name": "Share a listing",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/market/listings/:id/share",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "market",
                "listings",
                ":id",
                "share"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "The id."
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"channel\": \"whatsapp\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Gives you the listing's link to share, tagged with where it's going (so the seller's stats can tell), and counts the share.\n\nNeeds the `buying` scope."
          },
          "response": [
            {
              "name": "Example",
              "originalRequest": {
                "method": "POST",
                "url": "{{baseUrl}}/market/listings/:id/share"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"object\": \"share\",\n  \"listing\": \"8d1e6c2a-…\",\n  \"url\": \"https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt?ref=whatsapp\",\n  \"text\": \"Yellow Le Creuset dutch oven, 5.5 qt, $185 at Maya's closet\"\n}"
            }
          ]
        }
      ]
    }
  ]
}