getstarted.ae

Get status

GEThttps://api.getstarted.ae/v1/incorporations/{incorporationId}/status

Returns the current status and stage, with the history of every transition.

  • Prefer webhooks to polling. If you poll, once a minute is plenty.

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.
  • Every endpoint can also return 401 for a missing or invalid key. See Errors.
curl -X GET "https://api.getstarted.ae/v1/incorporations/inc_01J9ZK7C3VYB5N/status" \
  -H "Authorization: Bearer $GETSTARTED_API_KEY"
Response · 200
{
  "object": "incorporation_status",
  "incorporationId": "inc_01J9ZK7C3VYB5N",
  "status": "IN_PROGRESS",
  "stage": "name_reservation",
  "stageIndex": 3,
  "stageCount": 6,
  "openIssueCount": 0,
  "history": [
    {
      "status": "DRAFT",
      "stage": "draft",
      "at": "2026-09-20T08:31:57Z"
    },
    {
      "status": "SUBMITTED",
      "stage": "submitted",
      "at": "2026-09-20T09:04:15Z"
    },
    {
      "status": "IN_PROGRESS",
      "stage": "compliance_review",
      "at": "2026-09-20T11:20:00Z"
    },
    {
      "status": "IN_PROGRESS",
      "stage": "name_reservation",
      "at": "2026-09-23T06:42:37Z"
    }
  ],
  "updatedAt": "2026-09-23T06:42:37Z"
}