From d690a8277049180d73f13812c73d9d17418d9944 Mon Sep 17 00:00:00 2001 From: Jason Wang Date: Mon, 3 Aug 2026 15:09:34 -0700 Subject: [PATCH] feat(openapi): require businessInfo.country on business customer create MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit `country` is the country of incorporation, and it decides which other KYB fields a business has to supply — a US business needs close to all of them. It cannot be a deferred field: without it the create request carries no jurisdiction to apply requirements against, and `POST /verifications` already rejects a business that reaches verification without one. It also makes create-time dedup reliable: sparkcore matches an existing business on (registrationNumber, country), and skips the check entirely when either is absent. Breaking: adding to a request body's `required` is an oasdiff ERR, so this PR will be labelled breaking-change and needs an API reviewer. Callers that create business customers without `businessInfo.country` today start getting a 400 once the generated clients pick this up. Co-Authored-By: Claude Opus 5 (1M context) --- mintlify/openapi.yaml | 1 + openapi.yaml | 1 + openapi/components/schemas/customers/BusinessInfo.yaml | 1 + 3 files changed, 3 insertions(+) diff --git a/mintlify/openapi.yaml b/mintlify/openapi.yaml index ea671da12..3860f3390 100644 --- a/mintlify/openapi.yaml +++ b/mintlify/openapi.yaml @@ -12886,6 +12886,7 @@ components: description: Additional information required for business entities required: - legalName + - country - taxId - incorporatedOn properties: diff --git a/openapi.yaml b/openapi.yaml index ea671da12..3860f3390 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -12886,6 +12886,7 @@ components: description: Additional information required for business entities required: - legalName + - country - taxId - incorporatedOn properties: diff --git a/openapi/components/schemas/customers/BusinessInfo.yaml b/openapi/components/schemas/customers/BusinessInfo.yaml index 6c90887e2..fdb6d3d1e 100644 --- a/openapi/components/schemas/customers/BusinessInfo.yaml +++ b/openapi/components/schemas/customers/BusinessInfo.yaml @@ -2,6 +2,7 @@ type: object description: Additional information required for business entities required: - legalName + - country - taxId - incorporatedOn properties: