Verifies input data against a Government agency database consisting of national identity data of citizens. 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:** Cambodia * **Service ID:** `khm_national_id` * **Data domain:** Identity * **Category:** NationalIDRegistry ## Inputs | Field | Required | Example | | --------------------- | -------: | -------------------- | | `first_name` | Yes | `John` | | `last_name` | Yes | `Doe` | | `date_of_birth` | Yes | `1990-01-01` | | `voter_id` | Yes | `SAMPLE-VOTER-12345` | | `gender` | No | `M` | | `address.street_1` | No | `123 Sample Street` | | `address.street_2` | No | `Unit 4` | | `address.city` | No | `Sample City` | | `address.region` | No | `Sample State` | | `address.postal_code` | No | `10001` | | `vendor_data` | No | `user-1234` | * **Required inputs:** `first_name`, `last_name`, `date_of_birth`, `voter_id` * **Optional inputs:** `gender`, `address.street_1`, `address.street_2`, `address.city`, `address.region`, `address.postal_code`, `vendor_data` * **Consent:** Required * **Workflow availability:** Available in workflow * **Coverage:** \~ 80% * **Price:** \$0.35 per successful query ## Body parameters ISO 3166-1 alpha-3 country code for this database service. Example: `KHM` Array containing this service ID. Pinning the service keeps the request scoped to this exact database. Example: `khm_national_id` Explicit end-user consent for this service. Example: `true` Given name to validate. Example: `John` Family name to validate. Example: `Doe` Date of birth in `YYYY-MM-DD` format. Example: `1990-01-01` Voter identifier. Example: `SAMPLE-VOTER-12345` Gender value, when required by the database. Allowed values: `M` (male), `F` (female), `X` (other or unknown). Example: `M` 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"}` 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 * `address` is optional for this service. You can send one complete `address` string and Didit will split it into structured address elements when possible, or you can send the structured fields explicitly. * `voter_id` must match `(?:\d{8,9}|\d{2}-\d{3}-\d{3})`. * 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=KHM" \ -F "services=khm_national_id" \ -F "vendor_data=user-1234" \ -F "consent=true" \ -F "first_name=John" \ -F "last_name=Doe" \ -F "date_of_birth=1990-01-01" \ -F "voter_id=SAMPLE-VOTER-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": "KHM", "match_type": "full_match", "validations": [ { "outcome_code": "MATCH", "service_id": "khm_national_id", "service_name": "Cambodia National ID", "source_data": { "address": "123 Sample Street", "address_match_score": "1.000", "building_number": "SAMPLE-12345", "city": "Sample City", "date_of_birth": "1990-01-01", "first_name": "John", "full_name": "John Doe", "identification_number": "SAMPLE-ID-12345", "last_name": "Doe", "name_match_score": "1.000", "state": "Sample State", "street": "sample_value", "verifications": { "date_of_birth": true, "full_name": true, "identification_number": true } }, "validation": { "date_of_birth": "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": "KHM", "match_type": "partial_match", "validations": [ { "outcome_code": "PARTIAL_MATCH", "service_id": "khm_national_id", "service_name": "Cambodia National ID", "source_data": { "address": "123 Sample Street", "address_match_score": "1.000", "building_number": "SAMPLE-12345", "city": "Sample City", "date_of_birth": "1990-01-01", "first_name": "John", "full_name": "John Doe", "identification_number": "SAMPLE-ID-12345", "last_name": "Doe", "name_match_score": "1.000", "state": "Sample State", "street": "sample_value", "verifications": { "date_of_birth": true, "full_name": false, "identification_number": true } }, "validation": { "date_of_birth": "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": "KHM", "match_type": "no_match", "validations": [ { "outcome_code": "NO_MATCH", "service_id": "khm_national_id", "service_name": "Cambodia National ID", "source_data": { "date_of_birth": "NO_MATCH", "full_name": "NO_MATCH", "identification_number": "NO_MATCH" }, "validation": { "date_of_birth": "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 `khm_national_id` currently documents this normalized shape: * `address` * `address_match_score` * `building_number` * `city` * `date_of_birth` * `first_name` * `full_name` * `identification_number` * `last_name` * `name_match_score` * `state` * `street` ## Pricing & SLAs Cambodia National ID queries are billed only when Didit receives a conclusive result from the validation source. * **Per-call price:** \$0.35 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 * [Cambodia Database Validation overview](/api-reference/database-validation/cambodia) * [Database Validation overview](/core-technology/database-validation/overview) * [Outcome Codes](/core-technology/database-validation/database-validation-outcome-codes)