Verifies input data against Credit Header data obtained from a Credit Bureau in Italy. Didit exposes this service through `POST /v3/database-validation/` so you can verify the submitted data against the authoritative source and receive normalized match results. ## Coverage * **Coverage:** \~ 80% * **Country:** Italy * **Service ID:** `ita_credit_bureau` * **Data domain:** Financial * **Category:** CreditBureau ## Inputs | Field | Required | Example | | --------------------- | -------: | ------------------- | | `first_name` | Yes | `John` | | `last_name` | Yes | `Doe` | | `address.street_1` | Yes | `123 Sample Street` | | `address.postal_code` | Yes | `10001` | | `tax_number` | Yes | `SAMPLE-TAX-12345` | | `date_of_birth` | No | `1990-01-01` | | `address.street_2` | No | `Unit 4` | | `address.city` | No | `Sample City` | | `address.region` | No | `Sample State` | | `vendor_data` | No | `user-1234` | * **Required inputs:** `first_name`, `last_name`, `address.street_1`, `address.postal_code`, `tax_number` * **Optional inputs:** `date_of_birth`, `address.street_2`, `address.city`, `address.region`, `vendor_data` * **Consent:** Not required * **Workflow availability:** Available in workflow * **Coverage:** \~ 80% * **Price:** \$1.95 per successful query ## Body parameters ISO 3166-1 alpha-3 country code for this database service. Example: `ITA` Array containing this service ID. Pinning the service keeps the request scoped to this exact database. Example: `ita_credit_bureau` Given name to validate. Example: `John` Family name to validate. Example: `Doe` Structured residential address object. Use `street_1`, `street_2`, `city`, `region`, `postal_code`, and `country`. A complete legacy address string is still accepted but not recommended. Example: `{"street_1":"123 Sample Street","street_2":"Unit 4","city":"Sample City","region":"Sample State","postal_code":"10001","country":"US"}` Tax or fiscal identification number. Example: `SAMPLE-TAX-12345` Date of birth in `YYYY-MM-DD` format. Example: `1990-01-01` Your stable user reference for this person, such as your internal user ID. Didit uses it to link standalone checks to the same end user and reduce duplicate-detection noise. Example: `user-1234` ## Input rules & validation notes * `tax_number` must be exactly 16 characters long. * For address services, send structured address fields instead of a single `address` string when possible. * `address.street_1` is the street address, including street number and street type. * `address.street_2` is apartment, unit, building, floor, or extra address line. Send it only when you have it. * `address.city` is city, suburb, district, locality, or neighborhood. * `address.region` is state, province, region, or town. * `address.postal_code` is postcode or postal code. * Address-based database services require at least street address and postal code; requests rejected before source lookup are not charged. ## How to call it ```bash cURL theme={null} curl -X POST "https://verification.didit.me/v3/database-validation/" \ -H "x-api-key: YOUR_API_KEY" \ -F "issuing_state=ITA" \ -F "services=ita_credit_bureau" \ -F "vendor_data=user-1234" \ -F "first_name=John" \ -F "last_name=Doe" \ -F 'address={"street_1":"123 Sample Street","street_2":"Unit 4","city":"Sample City","region":"Sample State","postal_code":"10001","country":"US"}' \ -F "tax_number=SAMPLE-TAX-12345" ``` Every successful call returns HTTP `200`. The **`outcome_code`** field tells you what actually happened — distinguishing, for example, a real biometric mismatch (`BIOMETRIC_NO_MATCH`) from a selfie that could not be read (`BIOMETRIC_IMAGE_UNUSABLE`). The `status` shown is the default feature status; your configured [Partial Match / No Match actions](/core-technology/database-validation/database-validation-warnings) can override it. **`MATCH`** — The registry confirmed the identity and every checked field matched. ```json 200 OK — MATCH theme={null} { "request_id": "req_01H…", "status": "Approved", "issuing_state": "ITA", "match_type": "full_match", "validations": [ { "outcome_code": "MATCH", "service_id": "ita_credit_bureau", "service_name": "Italy Credit Bureau", "source_data": { "address": "123 Sample Street", "date_of_birth": "1990-01-01", "first_name": "John", "identification_number": "SAMPLE-ID-12345", "last_name": "Doe" }, "validation": { "address": "full_match", "full_name": "full_match", "identification_number": "full_match" } } ] } ``` **`PARTIAL_MATCH`** — The identification number was found but one or more personal fields (usually name or date of birth) did not fully match. ```json 200 OK — PARTIAL_MATCH theme={null} { "request_id": "req_01H…", "status": "In Review", "issuing_state": "ITA", "match_type": "partial_match", "validations": [ { "outcome_code": "PARTIAL_MATCH", "service_id": "ita_credit_bureau", "service_name": "Italy Credit Bureau", "source_data": { "address": "123 Sample Street", "date_of_birth": "1990-01-01", "first_name": "John", "identification_number": "SAMPLE-ID-12345", "last_name": "Doe" }, "validation": { "address": "full_match", "full_name": "no_match", "identification_number": "full_match" } } ] } ``` **`NO_MATCH`** — The registry returned no match for the submitted data. ```json 200 OK — NO_MATCH theme={null} { "request_id": "req_01H…", "status": "Declined", "issuing_state": "ITA", "match_type": "no_match", "validations": [ { "outcome_code": "NO_MATCH", "service_id": "ita_credit_bureau", "service_name": "Italy Credit Bureau", "source_data": { "address": "NO_MATCH", "full_name": "NO_MATCH", "identification_number": "NO_MATCH" }, "validation": { "address": "no_match", "full_name": "no_match", "identification_number": "no_match" } } ] } ``` ## Returned data The exact fields surfaced in `source_data` depend on what the registry returns. The generated example for `ita_credit_bureau` currently documents this normalized shape: * `address` * `date_of_birth` * `first_name` * `identification_number` * `last_name` ## Pricing & SLAs Italy Credit Bureau queries are billed only when Didit receives a conclusive result from the validation source. * **Per-call price:** \$1.95 USD. * **Billing:** per successful query. You are not charged when the registry is unreachable, when required fields are missing, or when the request is rejected before reaching the source. * **Latency:** typical p95 \< 2 s. * **Availability:** 99.9% per quarter on Didit's side; downstream source availability varies by country and dataset. ## Continue reading * [Italy Database Validation overview](/api-reference/database-validation/italy) * [Database Validation overview](/core-technology/database-validation/overview) * [Outcome Codes](/core-technology/database-validation/database-validation-outcome-codes)