Claim entity

POST

https://api.sureshake.com/v2/entities/{id}/claim

Path parameters

id
string
required
format: uuid

Request body JSON required

evidence
required
Any of the following:
object
method
authenticated_email_domain
required
object
method
entity_evidence
required
evidenceUrls
array of
string
required
format: uri
notes
string
required
maxLength: 5000 · minLength: 20
object
method
operator_review
required
notes
string
required
maxLength: 5000 · minLength: 20
}

Returns

200

Default Response

JSON

data
object
required
- success
  boolean
  required
- entityId
  string
  required
  format: uuid
- status
  pending
  or
  approved
  required
- claimRequestId
  string
  required
  format: uuid
- verificationMethod
  authenticated_email_domain
  or
  entity_evidence
  or
  operator_review
  required
}

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
}

409

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
}

422

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
}

429

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
}

curl --request POST \ --url 'https://api.sureshake.com/v2/entities/<id>/claim' \ --header 'Content-Type: application/json' \ --data ' { "evidence": { "method": "authenticated_email_domain" } } '

{ "data": { "success": true, "entityId": "156e622c-6cdf-4c27-9bc9-2f2db69919f5", "status": "pending", "claimRequestId": "ae6cd89f-9216-4c24-8f5b-59e86a5ccecd", "verificationMethod": "authenticated_email_domain" } }