curl --request POST \
  --url https://verification.didit.me/v3/id-verification/wallets/mobile-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",
  "phone_number": "+37200000000"
}'

from didit import Didit

# Reads DIDIT_API_KEY.
client = Didit()

result = client.id_wallets.start_mobile_id(
    vendor_data="your-customer-reference",
    metadata={"reference": "example"},
    country="EST",
    personal_code="00000000000",
    phone_number="+37200000000",
)
print(result)

import Didit from "@didit-protocol/sdk-node";

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

const result = await didit.idWallets.startMobileId({
  vendor_data: "your-customer-reference",
  metadata: { reference: "example" },
  country: "EST",
  personal_code: "00000000000",
  phone_number: "+37200000000",
});
console.log(result);

ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()

result, err := client.IDWallets.StartMobileID(ctx, didit.IDWalletsStartMobileIDParams{
	Body: didit.DigitalIDWalletAPIMobileIDWalletVerificationStartRequest{
		VendorData:   didit.String("your-customer-reference"),
		Metadata:     didit.Some(map[string]any{"reference": "example"}),
		Country:      didit.DigitalIDWalletAPIMobileIDWalletVerificationStartCountryEnum("EST"),
		PersonalCode: "00000000000",
		PhoneNumber:  "+37200000000",
	},
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%+v\n", result)

import java.util.Map;
import me.didit.Didit;
import me.didit.types.DigitalIdWalletApiMobileIdWalletVerificationStartCountryEnum;
import me.didit.types.DigitalIdWalletApiMobileIdWalletVerificationStartRequest;

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

var result = client.idWallets().startMobileId(DigitalIdWalletApiMobileIdWalletVerificationStartRequest.builder()
        .vendorData("your-customer-reference")
        .metadata(Map.of("reference", "example"))
        .country(DigitalIdWalletApiMobileIdWalletVerificationStartCountryEnum.of("EST"))
        .personalCode("00000000000")
        .phoneNumber("+37200000000")
        .build());
System.out.println(result);

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

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

$result = $didit->idWallets->startMobileId([
    'vendor_data' => 'your-customer-reference',
    'metadata' => ['reference' => 'example'],
    'country' => 'EST',
    'personal_code' => '00000000000',
    'phone_number' => '+37200000000',
]);
print_r($result->toArray());

require "didit"

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

result = didit.id_wallets.start_mobile_id(
  vendor_data: "your-customer-reference",
  metadata: { reference: "example" },
  country: "EST",
  personal_code: "00000000000",
  phone_number: "+37200000000"
)
puts result.to_h

using System;
using System.Collections.Generic;
using System.Text.Json;
using Didit;

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

var result = await client.IdWallets.StartMobileIdAsync(new DigitalIdWalletApiMobileIdWalletVerificationStartRequest
{
    VendorData = "your-customer-reference",
    Metadata = new Dictionary<string, object> { ["reference"] = "example" },
    Country = "EST",
    PersonalCode = "00000000000",
    PhoneNumber = "+37200000000",
});
Console.WriteLine(JsonSerializer.Serialize(result));

{
  "request_id": "00000000-0000-4000-8000-000000000001",
  "wallet_verification": {
    "wallet": {
      "id": "mobile_id",
      "name": "Mobile-ID",
      "issuing_authority": "SK ID Solutions with the national mobile operators"
    },
    "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>"
}