curl --request POST \
--url https://verification.didit.me/v3/id-verification/wallets/smart-id/ \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Idempotency-Key: your-unique-attempt-key' \
--header 'Content-Type: application/json' \
--data '{
"country": "EST",
"vendor_data": "your-customer-reference",
"metadata": {
"reference": "example"
},
"personal_code": "00000000000"
}'import os
import requests
headers = {
"x-api-key": os.environ["DIDIT_API_KEY"],
"Idempotency-Key": "your-unique-attempt-key"
}
payload = {'country': 'EST',
'vendor_data': 'your-customer-reference',
'metadata': {'reference': 'example'},
'personal_code': '00000000000'}
response = requests.post(
"https://verification.didit.me/v3/id-verification/wallets/smart-id/",
headers=headers,
json=payload,
timeout=30,
)
response.raise_for_status()
print(response.json())
const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
country: 'EST',
vendor_data: 'your-customer-reference',
metadata: {reference: 'example'},
personal_code: '00000000000'
})
};
fetch('https://verification.didit.me/v3/id-verification/wallets/smart-id/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://verification.didit.me/v3/id-verification/wallets/smart-id/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'country' => 'EST',
'vendor_data' => 'your-customer-reference',
'metadata' => [
'reference' => 'example'
],
'personal_code' => '00000000000'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://verification.didit.me/v3/id-verification/wallets/smart-id/"
payload := strings.NewReader("{\n \"country\": \"EST\",\n \"vendor_data\": \"your-customer-reference\",\n \"metadata\": {\n \"reference\": \"example\"\n },\n \"personal_code\": \"00000000000\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://verification.didit.me/v3/id-verification/wallets/smart-id/")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"country\": \"EST\",\n \"vendor_data\": \"your-customer-reference\",\n \"metadata\": {\n \"reference\": \"example\"\n },\n \"personal_code\": \"00000000000\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://verification.didit.me/v3/id-verification/wallets/smart-id/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"country\": \"EST\",\n \"vendor_data\": \"your-customer-reference\",\n \"metadata\": {\n \"reference\": \"example\"\n },\n \"personal_code\": \"00000000000\"\n}"
response = http.request(request)
puts response.read_body{
"request_id": "00000000-0000-4000-8000-000000000001",
"wallet_verification": {
"wallet": {
"id": "smart_id",
"name": "Smart-ID",
"issuing_authority": "SK ID Solutions"
},
"country": "EST",
"status": "Not Finished",
"outcome": "pending",
"error": null,
"interaction": "in_app",
"simulated": true,
"expires_at": "2026-01-01T10:10:00Z",
"next_action": {
"type": "confirm_in_app",
"verification_code": "1234",
"poll_interval_seconds": 2
},
"identity": null,
"attributes": null,
"level_of_assurance": null,
"verified_at": null,
"signature_valid": null,
"credential_type": "person_identification"
},
"vendor_data": "your-customer-reference",
"metadata": {
"reference": "example"
},
"created_at": "2026-01-01T10:00:00Z"
}{
"error": "<string>",
"detail": "<string>"
}{
"detail": "Forbidden - User doesn't have permission"
}{
"error": "<string>",
"detail": "<string>"
}{
"error": "<string>",
"detail": "<string>"
}{
"error": "<string>",
"detail": "<string>"
}Smart-ID
Start Smart-ID identity verification through the standalone API, without a workflow.
curl --request POST \
--url https://verification.didit.me/v3/id-verification/wallets/smart-id/ \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Idempotency-Key: your-unique-attempt-key' \
--header 'Content-Type: application/json' \
--data '{
"country": "EST",
"vendor_data": "your-customer-reference",
"metadata": {
"reference": "example"
},
"personal_code": "00000000000"
}'import os
import requests
headers = {
"x-api-key": os.environ["DIDIT_API_KEY"],
"Idempotency-Key": "your-unique-attempt-key"
}
payload = {'country': 'EST',
'vendor_data': 'your-customer-reference',
'metadata': {'reference': 'example'},
'personal_code': '00000000000'}
response = requests.post(
"https://verification.didit.me/v3/id-verification/wallets/smart-id/",
headers=headers,
json=payload,
timeout=30,
)
response.raise_for_status()
print(response.json())
const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
country: 'EST',
vendor_data: 'your-customer-reference',
metadata: {reference: 'example'},
personal_code: '00000000000'
})
};
fetch('https://verification.didit.me/v3/id-verification/wallets/smart-id/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://verification.didit.me/v3/id-verification/wallets/smart-id/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'country' => 'EST',
'vendor_data' => 'your-customer-reference',
'metadata' => [
'reference' => 'example'
],
'personal_code' => '00000000000'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://verification.didit.me/v3/id-verification/wallets/smart-id/"
payload := strings.NewReader("{\n \"country\": \"EST\",\n \"vendor_data\": \"your-customer-reference\",\n \"metadata\": {\n \"reference\": \"example\"\n },\n \"personal_code\": \"00000000000\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://verification.didit.me/v3/id-verification/wallets/smart-id/")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"country\": \"EST\",\n \"vendor_data\": \"your-customer-reference\",\n \"metadata\": {\n \"reference\": \"example\"\n },\n \"personal_code\": \"00000000000\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://verification.didit.me/v3/id-verification/wallets/smart-id/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"country\": \"EST\",\n \"vendor_data\": \"your-customer-reference\",\n \"metadata\": {\n \"reference\": \"example\"\n },\n \"personal_code\": \"00000000000\"\n}"
response = http.request(request)
puts response.read_body{
"request_id": "00000000-0000-4000-8000-000000000001",
"wallet_verification": {
"wallet": {
"id": "smart_id",
"name": "Smart-ID",
"issuing_authority": "SK ID Solutions"
},
"country": "EST",
"status": "Not Finished",
"outcome": "pending",
"error": null,
"interaction": "in_app",
"simulated": true,
"expires_at": "2026-01-01T10:10:00Z",
"next_action": {
"type": "confirm_in_app",
"verification_code": "1234",
"poll_interval_seconds": 2
},
"identity": null,
"attributes": null,
"level_of_assurance": null,
"verified_at": null,
"signature_valid": null,
"credential_type": "person_identification"
},
"vendor_data": "your-customer-reference",
"metadata": {
"reference": "example"
},
"created_at": "2026-01-01T10:00:00Z"
}{
"error": "<string>",
"detail": "<string>"
}{
"detail": "Forbidden - User doesn't have permission"
}{
"error": "<string>",
"detail": "<string>"
}{
"error": "<string>",
"detail": "<string>"
}{
"error": "<string>",
"detail": "<string>"
}workflow_id.
The start response describes the next authentication action; it is not an approved identity result.
Coverage and activation
| Property | Value |
|---|---|
| Wallet | Smart-ID |
| Wallet ID | smart_id |
| Countries | |
| Production wallet activation | ✅ Available |
| Published wallet price | $0.20 per completed verification |
What the person does
Display the comparison code in your application and wait for the person to approve on their phone. The person enters their PIN on their phone, never in your application or API request. The all-zero identifiers in the request example are for Didit sandbox simulation only; use the person’s registered details for live authentication.Receive the result
Follow the Digital ID wallet API guide to track the verification and retrieve its result. Treat only a completed, verified result as proof that the wallet authenticated the person. Returned identity attributes vary by wallet; do not assume an address, portrait or every requested attribute is present.Related
Authorizations
Your application's API key, from Developers -> API keys in the Business Console. The primary key has full access. A named key can be scoped: none, read or write per resource, limited to some workflows or to approved sessions, to a list of IP addresses, and to an expiry date. 401 means the key is missing, wrong, revoked or expired; 403 means the key has no access to this resource or action, or the request came from an address outside its IP list; 404 on a session route means the session is outside the key's workflows or statuses. A key without media access receives image, video and PDF URLs as null, and a key without sessions write receives session links and tokens as null. See https://docs.didit.me/console/api-keys.
Headers
Optional retry-safety key (max 255 characters). Retrying with the same key, wallet and body returns the original verification without starting a second sign-in; the same key with another wallet or body returns 409 idempotency_key_reused.
Body
Start a Smart-ID verification (EST, LVA, LTU, BEL).
ISO 3166-1 alpha-3 country of the Smart-ID identity.
EST- ESTLVA- LVALTU- LTUBEL- BEL
EST, LVA, LTU, BEL The user's national personal identification code. It addresses the user's Smart-ID app; the user confirms the comparison code and enters their PIN in the app. Never collect the PIN.
1^[0-9-]{6,20}$Your own reference for this verification (e.g. your user id). Returned in results and webhooks.
Optional JSON object stored with the verification and returned in results and webhooks.
Show child attributes
Show child attributes
Sandbox applications only: the simulated outcome - 'wallet_cancelled', 'wallet_timeout' or 'wallet_provider_error'; any other scenario (or none) verifies. Rejected on live applications. The full catalog is available at GET /v1/sandbox/scenarios/.
1Response
One standalone wallet verification, as every wallet endpoint answers it.