DELETE
/
formations
/
{id}
Cancel Formation
curl --request DELETE \
  --url https://api.clemta.com/formations/{id} \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "message": "<string>",
  "data": {
    "formation_id": "<string>",
    "company_id": "<string>",
    "status": "shareholder_verification",
    "external_id": "<string>"
  },
  "error": {
    "code": "API_KEY_REQUIRED",
    "details": "<string>"
  }
}

​
Cancel Company Formation

This endpoint allows you to cancel a company formation that is in progress. The formation can be canceled using either the company ID or the external ID provided during creation.

​
Headers

ParameterTypeDescription
X-API-KEYstringFormation API Key (required)

​
Path Parameters

ParameterTypeDescriptionRequired
idstringCompany ID (ObjectID) or External ID (max 64 chars)Yes

​
Parameter Examples

  • Company ID: 64b8f1a2e4b0c8d9f0123456
  • External ID: your-unique-id-123

​
Response

​
Success Response (200)

{
  "success": true,
  "message": "Formation cancelled successfully",
  "data": {
    "formation_id": "64b8f1a2e4b0c8d9f0123456",
    "company_id": "64b8f1a2e4b0c8d9f0123456",
    "status": "cancelled",
    "external_id": "your-unique-id-123"
  },
  "error": null
}

​
Response Parameters

ParameterTypeDescription
successbooleanIndicates if the operation was successful
messagestringAdditional information about the operation
dataobjectResponse data for successful requests
data.formation_idstringUnique formation process ID
data.company_idstringUnique identifier for the company
data.statusstringUpdated status of the company formation
data.external_idstringYour provided external ID (if any)

​
Error Responses

​
Invalid Request - Bad ID Parameter (400)

{
  "success": false,
  "message": "Invalid request data",
  "data": null,
  "error": {
    "code": "INVALID_REQUEST",
    "details": "Invalid ID parameter format"
  }
}

​
Unauthorized - Invalid API Key (401)

{
  "success": false,
  "message": "API key is required",
  "data": null,
  "error": {
    "code": "API_KEY_REQUIRED"
  }
}

​
Formation Not Found (404)

{
  "success": false,
  "message": "Company not found",
  "data": null,
  "error": {
    "code": "COMPANY_NOT_FOUND"
  }
}

​
Internal Server Error (500)

{
  "success": false,
  "message": "Internal server error",
  "data": null,
  "error": {
    "code": "INTERNAL_ERROR"
  }
}

​
Notes

  • Only formations that are not yet completed can be canceled
  • Once a formation is canceled, it cannot be resumed
  • Any fees paid may be subject to the refund policy
  • The formation status will be updated to cancelled

Authorizations

​
X-API-Key
string
header
required

Formation API key for authentication.

Path Parameters

​
id
string
required

Company ID (ObjectID) or External ID

Maximum length: 64
Example:

"64b8f1a2e4b0c8d9f0123456"

Response

200
application/json

Formation cancelled successfully

The response is of type object.