{
  "info": {
    "name": "Octoship public API",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "description": "Set api_key and base_url. Each mutation retains its own idempotency key for retries; clear idempotency_<operationId> before a new logical operation. Replace sample IDs/body fields with your resources."
  },
  "variable": [
    {
      "key": "base_url",
      "value": "https://api.octoship.com"
    },
    {
      "key": "api_key",
      "value": ""
    }
  ],
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{api_key}}",
        "type": "string"
      }
    ]
  },
  "item": [
    {
      "name": "applyShippingRules",
      "request": {
        "method": "POST",
        "description": "Re-evaluates rules for orders awaiting shipment (or the ones given) and records each decision on the order. Orders are also evaluated automatically when imported or edited.",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Idempotency-Key",
            "value": "{{idempotency_applyShippingRules}}"
          }
        ],
        "url": "{{base_url}}/v1/shipping_rules/apply",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      },
      "event": [
        {
          "listen": "prerequest",
          "script": {
            "type": "text/javascript",
            "exec": [
              "if (!pm.collectionVariables.get(\"idempotency_applyShippingRules\")) pm.collectionVariables.set(\"idempotency_applyShippingRules\", pm.variables.replaceIn(\"{{$guid}}\"));"
            ]
          }
        }
      ]
    },
    {
      "name": "connectStore",
      "request": {
        "method": "POST",
        "description": "Returns the platform's approval URL. After the merchant approves, they're sent to `return_url` with `?store_connection=<id>` and recent orders start importing; if they cancel, with `?error=access_denied`. The URL expires after 10 minutes.",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Idempotency-Key",
            "value": "{{idempotency_connectStore}}"
          }
        ],
        "url": "{{base_url}}/v1/store_connections",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"platform\": \"shopify\",\n  \"shop_domain\": \"salty-goods.myshopify.com\",\n  \"return_url\": \"https://example.com/webhooks\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      },
      "event": [
        {
          "listen": "prerequest",
          "script": {
            "type": "text/javascript",
            "exec": [
              "if (!pm.collectionVariables.get(\"idempotency_connectStore\")) pm.collectionVariables.set(\"idempotency_connectStore\", pm.variables.replaceIn(\"{{$guid}}\"));"
            ]
          }
        }
      ]
    },
    {
      "name": "createAddress",
      "request": {
        "method": "POST",
        "description": "With `is_default_from: true` it becomes the store's default ship-from address, replacing the previous one.",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Idempotency-Key",
            "value": "{{idempotency_createAddress}}"
          }
        ],
        "url": "{{base_url}}/v1/addresses",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"line1\": \"string\",\n  \"city\": \"string\",\n  \"country\": \"US\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      },
      "event": [
        {
          "listen": "prerequest",
          "script": {
            "type": "text/javascript",
            "exec": [
              "if (!pm.collectionVariables.get(\"idempotency_createAddress\")) pm.collectionVariables.set(\"idempotency_createAddress\", pm.variables.replaceIn(\"{{$guid}}\"));"
            ]
          }
        }
      ]
    },
    {
      "name": "createBatch",
      "request": {
        "method": "POST",
        "description": "Queues up to 1,000 distinct shipment rates in your current mode. Each label is metered separately. Poll the batch and its items for progress and partial failures. Uncertain purchases remain pending with their holds intact; retries never authorize a new charge.",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Idempotency-Key",
            "value": "{{idempotency_createBatch}}"
          }
        ],
        "url": "{{base_url}}/v1/batches",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"rate_ids\": [\n    \"0193a5c4-6f7e-7d4b-9c1a-3e2f1a0b9c8d\"\n  ]\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      },
      "event": [
        {
          "listen": "prerequest",
          "script": {
            "type": "text/javascript",
            "exec": [
              "if (!pm.collectionVariables.get(\"idempotency_createBatch\")) pm.collectionVariables.set(\"idempotency_createBatch\", pm.variables.replaceIn(\"{{$guid}}\"));"
            ]
          }
        }
      ]
    },
    {
      "name": "createCardSetup",
      "request": {
        "method": "POST",
        "description": "Start saving a payment card",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Idempotency-Key",
            "value": "{{idempotency_createCardSetup}}"
          }
        ],
        "url": "{{base_url}}/v1/billing/card_setup",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      },
      "event": [
        {
          "listen": "prerequest",
          "script": {
            "type": "text/javascript",
            "exec": [
              "if (!pm.collectionVariables.get(\"idempotency_createCardSetup\")) pm.collectionVariables.set(\"idempotency_createCardSetup\", pm.variables.replaceIn(\"{{$guid}}\"));"
            ]
          }
        }
      ]
    },
    {
      "name": "createLabel",
      "request": {
        "method": "POST",
        "description": "Buys the label for a rate and charges your balance. Usually completes inline (`201`, status `purchased`, `url` set). If the courier is slow you get `202` with status `purchasing`: poll the label until it settles.",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Idempotency-Key",
            "value": "{{idempotency_createLabel}}"
          }
        ],
        "url": "{{base_url}}/v1/labels",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"rate_id\": \"0193a5c4-6f7e-7d4b-9c1a-3e2f1a0b9c8d\",\n  \"format\": \"pdf\",\n  \"size\": \"4x6\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      },
      "event": [
        {
          "listen": "prerequest",
          "script": {
            "type": "text/javascript",
            "exec": [
              "if (!pm.collectionVariables.get(\"idempotency_createLabel\")) pm.collectionVariables.set(\"idempotency_createLabel\", pm.variables.replaceIn(\"{{$guid}}\"));"
            ]
          }
        }
      ]
    },
    {
      "name": "createOrder",
      "request": {
        "method": "POST",
        "description": "Create a manual order",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Idempotency-Key",
            "value": "{{idempotency_createOrder}}"
          }
        ],
        "url": "{{base_url}}/v1/orders",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"ship_to\": {\n    \"line1\": \"string\",\n    \"city\": \"string\",\n    \"country\": \"US\"\n  },\n  \"items\": [\n    {\n      \"title\": \"string\",\n      \"quantity\": 1\n    }\n  ]\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      },
      "event": [
        {
          "listen": "prerequest",
          "script": {
            "type": "text/javascript",
            "exec": [
              "if (!pm.collectionVariables.get(\"idempotency_createOrder\")) pm.collectionVariables.set(\"idempotency_createOrder\", pm.variables.replaceIn(\"{{$guid}}\"));"
            ]
          }
        }
      ]
    },
    {
      "name": "createPackagePreset",
      "request": {
        "method": "POST",
        "description": "With `is_default: true` it replaces the store's current default preset.",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Idempotency-Key",
            "value": "{{idempotency_createPackagePreset}}"
          }
        ],
        "url": "{{base_url}}/v1/package_presets",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"string\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      },
      "event": [
        {
          "listen": "prerequest",
          "script": {
            "type": "text/javascript",
            "exec": [
              "if (!pm.collectionVariables.get(\"idempotency_createPackagePreset\")) pm.collectionVariables.set(\"idempotency_createPackagePreset\", pm.variables.replaceIn(\"{{$guid}}\"));"
            ]
          }
        }
      ]
    },
    {
      "name": "createShippingRule",
      "request": {
        "method": "POST",
        "description": "Added at `position` (default: last); later rules shift down.",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Idempotency-Key",
            "value": "{{idempotency_createShippingRule}}"
          }
        ],
        "url": "{{base_url}}/v1/shipping_rules",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"string\",\n  \"conditions\": [\n    {\n      \"field\": \"weight\",\n      \"op\": \"eq\",\n      \"value\": \"string\"\n    }\n  ],\n  \"action\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      },
      "event": [
        {
          "listen": "prerequest",
          "script": {
            "type": "text/javascript",
            "exec": [
              "if (!pm.collectionVariables.get(\"idempotency_createShippingRule\")) pm.collectionVariables.set(\"idempotency_createShippingRule\", pm.variables.replaceIn(\"{{$guid}}\"));"
            ]
          }
        }
      ]
    },
    {
      "name": "createTopUp",
      "request": {
        "method": "POST",
        "description": "Charges the saved payment method. The balance is credited once the payment succeeds.",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Idempotency-Key",
            "value": "{{idempotency_createTopUp}}"
          }
        ],
        "url": "{{base_url}}/v1/balance/top_ups",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"amount\": {\n    \"amount\": 2500,\n    \"currency\": \"USD\"\n  }\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      },
      "event": [
        {
          "listen": "prerequest",
          "script": {
            "type": "text/javascript",
            "exec": [
              "if (!pm.collectionVariables.get(\"idempotency_createTopUp\")) pm.collectionVariables.set(\"idempotency_createTopUp\", pm.variables.replaceIn(\"{{$guid}}\"));"
            ]
          }
        }
      ]
    },
    {
      "name": "createWebhookEndpoint",
      "request": {
        "method": "POST",
        "description": "Only HTTPS destinations are accepted. The signing secret is returned on creation; keep it secure. Endpoint mode must match the authenticated mode.",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Idempotency-Key",
            "value": "{{idempotency_createWebhookEndpoint}}"
          }
        ],
        "url": "{{base_url}}/v1/webhook_endpoints",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"url\": \"https://example.com/webhooks\",\n  \"mode\": \"test\",\n  \"events\": [\n    \"label.created\",\n    \"tracker.updated\"\n  ]\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      },
      "event": [
        {
          "listen": "prerequest",
          "script": {
            "type": "text/javascript",
            "exec": [
              "if (!pm.collectionVariables.get(\"idempotency_createWebhookEndpoint\")) pm.collectionVariables.set(\"idempotency_createWebhookEndpoint\", pm.variables.replaceIn(\"{{$guid}}\"));"
            ]
          }
        }
      ]
    },
    {
      "name": "deleteAddress",
      "request": {
        "method": "DELETE",
        "description": "Delete a saved address",
        "header": [
          {
            "key": "Idempotency-Key",
            "value": "{{idempotency_deleteAddress}}"
          }
        ],
        "url": "{{base_url}}/v1/addresses/{{id}}"
      },
      "event": [
        {
          "listen": "prerequest",
          "script": {
            "type": "text/javascript",
            "exec": [
              "if (!pm.collectionVariables.get(\"idempotency_deleteAddress\")) pm.collectionVariables.set(\"idempotency_deleteAddress\", pm.variables.replaceIn(\"{{$guid}}\"));"
            ]
          }
        }
      ]
    },
    {
      "name": "deletePackagePreset",
      "request": {
        "method": "DELETE",
        "description": "Shipments already created with it keep their dimensions. Rules that pointed at it fall back to the order's own package.",
        "header": [
          {
            "key": "Idempotency-Key",
            "value": "{{idempotency_deletePackagePreset}}"
          }
        ],
        "url": "{{base_url}}/v1/package_presets/{{id}}"
      },
      "event": [
        {
          "listen": "prerequest",
          "script": {
            "type": "text/javascript",
            "exec": [
              "if (!pm.collectionVariables.get(\"idempotency_deletePackagePreset\")) pm.collectionVariables.set(\"idempotency_deletePackagePreset\", pm.variables.replaceIn(\"{{$guid}}\"));"
            ]
          }
        }
      ]
    },
    {
      "name": "deletePaymentMethod",
      "request": {
        "method": "DELETE",
        "description": "Remove a saved payment card",
        "header": [
          {
            "key": "Idempotency-Key",
            "value": "{{idempotency_deletePaymentMethod}}"
          }
        ],
        "url": "{{base_url}}/v1/billing/payment_methods/{{id}}"
      },
      "event": [
        {
          "listen": "prerequest",
          "script": {
            "type": "text/javascript",
            "exec": [
              "if (!pm.collectionVariables.get(\"idempotency_deletePaymentMethod\")) pm.collectionVariables.set(\"idempotency_deletePaymentMethod\", pm.variables.replaceIn(\"{{$guid}}\"));"
            ]
          }
        }
      ]
    },
    {
      "name": "deleteShippingRule",
      "request": {
        "method": "DELETE",
        "description": "Delete a shipping rule",
        "header": [
          {
            "key": "Idempotency-Key",
            "value": "{{idempotency_deleteShippingRule}}"
          }
        ],
        "url": "{{base_url}}/v1/shipping_rules/{{id}}"
      },
      "event": [
        {
          "listen": "prerequest",
          "script": {
            "type": "text/javascript",
            "exec": [
              "if (!pm.collectionVariables.get(\"idempotency_deleteShippingRule\")) pm.collectionVariables.set(\"idempotency_deleteShippingRule\", pm.variables.replaceIn(\"{{$guid}}\"));"
            ]
          }
        }
      ]
    },
    {
      "name": "deleteStoreConnection",
      "request": {
        "method": "DELETE",
        "description": "Stops importing orders and revokes our access to the store. Orders already imported stay.",
        "header": [
          {
            "key": "Idempotency-Key",
            "value": "{{idempotency_deleteStoreConnection}}"
          }
        ],
        "url": "{{base_url}}/v1/store_connections/{{id}}"
      },
      "event": [
        {
          "listen": "prerequest",
          "script": {
            "type": "text/javascript",
            "exec": [
              "if (!pm.collectionVariables.get(\"idempotency_deleteStoreConnection\")) pm.collectionVariables.set(\"idempotency_deleteStoreConnection\", pm.variables.replaceIn(\"{{$guid}}\"));"
            ]
          }
        }
      ]
    },
    {
      "name": "deleteWebhookEndpoint",
      "request": {
        "method": "DELETE",
        "description": "Delete a webhook endpoint",
        "header": [
          {
            "key": "Idempotency-Key",
            "value": "{{idempotency_deleteWebhookEndpoint}}"
          }
        ],
        "url": "{{base_url}}/v1/webhook_endpoints/{{id}}"
      },
      "event": [
        {
          "listen": "prerequest",
          "script": {
            "type": "text/javascript",
            "exec": [
              "if (!pm.collectionVariables.get(\"idempotency_deleteWebhookEndpoint\")) pm.collectionVariables.set(\"idempotency_deleteWebhookEndpoint\", pm.variables.replaceIn(\"{{$guid}}\"));"
            ]
          }
        }
      ]
    },
    {
      "name": "exportSpendReport",
      "request": {
        "method": "POST",
        "description": "Export postage spend as CSV",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Idempotency-Key",
            "value": "{{idempotency_exportSpendReport}}"
          }
        ],
        "url": "{{base_url}}/v1/reports/spend/exports",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"from\": \"string\",\n  \"to\": \"string\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      },
      "event": [
        {
          "listen": "prerequest",
          "script": {
            "type": "text/javascript",
            "exec": [
              "if (!pm.collectionVariables.get(\"idempotency_exportSpendReport\")) pm.collectionVariables.set(\"idempotency_exportSpendReport\", pm.variables.replaceIn(\"{{$guid}}\"));"
            ]
          }
        }
      ]
    },
    {
      "name": "getAddress",
      "request": {
        "method": "GET",
        "description": "Retrieve a saved address",
        "header": [],
        "url": "{{base_url}}/v1/addresses/{{id}}"
      }
    },
    {
      "name": "getBalance",
      "request": {
        "method": "GET",
        "description": "Available funds, funds held for labels being purchased, and auto-reload settings, for one currency.",
        "header": [],
        "url": "{{base_url}}/v1/balance"
      }
    },
    {
      "name": "getBatch",
      "request": {
        "method": "GET",
        "description": "Includes counts and a fresh combined-PDF link when ready. Completion requires every purchase to reach an authoritative final outcome.",
        "header": [],
        "url": "{{base_url}}/v1/batches/{{id}}"
      }
    },
    {
      "name": "getBillingSettings",
      "request": {
        "method": "GET",
        "description": "Retrieve billing settings",
        "header": [],
        "url": "{{base_url}}/v1/billing"
      }
    },
    {
      "name": "getLabel",
      "request": {
        "method": "GET",
        "description": "`url` is a short-lived signed link, issued fresh on every read.",
        "header": [],
        "url": "{{base_url}}/v1/labels/{{id}}"
      }
    },
    {
      "name": "getLabelDocuments",
      "request": {
        "method": "GET",
        "description": "Returns fresh signed links to carrier-issued customs PDFs. An empty list means no separate forms were supplied; forms may be electronic or included on the label. Does not buy another label or create a declaration.",
        "header": [],
        "url": "{{base_url}}/v1/labels/{{id}}/documents"
      }
    },
    {
      "name": "getOrder",
      "request": {
        "method": "GET",
        "description": "Get an order",
        "header": [],
        "url": "{{base_url}}/v1/orders/{{id}}"
      }
    },
    {
      "name": "getOrderCounts",
      "request": {
        "method": "GET",
        "description": "Order counts by status",
        "header": [],
        "url": "{{base_url}}/v1/orders/counts"
      }
    },
    {
      "name": "getPackagePreset",
      "request": {
        "method": "GET",
        "description": "Retrieve a package preset",
        "header": [],
        "url": "{{base_url}}/v1/package_presets/{{id}}"
      }
    },
    {
      "name": "getPaymentReceipt",
      "request": {
        "method": "GET",
        "description": "Download a payment receipt",
        "header": [],
        "url": "{{base_url}}/v1/payments/{{id}}/receipt"
      }
    },
    {
      "name": "getShipment",
      "request": {
        "method": "GET",
        "description": "Retrieve a shipment",
        "header": [],
        "url": "{{base_url}}/v1/shipments/{{id}}"
      }
    },
    {
      "name": "getShippingRule",
      "request": {
        "method": "GET",
        "description": "Retrieve a shipping rule",
        "header": [],
        "url": "{{base_url}}/v1/shipping_rules/{{id}}"
      }
    },
    {
      "name": "getSpendReport",
      "request": {
        "method": "GET",
        "description": "Ledger-backed totals for the authenticated store and mode. Refunds are reported when settled. All amounts use minor units.",
        "header": [],
        "url": "{{base_url}}/v1/reports/spend"
      }
    },
    {
      "name": "getStoreConnection",
      "request": {
        "method": "GET",
        "description": "Retrieve a store connection",
        "header": [],
        "url": "{{base_url}}/v1/store_connections/{{id}}"
      }
    },
    {
      "name": "getTracker",
      "request": {
        "method": "GET",
        "description": "Includes the full event timeline, oldest first.",
        "header": [],
        "url": "{{base_url}}/v1/trackers/{{id}}"
      }
    },
    {
      "name": "getWebhookEndpoint",
      "request": {
        "method": "GET",
        "description": "Retrieve a webhook endpoint",
        "header": [],
        "url": "{{base_url}}/v1/webhook_endpoints/{{id}}"
      }
    },
    {
      "name": "importOrders",
      "request": {
        "method": "POST",
        "description": "Valid orders are saved; invalid ones are reported per row and skipped. Idempotent per order number.",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Idempotency-Key",
            "value": "{{idempotency_importOrders}}"
          }
        ],
        "url": "{{base_url}}/v1/orders/import",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"csv\": \"string\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      },
      "event": [
        {
          "listen": "prerequest",
          "script": {
            "type": "text/javascript",
            "exec": [
              "if (!pm.collectionVariables.get(\"idempotency_importOrders\")) pm.collectionVariables.set(\"idempotency_importOrders\", pm.variables.replaceIn(\"{{$guid}}\"));"
            ]
          }
        }
      ]
    },
    {
      "name": "listAddresses",
      "request": {
        "method": "GET",
        "description": "The default ship-from address first, then newest first.",
        "header": [],
        "url": "{{base_url}}/v1/addresses"
      }
    },
    {
      "name": "listBalanceTransactions",
      "request": {
        "method": "GET",
        "description": "Every change to the balance, newest first: top-ups, label charges, refunds, fees and adjustments.",
        "header": [],
        "url": "{{base_url}}/v1/balance/transactions"
      }
    },
    {
      "name": "listBatches",
      "request": {
        "method": "GET",
        "description": "List label batches",
        "header": [],
        "url": "{{base_url}}/v1/batches"
      }
    },
    {
      "name": "listBatchItems",
      "request": {
        "method": "GET",
        "description": "Returns each selected rate, its label when allocated, and a customer-safe failure when applicable.",
        "header": [],
        "url": "{{base_url}}/v1/batches/{{id}}/items"
      }
    },
    {
      "name": "listLabels",
      "request": {
        "method": "GET",
        "description": "Newest first.",
        "header": [],
        "url": "{{base_url}}/v1/labels"
      }
    },
    {
      "name": "listOrders",
      "request": {
        "method": "GET",
        "description": "Newest first (by placed date). Filter by status, platform, store connection, destination or a search term.",
        "header": [],
        "url": "{{base_url}}/v1/orders"
      }
    },
    {
      "name": "listPackagePresets",
      "request": {
        "method": "GET",
        "description": "The default preset first, then by name.",
        "header": [],
        "url": "{{base_url}}/v1/package_presets"
      }
    },
    {
      "name": "listPaymentMethods",
      "request": {
        "method": "GET",
        "description": "List saved payment cards",
        "header": [],
        "url": "{{base_url}}/v1/billing/payment_methods"
      }
    },
    {
      "name": "listPayments",
      "request": {
        "method": "GET",
        "description": "List payments",
        "header": [],
        "url": "{{base_url}}/v1/payments"
      }
    },
    {
      "name": "listShipments",
      "request": {
        "method": "GET",
        "description": "Newest first.",
        "header": [],
        "url": "{{base_url}}/v1/shipments"
      }
    },
    {
      "name": "listShippingRules",
      "request": {
        "method": "GET",
        "description": "Every rule in evaluation order (first match wins; no match → cheapest rate). Not paginated (at most 200 rules).",
        "header": [],
        "url": "{{base_url}}/v1/shipping_rules"
      }
    },
    {
      "name": "listStoreConnections",
      "request": {
        "method": "GET",
        "description": "Stores and marketplaces orders are imported from. Use `getOrderCounts?store_connection_id=` for per-store order counts.",
        "header": [],
        "url": "{{base_url}}/v1/store_connections"
      }
    },
    {
      "name": "listTrackers",
      "request": {
        "method": "GET",
        "description": "Most recently updated first. `events` is empty in list responses; retrieve a tracker for its timeline.",
        "header": [],
        "url": "{{base_url}}/v1/trackers"
      }
    },
    {
      "name": "listWebhookDeliveries",
      "request": {
        "method": "GET",
        "description": "List webhook deliveries",
        "header": [],
        "url": "{{base_url}}/v1/webhook_endpoints/{{id}}/deliveries"
      }
    },
    {
      "name": "listWebhookEndpoints",
      "request": {
        "method": "GET",
        "description": "List webhook endpoints",
        "header": [],
        "url": "{{base_url}}/v1/webhook_endpoints"
      }
    },
    {
      "name": "lookupBatch",
      "request": {
        "method": "POST",
        "description": "Read-only POST with read permission. No lookup Idempotency-Key is required and responses use Cache-Control: no-store. Reads an existing batch without creating work, changing a reservation or reopening the original request claim. An unknown result may still commit; retain the original body/key and never start a replacement purchase automatically.",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": "{{base_url}}/v1/batches/lookup",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"request_key\": \"string\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "quoteRates",
      "request": {
        "method": "POST",
        "description": "Saves the shipment (status `rated`) and returns live rates from every courier available at its origin, cheapest first, in your store's currency. Couriers that fail to quote are listed in `messages`; the rest are still returned.",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Idempotency-Key",
            "value": "{{idempotency_quoteRates}}"
          }
        ],
        "url": "{{base_url}}/v1/rates",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"from_address\": {\n    \"name\": \"Octoship sender\",\n    \"line1\": \"1 Market St\",\n    \"city\": \"San Francisco\",\n    \"region\": \"CA\",\n    \"postal_code\": \"94105\",\n    \"country\": \"US\",\n    \"phone\": \"+14155550100\"\n  },\n  \"to_address\": {\n    \"name\": \"Test recipient\",\n    \"line1\": \"350 5th Ave\",\n    \"city\": \"New York\",\n    \"region\": \"NY\",\n    \"postal_code\": \"10118\",\n    \"country\": \"US\",\n    \"phone\": \"+12125550100\"\n  },\n  \"parcel\": {\n    \"weight\": {\n      \"value\": 12,\n      \"unit\": \"oz\"\n    }\n  }\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      },
      "event": [
        {
          "listen": "prerequest",
          "script": {
            "type": "text/javascript",
            "exec": [
              "if (!pm.collectionVariables.get(\"idempotency_quoteRates\")) pm.collectionVariables.set(\"idempotency_quoteRates\", pm.variables.replaceIn(\"{{$guid}}\"));"
            ]
          }
        }
      ]
    },
    {
      "name": "reorderShippingRules",
      "request": {
        "method": "POST",
        "description": "Send every rule id in the new order.",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Idempotency-Key",
            "value": "{{idempotency_reorderShippingRules}}"
          }
        ],
        "url": "{{base_url}}/v1/shipping_rules/reorder",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"ids\": [\n    \"0193a5c4-6f7e-7d4b-9c1a-3e2f1a0b9c8d\"\n  ]\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      },
      "event": [
        {
          "listen": "prerequest",
          "script": {
            "type": "text/javascript",
            "exec": [
              "if (!pm.collectionVariables.get(\"idempotency_reorderShippingRules\")) pm.collectionVariables.set(\"idempotency_reorderShippingRules\", pm.variables.replaceIn(\"{{$guid}}\"));"
            ]
          }
        }
      ]
    },
    {
      "name": "replayWebhookDelivery",
      "request": {
        "method": "POST",
        "description": "Schedules a new delivery attempt using the original event ID and payload. Receivers must deduplicate by event ID.",
        "header": [
          {
            "key": "Idempotency-Key",
            "value": "{{idempotency_replayWebhookDelivery}}"
          }
        ],
        "url": "{{base_url}}/v1/webhook_endpoints/{{id}}/deliveries/{{delivery_id}}/replay"
      },
      "event": [
        {
          "listen": "prerequest",
          "script": {
            "type": "text/javascript",
            "exec": [
              "if (!pm.collectionVariables.get(\"idempotency_replayWebhookDelivery\")) pm.collectionVariables.set(\"idempotency_replayWebhookDelivery\", pm.variables.replaceIn(\"{{$guid}}\"));"
            ]
          }
        }
      ]
    },
    {
      "name": "requoteShipment",
      "request": {
        "method": "POST",
        "description": "Fresh rates for an existing shipment (e.g. after its rates expired).",
        "header": [
          {
            "key": "Idempotency-Key",
            "value": "{{idempotency_requoteShipment}}"
          }
        ],
        "url": "{{base_url}}/v1/shipments/{{id}}/rates"
      },
      "event": [
        {
          "listen": "prerequest",
          "script": {
            "type": "text/javascript",
            "exec": [
              "if (!pm.collectionVariables.get(\"idempotency_requoteShipment\")) pm.collectionVariables.set(\"idempotency_requoteShipment\", pm.variables.replaceIn(\"{{$guid}}\"));"
            ]
          }
        }
      ]
    },
    {
      "name": "syncStoreConnection",
      "request": {
        "method": "POST",
        "description": "Queues an import of orders changed since the last sync. Orders also arrive in real time through platform webhooks.",
        "header": [
          {
            "key": "Idempotency-Key",
            "value": "{{idempotency_syncStoreConnection}}"
          }
        ],
        "url": "{{base_url}}/v1/store_connections/{{id}}/sync"
      },
      "event": [
        {
          "listen": "prerequest",
          "script": {
            "type": "text/javascript",
            "exec": [
              "if (!pm.collectionVariables.get(\"idempotency_syncStoreConnection\")) pm.collectionVariables.set(\"idempotency_syncStoreConnection\", pm.variables.replaceIn(\"{{$guid}}\"));"
            ]
          }
        }
      ]
    },
    {
      "name": "updateAddress",
      "request": {
        "method": "PATCH",
        "description": "Shipments keep the address as it was when they were created.",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Idempotency-Key",
            "value": "{{idempotency_updateAddress}}"
          }
        ],
        "url": "{{base_url}}/v1/addresses/{{id}}",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      },
      "event": [
        {
          "listen": "prerequest",
          "script": {
            "type": "text/javascript",
            "exec": [
              "if (!pm.collectionVariables.get(\"idempotency_updateAddress\")) pm.collectionVariables.set(\"idempotency_updateAddress\", pm.variables.replaceIn(\"{{$guid}}\"));"
            ]
          }
        }
      ]
    },
    {
      "name": "updateBillingSettings",
      "request": {
        "method": "PATCH",
        "description": "Update saved card and auto-reload settings",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Idempotency-Key",
            "value": "{{idempotency_updateBillingSettings}}"
          }
        ],
        "url": "{{base_url}}/v1/billing",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      },
      "event": [
        {
          "listen": "prerequest",
          "script": {
            "type": "text/javascript",
            "exec": [
              "if (!pm.collectionVariables.get(\"idempotency_updateBillingSettings\")) pm.collectionVariables.set(\"idempotency_updateBillingSettings\", pm.variables.replaceIn(\"{{$guid}}\"));"
            ]
          }
        }
      ]
    },
    {
      "name": "updateOrder",
      "request": {
        "method": "PATCH",
        "description": "Hold, release or cancel an order, or fix its address, weight or tags. Shipped orders can't be changed.",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Idempotency-Key",
            "value": "{{idempotency_updateOrder}}"
          }
        ],
        "url": "{{base_url}}/v1/orders/{{id}}",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      },
      "event": [
        {
          "listen": "prerequest",
          "script": {
            "type": "text/javascript",
            "exec": [
              "if (!pm.collectionVariables.get(\"idempotency_updateOrder\")) pm.collectionVariables.set(\"idempotency_updateOrder\", pm.variables.replaceIn(\"{{$guid}}\"));"
            ]
          }
        }
      ]
    },
    {
      "name": "updatePackagePreset",
      "request": {
        "method": "PATCH",
        "description": "Update a package preset",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Idempotency-Key",
            "value": "{{idempotency_updatePackagePreset}}"
          }
        ],
        "url": "{{base_url}}/v1/package_presets/{{id}}",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      },
      "event": [
        {
          "listen": "prerequest",
          "script": {
            "type": "text/javascript",
            "exec": [
              "if (!pm.collectionVariables.get(\"idempotency_updatePackagePreset\")) pm.collectionVariables.set(\"idempotency_updatePackagePreset\", pm.variables.replaceIn(\"{{$guid}}\"));"
            ]
          }
        }
      ]
    },
    {
      "name": "updateShippingRule",
      "request": {
        "method": "PATCH",
        "description": "Update a shipping rule",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Idempotency-Key",
            "value": "{{idempotency_updateShippingRule}}"
          }
        ],
        "url": "{{base_url}}/v1/shipping_rules/{{id}}",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      },
      "event": [
        {
          "listen": "prerequest",
          "script": {
            "type": "text/javascript",
            "exec": [
              "if (!pm.collectionVariables.get(\"idempotency_updateShippingRule\")) pm.collectionVariables.set(\"idempotency_updateShippingRule\", pm.variables.replaceIn(\"{{$guid}}\"));"
            ]
          }
        }
      ]
    },
    {
      "name": "updateWebhookEndpoint",
      "request": {
        "method": "PATCH",
        "description": "Update a webhook endpoint",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Idempotency-Key",
            "value": "{{idempotency_updateWebhookEndpoint}}"
          }
        ],
        "url": "{{base_url}}/v1/webhook_endpoints/{{id}}",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      },
      "event": [
        {
          "listen": "prerequest",
          "script": {
            "type": "text/javascript",
            "exec": [
              "if (!pm.collectionVariables.get(\"idempotency_updateWebhookEndpoint\")) pm.collectionVariables.set(\"idempotency_updateWebhookEndpoint\", pm.variables.replaceIn(\"{{$guid}}\"));"
            ]
          }
        }
      ]
    },
    {
      "name": "validateAddress",
      "request": {
        "method": "POST",
        "description": "Checks one address and returns suggested corrections for review. Does not save or change an address or shipment. Availability depends on the store's shipping origin and mode.",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Idempotency-Key",
            "value": "{{idempotency_validateAddress}}"
          }
        ],
        "url": "{{base_url}}/v1/addresses/validate",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"address\": {\n    \"line1\": \"string\",\n    \"city\": \"string\",\n    \"country\": \"US\"\n  }\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      },
      "event": [
        {
          "listen": "prerequest",
          "script": {
            "type": "text/javascript",
            "exec": [
              "if (!pm.collectionVariables.get(\"idempotency_validateAddress\")) pm.collectionVariables.set(\"idempotency_validateAddress\", pm.variables.replaceIn(\"{{$guid}}\"));"
            ]
          }
        }
      ]
    },
    {
      "name": "voidLabel",
      "request": {
        "method": "POST",
        "description": "Cancels an unused label. Status becomes `voided` once the courier confirms (often immediately), or `void_requested` while it's pending; the label price is refunded to your balance on confirmation.",
        "header": [
          {
            "key": "Idempotency-Key",
            "value": "{{idempotency_voidLabel}}"
          }
        ],
        "url": "{{base_url}}/v1/labels/{{id}}/void"
      },
      "event": [
        {
          "listen": "prerequest",
          "script": {
            "type": "text/javascript",
            "exec": [
              "if (!pm.collectionVariables.get(\"idempotency_voidLabel\")) pm.collectionVariables.set(\"idempotency_voidLabel\", pm.variables.replaceIn(\"{{$guid}}\"));"
            ]
          }
        }
      ]
    }
  ]
}
