Form a new company (write scope)

curl --request POST \
  --url https://api.trycherry.ai/v1/incorporations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "legalName": "<string>",
  "filingState": "<string>",
  "addressStreet": "<string>",
  "addressCity": "<string>",
  "addressState": "<string>",
  "addressZip": "<string>",
  "mailingAddressStreet": "<string>",
  "mailingAddressCity": "<string>",
  "mailingAddressState": "<string>",
  "mailingAddressZip": "<string>",
  "officers": [
    {}
  ],
  "fiscalEndMonth": "<string>",
  "addressCountry": "<string>",
  "mailingAddressCountry": "<string>",
  "registeredAgent": {},
  "useRegisteredAgentService": true,
  "ein": {},
  "einNoSsn": true
}
'

import requests

url = "https://api.trycherry.ai/v1/incorporations"

payload = {
    "legalName": "<string>",
    "filingState": "<string>",
    "addressStreet": "<string>",
    "addressCity": "<string>",
    "addressState": "<string>",
    "addressZip": "<string>",
    "mailingAddressStreet": "<string>",
    "mailingAddressCity": "<string>",
    "mailingAddressState": "<string>",
    "mailingAddressZip": "<string>",
    "officers": [{}],
    "fiscalEndMonth": "<string>",
    "addressCountry": "<string>",
    "mailingAddressCountry": "<string>",
    "registeredAgent": {},
    "useRegisteredAgentService": True,
    "ein": {},
    "einNoSsn": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    legalName: '<string>',
    filingState: '<string>',
    addressStreet: '<string>',
    addressCity: '<string>',
    addressState: '<string>',
    addressZip: '<string>',
    mailingAddressStreet: '<string>',
    mailingAddressCity: '<string>',
    mailingAddressState: '<string>',
    mailingAddressZip: '<string>',
    officers: [{}],
    fiscalEndMonth: '<string>',
    addressCountry: '<string>',
    mailingAddressCountry: '<string>',
    registeredAgent: {},
    useRegisteredAgentService: true,
    ein: {},
    einNoSsn: true
  })
};

fetch('https://api.trycherry.ai/v1/incorporations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.trycherry.ai/v1/incorporations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'legalName' => '<string>',
    'filingState' => '<string>',
    'addressStreet' => '<string>',
    'addressCity' => '<string>',
    'addressState' => '<string>',
    'addressZip' => '<string>',
    'mailingAddressStreet' => '<string>',
    'mailingAddressCity' => '<string>',
    'mailingAddressState' => '<string>',
    'mailingAddressZip' => '<string>',
    'officers' => [
        [
                
        ]
    ],
    'fiscalEndMonth' => '<string>',
    'addressCountry' => '<string>',
    'mailingAddressCountry' => '<string>',
    'registeredAgent' => [
        
    ],
    'useRegisteredAgentService' => true,
    'ein' => [
        
    ],
    'einNoSsn' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.trycherry.ai/v1/incorporations"

	payload := strings.NewReader("{\n  \"legalName\": \"<string>\",\n  \"filingState\": \"<string>\",\n  \"addressStreet\": \"<string>\",\n  \"addressCity\": \"<string>\",\n  \"addressState\": \"<string>\",\n  \"addressZip\": \"<string>\",\n  \"mailingAddressStreet\": \"<string>\",\n  \"mailingAddressCity\": \"<string>\",\n  \"mailingAddressState\": \"<string>\",\n  \"mailingAddressZip\": \"<string>\",\n  \"officers\": [\n    {}\n  ],\n  \"fiscalEndMonth\": \"<string>\",\n  \"addressCountry\": \"<string>\",\n  \"mailingAddressCountry\": \"<string>\",\n  \"registeredAgent\": {},\n  \"useRegisteredAgentService\": true,\n  \"ein\": {},\n  \"einNoSsn\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.trycherry.ai/v1/incorporations")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"legalName\": \"<string>\",\n  \"filingState\": \"<string>\",\n  \"addressStreet\": \"<string>\",\n  \"addressCity\": \"<string>\",\n  \"addressState\": \"<string>\",\n  \"addressZip\": \"<string>\",\n  \"mailingAddressStreet\": \"<string>\",\n  \"mailingAddressCity\": \"<string>\",\n  \"mailingAddressState\": \"<string>\",\n  \"mailingAddressZip\": \"<string>\",\n  \"officers\": [\n    {}\n  ],\n  \"fiscalEndMonth\": \"<string>\",\n  \"addressCountry\": \"<string>\",\n  \"mailingAddressCountry\": \"<string>\",\n  \"registeredAgent\": {},\n  \"useRegisteredAgentService\": true,\n  \"ein\": {},\n  \"einNoSsn\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.trycherry.ai/v1/incorporations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"legalName\": \"<string>\",\n  \"filingState\": \"<string>\",\n  \"addressStreet\": \"<string>\",\n  \"addressCity\": \"<string>\",\n  \"addressState\": \"<string>\",\n  \"addressZip\": \"<string>\",\n  \"mailingAddressStreet\": \"<string>\",\n  \"mailingAddressCity\": \"<string>\",\n  \"mailingAddressState\": \"<string>\",\n  \"mailingAddressZip\": \"<string>\",\n  \"officers\": [\n    {}\n  ],\n  \"fiscalEndMonth\": \"<string>\",\n  \"addressCountry\": \"<string>\",\n  \"mailingAddressCountry\": \"<string>\",\n  \"registeredAgent\": {},\n  \"useRegisteredAgentService\": true,\n  \"ein\": {},\n  \"einNoSsn\": true\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "companyId": "comp_x1y2z3a4b5c6d7e8",
    "items": [
      {
        "orderId": "ord_a1b2c3d4e5f6a7b8",
        "orderType": "formation",
        "filingStatus": "submitted"
      },
      {
        "orderId": "ord_b2c3d4e5f6a7b8c9",
        "orderType": "registered_agent",
        "filingStatus": "submitted"
      }
    ]
  }
}

