Skip to content

API documentation

DLP API

Have emails with text, Word and PDF documents checked for sensitive data (Data Loss Prevention).

Version
0.2

Base URL

  • Testhttps://test-public-api.secumail.nl
  • Productionhttps://public-api.secumail.nl

Authentication

  • API key in the header x-api-key

You can request an API key or access credentials via contact.

Endpoints

GET/dlp

Retrieve DLP analysis results

Returns the DLP analysis results for a previously submitted document. The reference UUID and sender address must match the values used in the original POST request.

Poll this endpoint after uploading the document. Results are available once DLP processing is complete.

Parameters

NameInTypeDescription
reference *querystring

The UUID returned by the POST endpoint.

sender *querystring

The sender e-mail address used in the original POST request.

Responses

  • 200

    DLP results retrieved successfully

  • 400
  • 403
  • 405
  • 500
POST/dlp

After a successful response the client must PUT the raw .eml file to upload_url within 5 minutes.

Request body application/json

Example

{
  "sender": "mailbox@domain.com"
}

Responses

  • 200
  • 400
  • 403
  • 405
  • 500

Fields marked * are required. The technical descriptions come from the OpenAPI specification.

Discuss an integration?

Curious how SecuMailer connects to your application?

Book a free demo. We discuss your situation and the best way to integrate.

Book a free demo