Tiny IDP icon

Tiny IDP

Extract data from identity documents using Tiny IDP

Tiny IDP

AI-generated

Summary

Extracts structured data from an identity or registration document image by sending it to the Tiny IDP API extractor for the selected document type, and returns the API's JSON response.

Inputs

  • Document Type (required) — Which extractor to run: European Driver License, French Carte Grise, International ID Card, International Passport (default), Proof of Address, Spanish CIF, Spanish DNI, Spanish Vehicle Registration, or Spanish Vehicle Technical Sheet. It is appended to the API path /api/extractors/run/{documentType}.
  • Input Type (required) — Whether the document is supplied as a Public URL (default) or as a File (Binary).
  • URL — Shown when Input Type is URL. Public URL of the document image, sent to the API as a one-element urls array. The node doesn't check that it's non-empty.
  • Binary Property — Shown when Input Type is File. Name of the incoming item's binary property holding the file (default 'data'). The node throws an error if the property is missing. The file is uploaded as multipart/form-data under the field 'files', using its original filename and MIME type.

Output shape

A list of n8n items built from the Tiny IDP API response. If the response is an array, each element becomes an item. Otherwise the response becomes a single item. Items are paired to their source input item.

The fields returned depend on the document type, and the source doesn't define them. The node runs once per input item and needs Tiny IDP API credentials (tinyIdpApi). With Continue On Fail enabled, a failed item yields {error: message} instead of stopping the workflow. Otherwise the node throws a NodeApiError.

Examples

Example 1: Verify a passport image from a public link during customer onboarding.

Document Type: International Passport; Input Type: Public URL; URL: https://example.com/passport.jpg

Example 2: Extract data from a Spanish DNI that was uploaded through a form or email trigger.

Document Type: Spanish National ID Card (DNI); Input Type: File (Binary); Binary Property: data

Example 3: Read the address from a utility bill received as an attachment.

Document Type: Proof of Address; Input Type: File (Binary); Binary Property: attachment_0

Links

Discussion