curl --request POST \
  --url https://verification.didit.me/v3/id-verification/wallets/idin/ \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Idempotency-Key: your-unique-attempt-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "country": "NLD",
  "vendor_data": "your-customer-reference",
  "metadata": {
    "reference": "example"
  },
  "return_url": "https://app.example.com/identity/complete"
}'

from didit import Didit

# Reads DIDIT_API_KEY.
client = Didit()

result = client.id_wallets.start_idin(
    vendor_data="your-customer-reference",
    metadata={"reference": "example"},
    country="NLD",
    return_url="https://app.example.com/identity/complete",
)
print(result)

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

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

const result = await didit.idWallets.startIdin({
  vendor_data: "your-customer-reference",
  metadata: { reference: "example" },
  country: "NLD",
  return_url: "https://app.example.com/identity/complete",
});
console.log(result);

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

result, err := client.IDWallets.StartIdin(ctx, didit.IDWalletsStartIdinParams{
	Body: didit.DigitalIDWalletAPIIdinWalletVerificationStartRequest{
		VendorData: didit.String("your-customer-reference"),
		Metadata:   didit.Some(map[string]any{"reference": "example"}),
		Country:    didit.Some(didit.DigitalIDWalletAPIIdinWalletVerificationStartCountryEnum("NLD")),
		ReturnURL:  "https://app.example.com/identity/complete",
	},
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%+v\n", result)

import java.util.Map;
import me.didit.Didit;
import me.didit.types.DigitalIdWalletApiIdinWalletVerificationStartCountryEnum;
import me.didit.types.DigitalIdWalletApiIdinWalletVerificationStartRequest;

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

var result = client.idWallets().startIdin(DigitalIdWalletApiIdinWalletVerificationStartRequest.builder()
        .vendorData("your-customer-reference")
        .metadata(Map.of("reference", "example"))
        .country(DigitalIdWalletApiIdinWalletVerificationStartCountryEnum.of("NLD"))
        .returnUrl("https://app.example.com/identity/complete")
        .build());
System.out.println(result);

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

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

$result = $didit->idWallets->startIdin([
    'vendor_data' => 'your-customer-reference',
    'metadata' => ['reference' => 'example'],
    'country' => 'NLD',
    'return_url' => 'https://app.example.com/identity/complete',
]);
print_r($result->toArray());

require "didit"

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

result = didit.id_wallets.start_idin(
  vendor_data: "your-customer-reference",
  metadata: { reference: "example" },
  country: "NLD",
  return_url: "https://app.example.com/identity/complete"
)
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.StartIdinAsync(new DigitalIdWalletApiIdinWalletVerificationStartRequest
{
    VendorData = "your-customer-reference",
    Metadata = new Dictionary<string, object> { ["reference"] = "example" },
    Country = new DigitalIdWalletApiIdinWalletVerificationStartCountryEnum("NLD"),
    ReturnUrl = "https://app.example.com/identity/complete",
});
Console.WriteLine(JsonSerializer.Serialize(result));

{
  "request_id": "00000000-0000-4000-8000-000000000001",
  "wallet_verification": {
    "wallet": {
      "id": "idin",
      "name": "iDIN",
      "issuing_authority": "Dutch banks (Currence iDIN)"
    },
    "country": "NLD",
    "status": "Not Finished",
    "outcome": "pending",
    "error": null,
    "interaction": "redirect",
    "simulated": false,
    "expires_at": "2026-01-01T10:10:00Z",
    "next_action": {
      "type": "redirect",
      "url": "https://wallet.example.com/authorize"
    },
    "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>"
}