Delete Document

Remove a previously uploaded verification document from your account. This endpoint allows clients to delete documents they have uploaded, such as outdated ID cards or driver's licenses that need to be replaced with updated versions.

When you delete a document, it is permanently removed from the system. If you need to update a document (for example, when your driver's license is renewed), you can either delete the old one first and upload a new version, or simply upload a new document of the same type which will automatically replace the existing one.

Important Restrictions

Some documents cannot be deleted if you have active or upcoming bookings. For example, your driver's license must remain on file while you have reservations. Attempting to delete required documents in these situations will result in an error.

Endpoint

INFO

DELETE /api/v1/client/documents/{type}

Headers

Header	Value	Required
Accept	application/json	Yes
Authorization	Bearer {token}	Yes
X-Agency-Signature	{signature}	Yes

Path Parameters

Parameter	Type	Description
type	string	Document type to delete

Example Request

curl -X DELETE https://api.daakey.com/api/v1/client/documents/id_card \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {token}" \
  -H "X-Agency-Signature: {signature}"

Response

Success (200)

{
  "success": true,
  "message": "Document deleted successfully",
  "data": null,
  "request_id": "uuid",
  "timestamp": "2024-01-01T00:00:00.000Z"
}

Error (404)

{
  "success": false,
  "message": "Document not found",
  "data": null,
  "request_id": "uuid",
  "timestamp": "2024-01-01T00:00:00.000Z"
}

Error (400)

{
  "success": false,
  "message": "Cannot delete required document",
  "data": {
    "reason": "Driver license is required for active bookings"
  },
  "request_id": "uuid",
  "timestamp": "2024-01-01T00:00:00.000Z"
}

Notes

• Required documents cannot be deleted if there are active bookings
• Deleting a verified document may affect booking eligibility