getstarted.ae

Check validation

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

Checks the draft against its requirements schema and lists everything still missing or invalid.

  • isComplete is the source of truth for whether you can submit. Do not reimplement the check client-side.
  • Each item's path points at the exact place to fix: requirements.<key>, participants.<participantId>.<field> or participants.<participantId>.documents.<documentKind>.

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/validation" \
  -H "Authorization: Bearer $GETSTARTED_API_KEY"
Response · 200
{
  "object": "validation",
  "incorporationId": "inc_01J9ZK7C3VYB5N",
  "isComplete": false,
  "missingRequirements": [
    {
      "path": "participants.par_01J9ZKE7LB2H6J.documents.PROOF_OF_ADDRESS",
      "message": "A PROOF_OF_ADDRESS document is required for each DIRECTOR."
    }
  ],
  "invalidRequirements": [
    {
      "path": "requirements.companyNameOptions",
      "code": "unique_items",
      "message": "Each company name option must be different."
    }
  ],
  "checkedAt": "2026-09-20T08:55:02Z"
}