Get status

GET

https://api.sureshake.com/v2/entities/{entityId}/verification/status

Path parameters

entityId
string
required
format: uuid

Returns

200

Default Response

JSON

entityVerified
boolean
required
verificationStatus
pending
or
in_review
or
approved
or
rejected
required
pendingActions
array of
string
required
verificationHistory
object
required
- requested
  number
  required
- approved
  number
  required
- rejected
  number
  required
- documentsSubmitted
  number
  required
- documentsApproved
  number
  required
- identifiersVerified
  number
  required
}
lastVerificationDate
optional
string

400

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

401

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

403

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

404

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

500

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

503

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

{ "entityVerified": true, "verificationStatus": "pending", "pendingActions": [ "string" ], "lastVerificationDate": "string", "verificationHistory": { "requested": 0, "approved": 0, "rejected": 0, "documentsSubmitted": 0, "documentsApproved": 0, "identifiersVerified": 0 } }