{
  "error": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "reason": "<string>"
}

Incorporations

Form a new company (write scope)

Start a company formation in any US state — LLC or corporation — optionally bundling an EIN order. This files real state paperwork and incurs filing costs.

International founders: the company’s principal/mailing addresses and every officer address accept ANY country — set the *Country fields to a two-letter ISO code (default US). For non-US addresses the state field is free text (e.g. CDMX) and the zip field takes any postal code. Only filingState must be a US state.

LLCs must set structureType (MEMBER or MANAGER). A registered agent in the filing state is required: supply your own via registeredAgent, or leave useRegisteredAgentService at its default (true) and Cherry provides one.

EIN: include ein to apply for the company’s EIN in the same bundle. When the responsible party has no SSN or ITIN, omit responsiblePartySsn and set einNoSsn: true — Cherry then prepares and files the EIN application with the IRS on the company’s behalf, and the response carries an einApplication describing its status. The flag is required rather than inferred: dropping an SSN by accident and silently taking the slower route would be the wrong default, so the two are rejected as a pair (send the SSN, or send einNoSsn, never both).

Idempotency: send an Idempotency-Key header; a retried POST with the same key replays the original result instead of forming a second company.

POST

incorporations

Form a new company (write scope)

curl --request POST \
  --url https://api.trycherry.ai/v1/incorporations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "legalName": "<string>",
  "filingState": "<string>",
  "addressStreet": "<string>",
  "addressCity": "<string>",
  "addressState": "<string>",
  "addressZip": "<string>",
  "mailingAddressStreet": "<string>",
  "mailingAddressCity": "<string>",
  "mailingAddressState": "<string>",
  "mailingAddressZip": "<string>",
  "officers": [
    {}
  ],
  "fiscalEndMonth": "<string>",
  "addressCountry": "<string>",
  "mailingAddressCountry": "<string>",
  "registeredAgent": {},
  "useRegisteredAgentService": true,
  "ein": {},
  "einNoSsn": true
}
'

import requests

url = "https://api.trycherry.ai/v1/incorporations"

payload = {
    "legalName": "<string>",
    "filingState": "<string>",
    "addressStreet": "<string>",
    "addressCity": "<string>",
    "addressState": "<string>",
    "addressZip": "<string>",
    "mailingAddressStreet": "<string>",
    "mailingAddressCity": "<string>",
    "mailingAddressState": "<string>",
    "mailingAddressZip": "<string>",
    "officers": [{}],
    "fiscalEndMonth": "<string>",
    "addressCountry": "<string>",
    "mailingAddressCountry": "<string>",
    "registeredAgent": {},
    "useRegisteredAgentService": True,
    "ein": {},
    "einNoSsn": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    legalName: '<string>',
    filingState: '<string>',
    addressStreet: '<string>',
    addressCity: '<string>',
    addressState: '<string>',
    addressZip: '<string>',
    mailingAddressStreet: '<string>',
    mailingAddressCity: '<string>',
    mailingAddressState: '<string>',
    mailingAddressZip: '<string>',
    officers: [{}],
    fiscalEndMonth: '<string>',
    addressCountry: '<string>',
    mailingAddressCountry: '<string>',
    registeredAgent: {},
    useRegisteredAgentService: true,
    ein: {},
    einNoSsn: true
  })
};

