DEV Community

Nabeel Krissane
Nabeel Krissane

Posted on

Build an ID Document Detection App in Minutes with Deep Detect

#ai #api #tutorial

Want to automatically detect ID documents (passports, ID cards, driver licenses) in your app? With Deep Detect you can set up a detection flow in under 15 minutes.

1. Get your API key & services

  • Sign up at deepdetect.app
  • You’ll get an API key.
  • To list available detection services (like ID documents, faces, license plates, etc.), call the services endpoint: 
curl --location 'https://deepdetect.app/api/get-services' \
  --header 'dd-api-key: YOUR_API_KEY'
Enter fullscreen mode Exit fullscreen mode

This returns service codes you’ll use when analyzing images.

2. Call the analyze-image endpoint

Basic request (replace SERVICE-CODE with your ID detection service code):

curl --location 'https://deepdetect.app/api/analyze-image' \
  --header 'dd-api-key: YOUR_API_KEY' \
  --form 'image=@"/path/to/file.jpg"' \
  --form 'action="SERVICE-CODE"'
Enter fullscreen mode Exit fullscreen mode

The API responds with predictions + confidence scores. You can decide thresholds (e.g., passport confidence > 0.7).

3. Add a tiny proxy server

Never expose your API key in frontend code. Quick Node.js proxy example:

app.post('/api/detect-id', upload.single('image'), async (req, res) => {
  const form = new FormData();
  form.append('image', fs.createReadStream(req.file.path));
  form.append('action', process.env.DD_SERVICE);

  const ddRes = await axios.post('https://deepdetect.app/api/analyze-image', form, {
    headers: { 'dd-api-key': process.env.DD_API_KEY, ...form.getHeaders() },
  });

  res.json(ddRes.data);
});
Enter fullscreen mode Exit fullscreen mode

Frontend just uploads to /api/detect-id and shows the result.

4. That’s it 🎉

  • List services with /api/services.
  • Detect ID documents with /api/analyze-image.
  • Wrap it in a small backend proxy.
  • Use predictions + confidence scores to flag or process ID documents in your app. In minutes, you’ve got a working ID document detection app powered by Deep Detect.

Top comments (0)