---
title: "Check company migration readiness"
method: GET
path: "/v1/partner_managed_companies/{company_uuid}/migration_readiness"
tags: ["Companies"]
---

# Check company migration readiness

`GET /v1/partner_managed_companies/{company_uuid}/migration_readiness`

## Request

- Base URL: `https://api.gusto-demo.com`
- URL: `https://api.gusto-demo.com/v1/partner_managed_companies/{company_uuid}/migration_readiness`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/gusto/apis/gusto-api/docs/v1/partner_managed_companies/:company_uuid/migration_readiness/get.ts> (a function with typed inputs; its response is checked against the schema)

Check if an existing Gusto customer is ready to be migrated to embedded payroll. This endpoint returns blockers and warnings associated with migrating the company and is recommended to be called before attempting to migrate a company.

scope: `partner_managed_companies:read`

## Path parameters

- `company_uuid` string, required

## Headers

- `X-Gusto-API-Version` '2026-06-15'

## Response `200`

Example response

- PartnerManagedCompanyMigrationReadinessResponse: Migration warning that does not block company migration
  - `ready_to_migrate` boolean: Indicates if the company is ready to be migrated.
  - `company_uuid` string: The company UUID
  - `errors` object[]
    - `error_key` string: Error key
    - `category` string: Error category
    - `message` string: Blocker message
    - `metadata` object
      - `key` string: A categorization of the migration blocker, e.g. "migrated_company"
  - `warnings` object[]
    - `error_key` string: Error key
    - `category` string: Error category
    - `message` string: Warning message
    - `metadata` object
      - `key` string: A categorization of the migration warning, e.g. "marijuana_related_business"

## Other responses

- `404`: Not Found The requested resource does not exist. Make sure the provided UUID is valid.

---

[API](https://skmtc.dev/gusto/apis/gusto-api.md) - [All operations](https://skmtc.dev/gusto/apis/gusto-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gusto/apis/gusto-api/revisions/f98575fa2a5e?raw)