fetch('https://api.trycherry.ai/v1/incorporations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.trycherry.ai/v1/incorporations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'legalName' => '<string>',
    'filingState' => '<string>',
    'addressStreet' => '<string>',
    'addressCity' => '<string>',
    'addressState' => '<string>',
    'addressZip' => '<string>',
    'mailingAddressStreet' => '<string>',
    'mailingAddressCity' => '<string>',
    'mailingAddressState' => '<string>',
    'mailingAddressZip' => '<string>',
    'officers' => [
        [
                
        ]
    ],
    'fiscalEndMonth' => '<string>',
    'addressCountry' => '<string>',
    'mailingAddressCountry' => '<string>',
    'registeredAgent' => [
        
    ],
    'useRegisteredAgentService' => true,
    'ein' => [
        
    ],
    'einNoSsn' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.trycherry.ai/v1/incorporations"

	payload := strings.NewReader("{\n  \"legalName\": \"<string>\",\n  \"filingState\": \"<string>\",\n  \"addressStreet\": \"<string>\",\n  \"addressCity\": \"<string>\",\n  \"addressState\": \"<string>\",\n  \"addressZip\": \"<string>\",\n  \"mailingAddressStreet\": \"<string>\",\n  \"mailingAddressCity\": \"<string>\",\n  \"mailingAddressState\": \"<string>\",\n  \"mailingAddressZip\": \"<string>\",\n  \"officers\": [\n    {}\n  ],\n  \"fiscalEndMonth\": \"<string>\",\n  \"addressCountry\": \"<string>\",\n  \"mailingAddressCountry\": \"<string>\",\n  \"registeredAgent\": {},\n  \"useRegisteredAgentService\": true,\n  \"ein\": {},\n  \"einNoSsn\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.trycherry.ai/v1/incorporations")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"legalName\": \"<string>\",\n  \"filingState\": \"<string>\",\n  \"addressStreet\": \"<string>\",\n  \"addressCity\": \"<string>\",\n  \"addressState\": \"<string>\",\n  \"addressZip\": \"<string>\",\n  \"mailingAddressStreet\": \"<string>\",\n  \"mailingAddressCity\": \"<string>\",\n  \"mailingAddressState\": \"<string>\",\n  \"mailingAddressZip\": \"<string>\",\n  \"officers\": [\n    {}\n  ],\n  \"fiscalEndMonth\": \"<string>\",\n  \"addressCountry\": \"<string>\",\n  \"mailingAddressCountry\": \"<string>\",\n  \"registeredAgent\": {},\n  \"useRegisteredAgentService\": true,\n  \"ein\": {},\n  \"einNoSsn\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.trycherry.ai/v1/incorporations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"legalName\": \"<string>\",\n  \"filingState\": \"<string>\",\n  \"addressStreet\": \"<string>\",\n  \"addressCity\": \"<string>\",\n  \"addressState\": \"<string>\",\n  \"addressZip\": \"<string>\",\n  \"mailingAddressStreet\": \"<string>\",\n  \"mailingAddressCity\": \"<string>\",\n  \"mailingAddressState\": \"<string>\",\n  \"mailingAddressZip\": \"<string>\",\n  \"officers\": [\n    {}\n  ],\n  \"fiscalEndMonth\": \"<string>\",\n  \"addressCountry\": \"<string>\",\n  \"mailingAddressCountry\": \"<string>\",\n  \"registeredAgent\": {},\n  \"useRegisteredAgentService\": true,\n  \"ein\": {},\n  \"einNoSsn\": true\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "companyId": "comp_x1y2z3a4b5c6d7e8",
    "items": [
      {
        "orderId": "ord_a1b2c3d4e5f6a7b8",
        "orderType": "formation",
        "filingStatus": "submitted"
      },
      {
        "orderId": "ord_b2c3d4e5f6a7b8c9",
        "orderType": "registered_agent",
        "filingStatus": "submitted"
      }
    ]
  }
}

{
  "error": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "reason": "<string>"
}

Authorizations

Authorization

string

header

required

Cherry API key, created in the app. Sent as Authorization: Bearer ck_live_….

Body

application/json

legalName

string

required

Exact legal name including the suffix (LLC, Inc.).

entityType

enum<string>

required

Available options:

LLC,

CORP

filingState

string

required

Two-letter US state to form in.

addressStreet

string

required

addressCity

string

required

addressState

string

required

Two-letter state code for US addresses; free text elsewhere.

addressZip

string

required

ZIP for US addresses; any postal code elsewhere.

mailingAddressStreet

string

required

mailingAddressCity

string

required

mailingAddressState

string

required

mailingAddressZip

string

required

officers

object[]

required

At least one officer (PERSON or COMPANY), each with their own address — any country.

Minimum array length: 1

structureType

enum<string>

Required for LLCs.

Available options:

MEMBER,

MANAGER

taxElection

enum<string>

Corporations only.

Available options:

C Corporation,

S Corporation

fiscalEndMonth

string

e.g. December.

addressCountry

string

Two-letter ISO country code, uppercase. Default US.

mailingAddressCountry

string

registeredAgent

object

Bring your own registered agent (must be in the filing state). Omit to use Cherry's registered-agent service.

useRegisteredAgentService

boolean

Default true when no registeredAgent is supplied: Cherry provides the agent as a separate order line.

ein

object

Apply for the company's EIN in the same bundle. Omit responsiblePartySsn when the responsible party has no SSN/ITIN, and set einNoSsn alongside it.

einNoSsn

boolean

The responsible party has no US SSN or ITIN, so Cherry prepares and files the EIN application itself and the EIN arrives later. Required when ein omits responsiblePartySsn, and rejected when sent alongside one.

Response

The incorporation order bundle

data

object

Show child attributes

Meta

Transactions

Accounts

Bank accounts

Bank statements

Journal

Reports

Entities

Obligations

Health

Incorporations

Form a new company (write scope)

Authorizations

Body

Response