Hasil verifikasi melalui Status API

Mitra dapat memeriksa status verifikasi melalui endpoint API status verifikasi kami (GET /api/partner/v2/verify/requests/{id}). Endpoint ini mengembalikan hasil verifikasi dan informasi kredensial untuk permintaan verifikasi tertentu.

Autentikasi memerlukan token JWT dari endpoint token OAuth kami, dan API membutuhkan ID permintaan yang dibuat saat permintaan verifikasi asli diajukan.

Status

Status	Deskripsi
`incomplete`	Verifikasi sedang berlangsung. Tidak ada hasil yang tersedia pada tahap ini.
`canceled`	Verifikasi tidak lagi dilanjutkan dan tidak ada hasil yang tersedia.
`verified`	Verifikasi berhasil diselesaikan dan hasil tersedia.
`revoked`	Hasil verifikasi tidak valid. Semua salinan hasil harus dihapus.
`unshared`	Hasil verifikasi tidak tersedia. Ini terjadi ketika pengguna meminta pembagian diakhiri, atau belum menyetujui untuk membagikan kredensial yang diperbarui.

Silakan merujuk ke Spesifikasi OpenAPI V2 kami untuk detail lebih lanjut tentang format permintaan dan respons.

Contoh permintaan

Contoh hasil verifikasi: Kredensial terverifikasi

# GET /api/partner/v2/verify/requests/7cbc7e51-82f5-43ec-8d63-b7cdf1170425

{
    "request_id": "7cbc7e51-82f5-43ec-8d63-b7cdf1170425",
    "created_at": "2026-03-11T23:44:03.863583Z",
    "results": [
        {
            "credential_type": "digital_identity",
            "status": "verified",
            "verified_at": "2026-03-12T00:27:46.657218Z",
            "digital_identity": {
                "full_name": "John Smith"
            }
        }
    ]
}

Contoh hasil verifikasi: Verifikasi tidak lengkap

{
    "request_id": "9a98ba28-cd63-43d4-9959-9c593700c7da",
    "created_at": "2026-01-20T02:43:09.440220Z",
    "results": [
        {
            "credential_type": "digital_identity",
            "status": "incomplete"
        }
    ]
}

Contoh hasil verifikasi: Verifikasi dibatalkan

{
    "request_id": "793a798c-92ac-4b5f-9866-ef73e6b4c6d9",
    "created_at": "2026-01-20T02:43:09.440220Z",
    "results": [
        {
            "credential_type": "digital_identity",
            "status": "canceled"
        }
    ]
}

API Status Massal

API status massal juga tersedia untuk menanyakan status beberapa permintaan verifikasi secara bersamaan. Hingga 30 ID permintaan dapat disertakan dalam satu kueri.

Karena batasan ukuran kueri maksimum, bergantung pada panjang ID yang diberikan, Anda mungkin menerima respons 403 Forbidden jika string kueri Anda lebih panjang dari 2048 byte. Jika Anda mencapai batas ini, silakan kurangi jumlah ID kueri yang diteruskan dalam permintaan Anda dan coba lagi.

# GET /api/partner/v2/verify/requests?request_id[]=25055614-f707-47cc-b7ed-1724c04dcd05&request_id[]=9a98ba28-cd63-43d4-9959-9c593700c7da
{
    "requests": [
        {
            "request_id": "9a98ba28-cd63-43d4-9959-9c593700c7da",
            "created_at": "2026-01-20T02:43:09.440220Z",
            "results": [
                {
                    "credential_type": "digital_identity",
                    "status": "incomplete"
                }
            ]
        },
        {
            "request_id": "25055614-f707-47cc-b7ed-1724c04dcd05",
            "created_at": "2025-12-18T06:34:34.338171Z",
            "results": [
                {
                    "credential_type": "digital_identity",
                    "status": "verified",
                    "verified_at": "2025-12-18T07:26:01.571197Z",
                    "digital_identity": {
                        "full_name": "John Smith"
                    }
                }
            ]
        }
    ]
}

Sebelumnya: Alur Integrasi

Berikutnya: Webhook