---
title: "Estimate website migration cost and time"
method: GET
path: "/agent-tools/migration-estimate"
---

# Estimate website migration cost and time

`GET /agent-tools/migration-estimate`

Uses the same live scanner and estimate model as the Ploy migration cost calculator. The upstream scan has a six-second budget. If the full browser scan is still running after page enumeration succeeds, the API returns a marked partial estimate from the evidence already collected. It never produces an estimate when page enumeration returns zero. Estimates are directional, not vendor quotes.

## Query parameters

- `url` string, required

## Response `200`

Complete or partial estimate returned after no more than six seconds of upstream scanning.

- EstimateResponse
  - `version` '1.0', required
  - `inputUrl` string, uri, required
  - `finalUrl` string, uri, required
  - `scannedAt` string, date-time, required
  - `scan` object, required
    - `status` 'complete' | 'partial', required — Complete when the full browser scan finished; partial when the response budget elapsed after useful evidence was collected.
    - `warning` string
  - `site` object, required
    - `platform` string, nullable
    - `platformConfidence` number, nullable
    - `pageCount` integer
    - `cmsItems` integer
    - `redirects` integer
    - `forms` integer
    - `locales` integer
  - `estimate` object, required
    - `currency` 'USD'
    - `agencyCostLow` number
    - `agencyCostHigh` number
    - `agencyWeeksLow` number
    - `agencyWeeksHigh` number
    - `manualHours` number
    - `ployMigrationMinutes` number
  - `recommendation` object, required — The same recommendation card content shown in the calculator UI.
  - `methodology` object, required
  - `links` object, required

## Other responses

- `400` — Invalid URL.
- `422` — The scanner could not enumerate any pages, so no estimate was produced.
- `500` — Unexpected API failure.
- `502` — The importer failed or returned no usable site evidence within six seconds.

---

[API](https://skmtc.dev/ploy/apis/ploy-migration-estimate-api.md) · [All operations](https://skmtc.dev/ploy/apis/ploy-migration-estimate-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ploy/ploy-migration-estimate-api/revisions/bbbe729b92e6/schema)