---
title: "Mark a Business Unit as validated"
method: PUT
path: "/v1/clients/{clientId}/customers/{id}/validate"
tags: ["Business Units"]
---

# Mark a Business Unit as validated

`PUT /v1/clients/{clientId}/customers/{id}/validate`

## Request

- Base URL: `https://apicore.stg.finch.lat`
- URL: `https://apicore.stg.finch.lat/v1/clients/{clientId}/customers/{id}/validate`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/monato/apis/fincore-api/docs/v1/clients/:clientId/customers/:id/validate/put.ts> (a function with typed inputs; its response is checked against the schema)

Updates the Business Unit validation status. Use only validated Business Units for production payment flows.

## Path parameters

- `clientId` string, uuid, required
- `id` string, uuid, required

## Response `200`

Business Unit validation status updated.

- CustomerResponse: Business Unit returned by Fincore.
  - `id` string, uuid, required: Business Unit UUID.
  - `clientId` string, uuid, required: Client UUID that owns the Business Unit.
  - `name` string, required: Legal name of the Business Unit.
  - `rfc` string, required: RFC tax identifier of the Business Unit.
  - `legalRepresentativeName` string, required: Full name of the legal representative.
  - `legalRepresentativeRfc` string, required: RFC tax identifier of the legal representative.
  - `legalRepresentativePhone` string, required: Contact phone number of the legal representative.
  - `legalRepresentativeEmail` string, email, required: Contact email of the legal representative.
  - `website` string, uri: Business Unit website when available.
  - `domain` string: Business Unit domain when available.
  - `customerAlias` string: Short alias used to identify the Business Unit.
  - `customerStatus` 'ACTIVE' | 'INACTIVE' | 'BLOCKED'
  - `customerValidationStatus` 'PENDING' | 'VALIDATED' | 'REJECTED'
  - `audit` Audit: Common lifecycle timestamps.
    - `createdAt` string, date-time: Timestamp when the resource was created.
    - `updatedAt` string, date-time: Timestamp when the resource was last updated.
    - `deletedAt` string, nullable: Timestamp when the resource was deleted. When it was never deleted the API returns the literal string `"None"`, not JSON `null`. Do not test this field for `null`.
    - `blockedAt` string, nullable: Timestamp when the resource was blocked. When it was never blocked the API returns the literal string `"None"`, not JSON `null`. Do not test this field for `null`.
    - `activatedAt` string, nullable: Timestamp when the resource was activated, or null.
    - `suspendedAt` string, nullable: Timestamp when the resource was suspended, or null.

## Other responses

- `400`: Business Unit validation request is invalid. Possible causes: malformed `clientId` or Business Unit `id`, or unsupported validation state transition.
- `401`: Missing, expired, invalid, or environment-mismatched API key or bearer token. See [Authentication](/products/fincore/guides/authentication.md).
- `404`: Business Unit was not found for the supplied client.

## Changes

- **2026-09-26** `e22ef66945df`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/monato/apis/fincore-api/changes/v1/clients/:clientId/customers/:id/validate/put.md)

---

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