> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Verifica Aadhaar India (UIDAI): API di confronto dati

> Validazione su database Aadhaar (UIDAI) in India tramite Didit: dati ufficiali. A partire da $0.42 per chiamata, senza contratti né minimi.

Verifica il numero Aadhaar inserito rispetto ai registri di identità UIDAI. Didit espone questo servizio tramite `POST /v3/database-validation/`, così puoi confrontare i dati inviati con la fonte autorevole e ricevere risultati di corrispondenza normalizzati.

## Copertura

* **Copertura:** \~ 100%
* **Paese:** India
* **ID servizio:** `ind_aadhaar`
* **Dominio dei dati:** Identità
* **Categoria:** NationalIDRegistry

## Input

| Campo | Obbligatorio | Esempio |
| - | -: | - |
| `full_name` | Sì | `John Doe` |
| `date_of_birth` | Sì | `1990-01-01` |
| `personal_number` | Sì | `111111111111` |
| `pan` | Sì | `ABCDE1234F` |
| `vendor_data` | No | `user-1234` |

* **Input obbligatori:** `full_name`, `date_of_birth`, `personal_number`, `pan`
* **Input facoltativi:** `vendor_data`
* **Consenso:** obbligatorio
* **Disponibilità nel workflow:** disponibile nel workflow
* **Copertura:** \~ 100%
* **Prezzo:** \$0.42 per query riuscita

Non tutti i documenti accettati da questo servizio contengono l'identificativo con cui viene interrogato. Quando l'identificativo non viene estratto dal documento, il controllo viene registrato come **non applicabile**: nessun database viene interrogato e non ti viene addebitato alcun costo. In alcuni paesi questo riguarda una quota consistente degli utenti reali. Per coprire questi casi, raccogli l'identificativo anche da una risposta di un Questionario, da un campo di estrazione di Document AI oppure da un valore che invii quando crei la sessione, e mappalo nel passaggio Validazione su database.

## Parametri del body

**issuing\_state** `string` *required* (default: IND)

Codice paese ISO 3166-1 alpha-3 per questo servizio di database.

Esempio: `IND`

**services** `string` *required* (default: ind\_aadhaar)

Array contenente questo ID servizio. Specificare il servizio mantiene la richiesta limitata a questo database specifico.

Esempio: `ind_aadhaar`

**consent** `boolean` *required* (default: true)

Consenso esplicito dell'utente finale per questo servizio.

Esempio: `true`

**full\_name** `string` *required* (default: John Doe)

Nome legale completo da validare.

Esempio: `John Doe`

**date\_of\_birth** `string` *required* (default: 1990-01-01)

Data di nascita nel formato `YYYY-MM-DD`.

Esempio: `1990-01-01`

**personal\_number** `string` *required* (default: 111111111111)

Numero di identità personale specifico del paese.

Esempio: `111111111111`

**pan** `string` *required* (default: ABCDE1234F)

Permanent Account Number.

Esempio: `ABCDE1234F`

**vendor\_data** `string` (default: user-1234)

Il tuo riferimento stabile per questa persona, ad esempio il tuo ID utente interno. Didit lo usa per collegare i controlli autonomi allo stesso utente finale e ridurre il rumore delle rilevazioni di duplicati.

Esempio: `user-1234`

## Regole di input e note di validazione

* `pan` deve contenere solo lettere maiuscole.
* `pan` deve corrispondere a `[A-Z]{5}\d{4}[A-Z]`.
* `personal_number` deve contenere solo cifre; rimuovi spazi, trattini e punteggiatura prima di inviare la richiesta.
* `personal_number` deve essere esattamente di 12 caratteri.

## Come effettuare la chiamata

```bash cURL theme={null}
curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=IND" \
  -F "services=ind_aadhaar" \
  -F "vendor_data=user-1234" \
  -F "consent=true" \
  -F "full_name=John Doe" \
  -F "date_of_birth=1990-01-01" \
  -F "personal_number=111111111111" \
  -F "pan=ABCDE1234F"
```

```python Python theme={null}
from didit import Didit

# Reads DIDIT_API_KEY.
client = Didit()

result = client.database_validation.validate(
    issuing_state="IND",
    services=["ind_aadhaar"],
    consent=True,
    full_name="John Doe",
    date_of_birth="1990-01-01",
    personal_number="111111111111",
    pan="ABCDE1234F",
    vendor_data="user-1234",
)
print(result)
```

```javascript Node.js theme={null}
import Didit from "@didit-protocol/sdk-node";

// Reads DIDIT_API_KEY.
const didit = new Didit();

const result = await didit.databaseValidation.validate({
  issuing_state: "IND",
  services: ["ind_aadhaar"],
  consent: true,
  full_name: "John Doe",
  date_of_birth: "1990-01-01",
  personal_number: "111111111111",
  pan: "ABCDE1234F",
  vendor_data: "user-1234",
});
console.log(result);
```

```go Go theme={null}
ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()

result, err := client.DatabaseValidation.Validate(ctx, didit.DatabaseValidationValidateParams{
	IssuingState:   "IND",
	Services:       didit.Some([]string{"ind_aadhaar"}),
	Consent:        didit.Bool(true),
	FullName:       didit.String("John Doe"),
	DateOfBirth:    didit.String("1990-01-01"),
	PersonalNumber: didit.String("111111111111"),
	Pan:            didit.String("ABCDE1234F"),
	VendorData:     didit.String("user-1234"),
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%+v\n", result)
```

