API · Manage · Governance
Change the entity name.
Cascade: board consent + stockholder consent (DGCL §242 requires majority of voting stock for a charter amendment) → Certificate of Amendment Filing with the SoS in the entity's state of incorporation → Entity.legal_name update on accepted → BOI update Filing emitted for FinCEN (31 CFR §1010.380(a)(2)(ii); 30-day window) → optional propagation to open Qualification / StateRegistration records.
Solo-founder collapse. When the same natural person is both sole director and sole stockholder, a single written consent satisfies both DGCL §141(f) and DGCL §228 simultaneously. Pass that resolution as authorizing_resolution_id.
Forward-reference population. The Filing emitted by the cascade carries this call's authorizing_resolution_id; Resolution.authorizes_filings[] gains a back-reference entry automatically when the Filing is created. Same pattern for the BOI update Filing.
Last updated
Query Parameters
dry_runbooleanOptionalIf true, simulate the mutation and return the would-be resource, any cascaded
resources, and a fee estimate — without side effects. Available on every mutation.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
new_legal_namestringRequiredThe proposed legal name. Must satisfy SoS naming requirements
for the entity's jurisdiction (corporate suffix, no reserved
words, no collision with existing registered entities). Use
GET /entities/name_availability to validate before invoking.
effective_datestring<date>OptionalDate the new legal name takes effect. Defaults to the SoS-stamped acceptance date of the Certificate of Amendment. Set explicitly when the rebrand is timed to a marketing launch later than expected SoS turnaround.
authorizing_resolution_idstringRequiredThe board (or stockholder, or sole-director-and-stockholder
written consent) Resolution that authorises the §242
amendment. The resulting Filing carries this id as
authorizing_resolution_id; the Resolution gains a forward-
reference entry in authorizes_filings[] automatically.
cascade_optionsobjectOptionalToggle downstream propagation. Defaults are conservative
(propagate everything); set explicit false to suppress.
update_open_filingsbooleanOptionalPatch any Filing in preparing or submitted state
that carries the old legal_name in its payload.
cascade_boi_updatebooleanOptionalAuto-emit a Filing of type boi_update reflecting
the new legal_name (31 CFR §1010.380(a)(2)).
cascade_state_registrationsbooleanOptionalPropagate to StateRegistration (employer / sales-tax /
DBA / business-license) and Qualification records in
non-home states. Each emits its own per-state name-change
Filing on the sub-resource.
metadataobjectOptionalFlat string-to-string map. Up to 50 keys. Keys: max 40 chars, charset
[A-Za-z0-9_\\-.]. Values: max 500 chars. Keys prefixed matter_ are reserved
for platform use. Metadata is retrievable but not filterable via query params.
Response Body
application/json
Request
curl -X POST "https://api.mattermode.com/v1/entities/{id}/name_change" \ -H "Content-Type: application/json" \ -d '{ "new_legal_name": "InvoiceFlow, Inc.", "effective_date": "2026-08-01", "authorizing_resolution_id": "res_LqGcSdRb", "cascade_options": { "update_open_filings": true, "cascade_boi_update": true, "cascade_state_registrations": true } }'const body = JSON.stringify({ "new_legal_name": "InvoiceFlow, Inc.", "effective_date": "2026-08-01", "authorizing_resolution_id": "res_LqGcSdRb", "cascade_options": { "update_open_filings": true, "cascade_boi_update": true, "cascade_state_registrations": true }})fetch("https://api.mattermode.com/v1/entities/{id}/name_change", { method: "POST", headers: { "Content-Type": "application/json" }, body})package mainimport ( "fmt" "net/http" "io/ioutil" "strings")func main() { url := "https://api.mattermode.com/v1/entities/{id}/name_change" body := strings.NewReader(`{ "new_legal_name": "InvoiceFlow, Inc.", "effective_date": "2026-08-01", "authorizing_resolution_id": "res_LqGcSdRb", "cascade_options": { "update_open_filings": true, "cascade_boi_update": true, "cascade_state_registrations": true } }`) req, _ := http.NewRequest("POST", url, body) req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := ioutil.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body))}import requestsheaders = { "Authorization": "Bearer sk_test_4eC39HqLyjWDarjtT1zdp7dc", "Matter-Version": "2026-06-10", "Idempotency-Key": "ee7c3a9b-3f1a-4d8e-9b2a-7c5e1f0a2d4b",}payload = { "new_legal_name": "InvoiceFlow, Inc.", "effective_date": "2026-08-01", "authorizing_resolution_id": "res_LqGcSdRb", "cascade_options": { "update_open_filings": true, "cascade_boi_update": true, "cascade_state_registrations": true }}resp = requests.post( "https://api.mattermode.com/v1/entities/ent_Nq3KcAbc/name_change", headers=headers, json=payload,)resp.raise_for_status()print(resp.json())import java.net.URI;import java.net.http.HttpClient;import java.net.http.HttpRequest;import java.net.http.HttpResponse;import java.net.http.HttpResponse.BodyHandlers;import java.time.Duration;import java.net.http.HttpRequest.BodyPublishers;var body = BodyPublishers.ofString("""{ "new_legal_name": "InvoiceFlow, Inc.", "effective_date": "2026-08-01", "authorizing_resolution_id": "res_LqGcSdRb", "cascade_options": { "update_open_filings": true, "cascade_boi_update": true, "cascade_state_registrations": true }}""");HttpClient client = HttpClient.newBuilder() .connectTimeout(Duration.ofSeconds(10)) .build();HttpRequest.Builder requestBuilder = HttpRequest.newBuilder() .uri(URI.create("https://api.mattermode.com/v1/entities/{id}/name_change")) .header("Content-Type", "application/json") .POST(body) .build();try { HttpResponse<String> response = client.send(requestBuilder.build(), BodyHandlers.ofString()); System.out.println("Status code: " + response.statusCode()); System.out.println("Response body: " + response.body());} catch (Exception e) { e.printStackTrace();}using System;using System.Net.Http;using System.Text;var body = new StringContent("""{ "new_legal_name": "InvoiceFlow, Inc.", "effective_date": "2026-08-01", "authorizing_resolution_id": "res_LqGcSdRb", "cascade_options": { "update_open_filings": true, "cascade_boi_update": true, "cascade_state_registrations": true }}""", Encoding.UTF8, "application/json");var client = new HttpClient();var response = await client.PostAsync("https://api.mattermode.com/v1/entities/{id}/name_change", body);var responseBody = await response.Content.ReadAsStringAsync();curl --request POST 'https://api.mattermode.com/v1/entities/ent_Nq3KcAbc/name_change' \ --header 'Authorization: Bearer sk_test_4eC39HqLyjWDarjtT1zdp7dc' \ --header 'Matter-Version: 2026-06-10' \ --header 'Idempotency-Key: ee7c3a9b-3f1a-4d8e-9b2a-7c5e1f0a2d4b' \ --header 'Content-Type: application/json' \ --data '{ "new_legal_name": "InvoiceFlow, Inc.", "effective_date": "2026-08-01", "authorizing_resolution_id": "res_LqGcSdRb", "cascade_options": { "update_open_filings": true, "cascade_boi_update": true, "cascade_state_registrations": true }}'const response = await fetch("https://api.mattermode.com/v1/entities/ent_Nq3KcAbc/name_change", { method: "POST", headers: { "Authorization": "Bearer sk_test_4eC39HqLyjWDarjtT1zdp7dc", "Matter-Version": "2026-06-10", "Idempotency-Key": "ee7c3a9b-3f1a-4d8e-9b2a-7c5e1f0a2d4b", "Content-Type": "application/json", }, body: JSON.stringify({ "new_legal_name": "InvoiceFlow, Inc.", "effective_date": "2026-08-01", "authorizing_resolution_id": "res_LqGcSdRb", "cascade_options": { "update_open_filings": true, "cascade_boi_update": true, "cascade_state_registrations": true } }),});if (!response.ok) { throw new Error(`Matter API ${response.status}: ${await response.text()}`);}const data = await response.json();console.log(data);Response
202Name change initiated. Response carries the queued Certificate of Amendment Filing (carrying authorizing_resolution_id), any cascaded BOI update Filing, and the updated Entity record (with legal_name patched only after the Filing reaches accepted).
application/json{
"id": "string",
"object": "corporate_transaction",
"kind": "merger",
"parties": [
{
"entity_id": "string",
"role": "acquirer",
"signatures_required": [
"string"
]
}
],
"stage": "loi",
"consideration": {
"total": {
"amount": 50000,
"currency": "usd"
},
"cash": {
"amount": 50000,
"currency": "usd"
},
"stock_exchange_ratio": 0,
"contingent_value_rights": {
"amount": 50000,
"currency": "usd"
}
},
"consideration_breakdown": {
"cash_amount_cents": 0,
"stock_consideration": [
{
"share_class_id": "string",
"shares": 1,
"valuation_per_share_cents": 0
}
],
"earn_out_amount_cents": 0,
"escrow_amount_cents": 0,
"indemnity_holdback_amount_cents": 0,
"assumed_debt_cents": 0,
"transaction_expense_reimbursement_cents": 0,
"cvr_amount_cents": 0
},
"authorizing_resolution_id": "string",
"effective_date": "2019-08-24",
"signing_date": "2019-08-24",
"closing_date": "2019-08-24",
"treatment": {
"options": {
"vested": "cash_out",
"unvested": "cash_out",
"accelerate_basis_points": 0
},
"warrants": "exercise_pre_closing",
"safes": "convert_at_cap",
"notes": "convert_at_cap"
},
"hsr_required": true,
"regulatory_approvals": [
{
"kind": "hsr",
"jurisdiction": "string",
"status": "pending",
"filing_id": "string"
}
],
"section_280g_analysis": {
"ran": true,
"disqualified_count": 0,
"excess_parachute": {
"amount": 50000,
"currency": "usd"
},
"gross_up": true,
"shareholder_cleanse_planned": true,
"analysis_document_id": "string"
},
"document_ids": [
"string"
],
"escrow_ids": [
"string"
],
"earn_out_ids": [
"string"
],
"indemnity_claim_ids": [
"string"
],
"metadata": {
"customer_id": "cus_7Hpx9WxY",
"portfolio_tag": "y-combinator-w26"
},
"created": 0,
"updated": 0,
"livemode": true
}