Retrieve Formation
Retrieve the current status of a company formation process.
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
Formation API key for authentication.
Headers
HTTP conditional request header for caching
"Wed, 21 Oct 2015 07:28:00 GMT"
Path Parameters
Company ID (ObjectID) or External ID
64"64b8f1a2e4b0c8d9f0123456"
Response
Formation details retrieved successfully
Indicates if the request was successful
Company ID
Company name
Formation status
shareholder_verification, in_progress, active, refunded, name_change, signature_requested, submitted_to_state, cancelled Company formation date
Employer Identification Number
Partner's external ID
Partner's custom data for this company
Company type
LLC, C-CORP State abbreviation
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 code
Company ending
LLC, Inc., Corporation, Corp. Industry type
Number of shares
Par value per share
Whether the company is private
Company address
Company timezone
List of shareholders
List of directors (C-CORP only)
List of officers (C-CORP only)
Creation timestamp
Last update timestamp
Federal tax filing timestamp
State tax filing timestamp
Foreign qualification addresses