List issues

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

Lists issues raised during processing. Issues are read-only.

An open issue sets the incorporation to ACTION_REQUIRED. Fix the data or document at the issue's path and it resolves on its own; there is no endpoint to close an issue.

Path parameters

incorporationIdstringrequired
ID of the incorporation, e.g. inc_01J9ZK7C3VYB5N.

Query parameters

statusenum
OPEN or RESOLVED.

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/issues" \
  -H "Authorization: Bearer $GETSTARTED_API_KEY"

Response · 200

{
  "object": "list",
  "data": [
    {
      "id": "iss_01J9ZKH6FW6M1R",
      "object": "issue",
      "incorporationId": "inc_01J9ZK7C3VYB5N",
      "status": "OPEN",
      "category": "DOCUMENT",
      "path": "participants.par_01J9ZKE7LB2H6J.documents.PASSPORT_SCAN",
      "message": "The passport scan is cropped. Upload a scan that shows all four corners of the photo page.",
      "createdAt": "2026-09-22T10:02:11Z",
      "resolvedAt": null
    }
  ],
  "hasMore": false,
  "nextCursor": null
}

Get status