Revoke a report

Withdraw one of your reports, for example because you overturned the ban on appeal. The entry stops matching at once and is deleted after 30 days. Revoke as soon as a ban is overturned, because other members may be refusing the person because of it.

POSThttps://api.omnifence.ai/api/v1/registry/entries/{id}/revoke

Withdraw one of your reports, for example when you overturn the ban on appeal. Revoking an entry that is already revoked returns it unchanged. See Revoke a report.

Request#

Headers#

Name	Type	Required	Description
`Authorization`	string	Yes	Your API key as a Bearer token: `Bearer YOUR_API_KEY`.

Path parameters#

Name	Type	Required	Description
`id`	string (uuid)	Yes

Body (application/json)#

Field	Type	Required	Description
`reason`	string	Yes	Length min `1`, max `500`.

Example bodyJSON

{
  "reason": "string"
}

Responses#

200 OK#

Field	Type	Always present	Description
`entry_id`	string (uuid)	Yes
`identifier_type`	string	Yes
`category`	string	Yes	One of `payment_fraud`, `prohibited_content`, `ban_evasion`.
`member_case_ref`	string	Yes
`status`	string	Yes	One of `active`, `disputed`, `revoked`, `expired`.
`has_open_dispute`	boolean	Yes
`created_at`	string (date-time)	Yes
`updated_at`	string (date-time)	Yes
`expires_at`	string (date-time)	Yes
`revoked_at`	null or string (date-time)	Yes
`revoke_reason`	null or string	Yes

Example responseJSON

{
  "entry_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "identifier_type": "string",
  "category": "payment_fraud",
  "member_case_ref": "string",
  "status": "active",
  "has_open_dispute": false,
  "created_at": "2026-05-19T12:00:00.000Z",
  "updated_at": "2026-05-19T12:00:00.000Z",
  "expires_at": "2026-05-19T12:00:00.000Z",
  "revoked_at": "2026-05-19T12:00:00.000Z",
  "revoke_reason": "string"
}