getstarted.ae

Submit an incorporation

POSThttps://api.getstarted.ae/v1/incorporations/{incorporationId}/submit

Locks the draft and starts processing. Only accepted when validation reports isComplete: true.

  • Submission is idempotent. Submitting an already-submitted incorporation returns it unchanged with 200.

Path parameters

  • incorporationIdstringrequired

    ID of the incorporation, e.g. inc_01J9ZK7C3VYB5N.

Responses

  • 200OK. Returns the object shown in the example.
  • 404resource_not_found No incorporation with that ID exists in this environment.
  • 422validation_incomplete Validation is not complete. The error body carries the same missingRequirements and invalidRequirements lists.
  • 409incorporation_cancelled The incorporation was cancelled.
  • Every endpoint can also return 401 for a missing or invalid key. See Errors.
curl -X POST "https://api.getstarted.ae/v1/incorporations/inc_01J9ZK7C3VYB5N/submit" \
  -H "Authorization: Bearer $GETSTARTED_API_KEY"
Response · 200
{
  "id": "inc_01J9ZK7C3VYB5N",
  "object": "incorporation",
  "customerId": "cus_01J9ZK4R7Q2M8X",
  "jurisdiction": "SG",
  "type": "PRIVATE_LIMITED_COMPANY",
  "status": "SUBMITTED",
  "stage": "submitted",
  "requirementsVersion": "2026-09-01",
  "requirements": {
    "companyNameOptions": [
      "Northwind Asia Pte. Ltd.",
      "Northwind Labs Asia Pte. Ltd.",
      "Northwind Pacific Pte. Ltd."
    ],
    "businessActivity": "62011",
    "financialYearEnd": "12-31",
    "registeredOfficeAddressSource": "getstartedService"
  },
  "businessEntityId": null,
  "submittedAt": "2026-09-20T09:04:15Z",
  "completedAt": null,
  "metadata": {
    "internalRef": "NW-SG-01"
  },
  "livemode": false,
  "createdAt": "2026-09-20T08:31:57Z",
  "updatedAt": "2026-09-20T09:04:15Z"
}