PII detection & De-identification service API

Note: These APIs are available for private deployment. Not Generally Available. Email our team for getting access to these APIs: info@mayadataprivacy.eu

📄 Submit an Anonymization (De-identification) Job

🔗 Endpoint

POST /mdp/ai-safe/job/anonymize

---

🔐 Authentication

• Type: API Key
• Key Name: Authorization
• Location: Header
• Description: JWT token for authorization

---

Description:

Submits a new anonymization job. The text is processed asynchronously. Once completed, the result will be posted to the given webhook URL.

📥 Request

• Content-Type: application/json

Parameters

Name	Type	Required	Description
text	String	✅	Text to anonymize
lang	String	✅	Language code (e.g., en, de, etc.)
webhook_url	String	✅	HTTPS endpoint to receive the result
choices	Array	✅	Array of info types to anonymize: "Names", "Emails", "Phone"

🧪 Example Request

{
  "lang": "eng",
  "text": "Hello this is a test prompt by John. My email Id is John@mail.com and my number is +5424351451",
  "choices": ["Names", "Emails", "Phone"],
  "webhook_url": "https://yourdomain.com/webhook-endpoint"
}

---

📤 Response

{
  "success": true,
  "message": "Anonymization Job Accepted",
  "response_code": 200
}

Once processing completes, the service sends a POST request to the provided webhook URL.

---

📬 Webhook Payload

✅ Success

{
  "job_id": "8d93cfc6-4023-478d-bd3b-6b693d6cf3ca", 
  "status": "completed", 
  "anonymized_text": "Hello this is a test prompt by Miller. My email Id is Maria.Miller.1@dummy.com and my number is +918506513874"
}

❌ Failure

{
  "job_id": "8d93cfc6-4023-478d-bd3b-6b693d6cf3ca",
  "status": "failed",
  "error": "some error occured"
}