POST /entity/claim/cancel

NOTE: This method is not accessible to users on Starter Plan API keys. Please contact us if you want premium access to our service

HTTP Method: POST

Path:  /v1/entity/claim/cancel

Authentication: API Key required, User ID required

Description: Expire a claim

Parameters:

 

Parameter Type Mandatory Description Example
api_key string yes the user API key b66qw3edr56thhg
_user_id string yes The user user_id ax34er6tt65edr
entity_id string yes The entity ID being claimed 379275323781120

 

Sample Success Response:

{
    "success": true,
    "msg": "ok",
    "data": {
        "ok": true,
        "id": "379275323781120",
        "rev": "29-f8659797282cbbfffa92c20731486e38"
    }
}  

 

Error Responses 

{
  "success": false,
  "msg": "Unable to return some requested documents",
  "data": {
    "missing": true,
    "errors": [
      "entity_id 12342134 is missing"
    ]
  }
}

 

{
  "success": false,
  "msg": "There was an error with your request",
  "data": {
    "errors": [
      "This entity is not currently claimed"
    ]
  }
}

Docs Navigation