Formation API
Formation
API for managing company formations and retrieving formation status
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 |