```java Java theme={null}
import java.time.LocalDate;
import java.util.List;
import me.didit.Didit;
import me.didit.types.DatabaseValidationValidateParams;

// Reads DIDIT_API_KEY.
Didit client = new Didit();

var result = client.databaseValidation().validate(DatabaseValidationValidateParams.builder()
        .issuingState("IND")
        .services(List.of("ind_aadhaar"))
        .consent(true)
        .fullName("John Doe")
        .dateOfBirth(LocalDate.parse("1990-01-01"))
        .personalNumber("111111111111")
        .pan("ABCDE1234F")
        .vendorData("user-1234")
        .build());
System.out.println(result);
```

```php PHP theme={null}
<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Reads DIDIT_API_KEY.
$didit = new DiditClient();

$result = $didit->databaseValidation->validate([
    'issuing_state' => 'IND',
    'services' => ['ind_aadhaar'],
    'consent' => true,
    'full_name' => 'John Doe',
    'date_of_birth' => '1990-01-01',
    'personal_number' => '111111111111',
    'pan' => 'ABCDE1234F',
    'vendor_data' => 'user-1234',
]);
print_r($result->toArray());
```

```ruby Ruby theme={null}
require "didit"

# Reads DIDIT_API_KEY.
didit = Didit::Client.new

result = didit.database_validation.validate(
  issuing_state: "IND",
  services: ["ind_aadhaar"],
  consent: true,
  full_name: "John Doe",
  date_of_birth: "1990-01-01",
  personal_number: "111111111111",
  pan: "ABCDE1234F",
  vendor_data: "user-1234"
)
puts result.to_h
```

```csharp .NET theme={null}
using System;
using System.Text.Json;
using Didit;

// Reads DIDIT_API_KEY.
using var client = new DiditClient();

var result = await client.DatabaseValidation.ValidateAsync(new DatabaseValidationValidateParams
{
    IssuingState = "IND",
    Services = new string[] { "ind_aadhaar" },
    Consent = true,
    FullName = "John Doe",
    DateOfBirth = "1990-01-01",
    PersonalNumber = "111111111111",
    Pan = "ABCDE1234F",
    VendorData = "user-1234",
});
Console.WriteLine(JsonSerializer.Serialize(result));
```

Ogni chiamata riuscita restituisce HTTP `200`. Il campo **`outcome_code`** indica cosa è effettivamente accaduto, distinguendo ad esempio una vera mancata corrispondenza biometrica (`BIOMETRIC_NO_MATCH`) da un selfie che non è stato possibile leggere (`BIOMETRIC_IMAGE_UNUSABLE`). Lo `status` mostrato è lo stato predefinito della funzionalità; le [azioni Partial Match / No Match](https://docs.didit.me/it/core-technology/database-validation/database-validation-warnings.md) che hai configurato possono sostituirlo.

**`MATCH`**: il registro ha confermato l'identità e ogni campo verificato corrispondeva.

```json 200 OK — MATCH theme={null}
{
  "request_id": "req_01H…",
  "status": "Approved",
  "issuing_state": "IND",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "ind_aadhaar",
      "service_name": "India Aadhaar (UIDAI)",
      "source_data": {
        "date_of_birth": "1990-01-01",
        "full_name": "John Doe",
        "identification_number": "SAMPLE-ID-12345"
      },
      "validation": {
        "date_of_birth": "full_match",
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}
```

**`PARTIAL_MATCH`**: il numero di identificazione è stato trovato, ma uno o più campi personali (di solito nome o data di nascita) non corrispondevano completamente.

```json 200 OK — PARTIAL_MATCH theme={null}
{
  "request_id": "req_01H…",
  "status": "In Review",
  "issuing_state": "IND",
  "match_type": "partial_match",
  "validations": [
    {
      "outcome_code": "PARTIAL_MATCH",
      "service_id": "ind_aadhaar",
      "service_name": "India Aadhaar (UIDAI)",
      "source_data": {
        "date_of_birth": "1990-01-01",
        "full_name": "John Doe",
        "identification_number": "SAMPLE-ID-12345"
      },
      "validation": {
        "date_of_birth": "full_match",
        "full_name": "no_match",
        "identification_number": "full_match"
      }
    }
  ]
}
```

**`NO_MATCH`**: il registro non ha restituito alcuna corrispondenza per i dati inviati.

```json 200 OK — NO_MATCH theme={null}
{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "IND",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "NO_MATCH",
      "service_id": "ind_aadhaar",
      "service_name": "India Aadhaar (UIDAI)",
      "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"
      }
    }
  ]
}
```

## Dati restituiti

I campi esatti esposti in `source_data` dipendono da ciò che restituisce il registro. L'esempio generato per `ind_aadhaar` documenta attualmente questa struttura normalizzata:

* `date_of_birth`
* `full_name`
* `identification_number`

## Prezzi e SLA

Le query Aadhaar (UIDAI) per l'India vengono addebitate solo quando Didit riceve un risultato conclusivo dalla fonte di validazione.

* **Prezzo per chiamata:** \$0.42 USD.
* **Fatturazione:** per query riuscita. Non ti viene addebitato nulla quando il registro non è raggiungibile, quando mancano campi obbligatori o quando la richiesta viene rifiutata prima di raggiungere la fonte.
* **Latenza:** p95 tipico inferiore a 2 s.
* **Disponibilità:** 99.9% per trimestre lato Didit; la disponibilità della fonte a valle varia in base al paese e al dataset.

## Continua la lettura

* [Panoramica della Validazione su database per l'India](https://docs.didit.me/api-reference/database-validation/india.md)
* [Panoramica della Validazione su database](https://docs.didit.me/it/core-technology/database-validation/overview.md)
* [Codici di esito](https://docs.didit.me/it/core-technology/database-validation/database-validation-outcome-codes.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.