Skip to main content
POST
Preview what creating a company would bill

Authorizations

Authorization
string
header
required

Your API key, e.g. Authorization: Bearer clmt_test_. Live keys use the clmt_live_ prefix.

Body

application/json

The price-relevant slice of a company create - enough to resolve the whole basket.

entity_type
enum<string>
required
Available options:
llc,
c_corp
state
string
required

The formation state, as a 2-letter code.

Pattern: ^[A-Za-z]{2}$
Example:

"DE"

pre_existing
boolean

Preview for a pre-existing company you bring in (no formation line). Defaults to false.

has_ein
boolean

Whether the pre-existing company you bring in already holds an EIN. Only a pre_existing company can (a formation is assigned one later), so it is ignored otherwise. It changes which services are available - an EIN service is for companies without one. Defaults to false.

owners_count
integer

How many owners the company has. Defaults to 1.

Required range: 1 <= x <= 100
services
string[]

Service product keys to attach. Mandatory services are added automatically whether or not they are listed.

formation_options
object

Option choices for the formation itself, e.g. {"turnaround":"expedited"}. This is a shorthand for service_options under the formation key. Prefer putting the formation's options in service_options, which is the field the create request reads, so the same input drives both this quote and the charge. When both are given, service_options.formation takes precedence.

service_options
object

Per-service option choices, keyed by product key, e.g. {"ein":{"turnaround":"expedited"}}. The formation's own options belong here too, under the formation key, in the same shape the create request reads, so the quote and the charge use the same option amounts.

Response

The resolved basket.

Every line a company create would bill for a stated profile, before anything exists: the formation with its state filing fee, every mandatory service the profile auto-attaches, and every service listed. Each line carries its own interval - they are not summed, since a one-time formation and a yearly service are not one number. Amounts are estimates: the create resolves again and freezes what it billed.

object
enum<string>
required

Entity name.

Available options:
company_price_preview
currency
string
required
Example:

"usd"

lines
object[]
required