Skip to main content

Delete an ID tag

DELETE 
/id-tags/:id

Permanently removes an ID tag from the system. This action cannot be undone.

Use Cases:

  • Remove duplicate or incorrectly created tags
  • Clean up test data
  • Decommission tags that will never be reused
  • Comply with data deletion requests

Important Considerations:

  • Irreversible: Deletion is permanent and cannot be undone
  • Audit Impact: Historical transaction data referencing this tag remains, but tag details are lost
  • Active Sessions: Fails if tag has active charging sessions
  • Alternative: Consider using status BLOCKED instead to preserve audit trail

Best Practices:

  • Use BLOCKED status for lost/stolen cards instead of deletion
  • Only delete tags that were created in error or for testing
  • Export audit logs before deleting if compliance requires retention
  • Check for active sessions before deletion
danger

Deletion is permanent and irreversible. Historical transaction records will lose tag details. Consider using status=BLOCKED instead to preserve audit history.

warning

Deletion will fail if the tag has active charging sessions. Stop or complete all sessions first, or wait for them to finish naturally.

tip

For compliance and audit purposes, blocked tags are often preferable to deletion. Blocked tags preserve the full history while preventing future use.

Request​

Responses​

Standard success response for actions