Skip to main content
GET
Get Formation Status

Get Company Formation Status

This endpoint allows partners to retrieve the current status of a company formation process. It supports conditional requests using the If-Modified-Since header for efficient polling.

Headers

Path Parameters

Response

Response Parameters

Response Headers

Status Codes

Error Responses

Invalid Company ID (400)

Unauthorized - Invalid API Key (401)

Access Denied (403)

Company Not Found (404)

Internal Server Error (500)

Authorizations

X-API-Key
string
header
required

Formation API key for authentication.

Headers

If-Modified-Since
string<http-date>

HTTP conditional request header for caching

Example:

"Wed, 21 Oct 2015 07:28:00 GMT"

Path Parameters

id
string
required

Company ID (ObjectID) or External ID

Maximum string length: 64
Example:

"64b8f1a2e4b0c8d9f0123456"

Response

Formation details retrieved successfully

success
boolean
required

Indicates if the request was successful

company_id
string
required

Company ID

company_name
string
required

Company name

status
enum<string>
required

Formation status

Available options:
shareholder_verification,
in_progress,
active,
refunded,
name_change,
signature_requested,
submitted_to_state,
cancelled
formation_date
string | null

Company formation date

ein
string | null

Employer Identification Number

external_id
string | null

Partner's external ID

custom_data
object | null

Partner's custom data for this company

type
enum<string> | null

Company type

Available options:
LLC,
C-CORP
state
enum<string> | null

State abbreviation

Available options:
AL,
AK,
AZ,
AR,
CA,
CO,
CT,
DE,
FL,
GA,
HI,
ID,
IL,
IN,
IA,
KS,
KY,
LA,
ME,
MD,
MA,
MI,
MN,
MS,
MO,
MT,
NE,
NV,
NH,
NJ,
NM,
NY,
NC,
ND,
OH,
OK,
OR,
PA,
RI,
SC,
SD,
TN,
TX,
UT,
VT,
VA,
WA,
WV,
WI,
WY
country
string | null

Country code

ending
enum<string> | null

Company ending

Available options:
LLC,
Inc.,
Corporation,
Corp.
industry
string | null

Industry type

number_of_shares
number | null

Number of shares

par_value
number | null

Par value per share

is_company_private
boolean

Whether the company is private

address
object | null

Company address

timezone
string | null

Company timezone

shareholders
object[] | null

List of shareholders

directors
object[] | null

List of directors (C-CORP only)

officers
object[] | null

List of officers (C-CORP only)

created_at
integer | null

Creation timestamp

updated_at
integer | null

Last update timestamp

federal_tax_filing
integer | null

Federal tax filing timestamp

state_tax_filing
integer | null

State tax filing timestamp

foreign_qualification_addresses
object[] | null

Foreign qualification addresses