Formation API

The Formation API allows partners to programmatically initiate company formations and check their status. This API is designed for partners who want to integrate Clemta’s company formation services into their own platforms.

Authentication

See Authentication for how to authenticate requests.

Rate Limiting

The Formation API is subject to rate limiting to ensure fair usage and system stability. Please refer to our Rate Limiting documentation for more details.

Available Endpoints

Method	Endpoint	Description
POST	/formations	Start the company formation process
GET	/formations/:company_id	Retrieve the current status of a company formation
DELETE	/formations/:company_id	Cancel a company formation

Company Formation Status

The company formation process goes through several stages, represented by the following status values:

Status	Description
shareholder_verification	Waiting for shareholder verification
in_progress	The company formation is in progress
active	The company formation has been completed successfully and the company is active
refunded	The company formation was refunded
name_change	The company name is being changed
signature_requested	Signatures have been requested for company documents
submitted_to_state	The company formation documents have been submitted to the state
cancelled	The company formation was cancelled

Error Codes

Code	Description
API_KEY_REQUIRED	The API key is required
INVALID_API_KEY	The API key is invalid
ACCESS_DENIED	The API key does not have permission to access the requested resource
RATE_LIMIT_EXCEEDED	Rate limit exceeded
INVALID_REQUEST	The request is invalid or missing required fields
VALIDATION_FAILED	The request failed validation
COMPANY_NOT_FOUND	The requested company could not be found
PACKAGE_NOT_FOUND	The requested package could not be found
DUPLICATE_EXTERNAL_ID	The provided external ID already exists
INTERNAL_ERROR	An internal server error occurred