---
title: "entities.execute_consolidation_plan"
method: POST
path: "/capabilities/entities.execute_consolidation_plan"
tags: ["Capabilities"]
---

# entities.execute_consolidation_plan

`POST /capabilities/entities.execute_consolidation_plan`

Execute one approved group from a reviewed legal entity consolidation plan.

## Request body

- object
  - `planHash` string, required
  - `groupId` string, required
  - `plan` object, required
    - `planHash` string, required
    - `generatedAt` string, required
    - `maxEntities` integer, required
    - `totalEntities` integer, required
    - `groups` object[], required
      - `id` string, required
      - `keepEntity` object, required
        - `id` string, required
        - `name` string, required
        - `aliases` string[]
        - `streetAddress` string
        - `addressLine2` string
        - `city` string
        - `stateOrProvince` string
        - `postalCode` string
        - `country` string
        - `googlePlaceId` string
        - `taxId` string
        - `linkedDocumentsCount` integer
        - `signature` string, required
      - `mergeEntities` KeepEntity[], required — unresolved $ref
      - `matchReason` 'same_place_id' | 'embedding_similarity', required
      - `confidence` number, required
      - `policy` object, required
        - `status` 'executable' | 'needs_review' | 'blocked', required
        - `reason` 'same_google_place' | 'compatible_name_and_location' | 'conflicting_location' | 'embedding_only', required
        - `executable` boolean, required
        - `message` string, required
      - `linkedDocumentsCount` integer, required

## Response `200`

Successful response

- object
  - `success` boolean
  - `code` integer
  - `data` object
    - `result` object — Capability-specific result

## Other responses

- `400` — Invalid input
- `401` — Authentication required
- `404` — Resource not found

---

[API](https://skmtc.net/receiptor/apis/receiptor-ai-api.md) · [All operations](https://skmtc.net/receiptor/apis/receiptor-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/receiptor/receiptor-ai-api/revisions/6687ff8993a0/schema)