Langsung ke konten utama
POST
Mengembalikan status CPF (reguler, ditangguhkan, dibatalkan), nama, nama sosial, dan tanggal registrasi dari Receita Federal melalui SERPRO. Pencarian dilakukan berdasarkan CPF dan tanggal lahir. Didit menyediakan layanan ini melalui POST /v3/database-validation/ sehingga Anda dapat memverifikasi data yang dikirim terhadap sumber resmi dan menerima hasil pencocokan yang sudah dinormalisasi. Format input: tax_number menerima CPF Brasil (tepat 11 digit).

Cakupan

  • Cakupan: ~ 100%
  • Negara: Brasil
  • ID layanan: bra_cpf
  • Domain data: Identitas
  • Kategori: TaxRegistry

Input

  • Input wajib: tax_number, date_of_birth
  • Input opsional: first_name, last_name, vendor_data
  • Persetujuan: Tidak diperlukan
  • Ketersediaan di alur kerja: Tersedia di alur kerja
  • Cakupan: ~ 100%
  • Harga: $0.20 per kueri yang berhasil
Tidak setiap dokumen yang diterima layanan ini memuat pengenal yang digunakan untuk kueri. Jika pengenal tidak diekstrak dari dokumen, pemeriksaan dicatat sebagai tidak berlaku. Dalam kondisi ini tidak ada database yang dikueri dan Anda tidak dikenai biaya. Untuk beberapa negara, kondisi ini mencakup sebagian besar pengguna sungguhan. Agar tetap tercakup, kumpulkan juga pengenal tersebut dari jawaban Kuesioner, kolom hasil ekstraksi Document AI, atau nilai yang Anda kirim saat membuat sesi, lalu petakan pada langkah Validasi Database.

Parameter body

string
default:"BRA"
wajib
Kode negara ISO 3166-1 alpha-3 untuk layanan database ini.Contoh: BRA
string
default:"bra_cpf"
wajib
Array yang berisi ID layanan ini. Menetapkan layanan membuat permintaan hanya berlaku untuk database yang tepat ini.Contoh: bra_cpf
string
default:"11111111111"
wajib
Nomor identifikasi pajak atau fiskal.Contoh: 11111111111
string
default:"1990-01-01"
wajib
Tanggal lahir dalam format YYYY-MM-DD.Contoh: 1990-01-01
string
Nama depan yang akan divalidasi.Contoh: John
string
Nama keluarga yang akan divalidasi.Contoh: Doe
string
default:"user-1234"
Referensi pengguna yang stabil dari Anda untuk orang ini, misalnya ID pengguna internal Anda. Didit menggunakannya untuk menautkan pemeriksaan terpisah ke pengguna akhir yang sama dan mengurangi gangguan dari deteksi duplikat.Contoh: user-1234

Aturan input & catatan validasi

  • CPF Brasil (tepat 11 digit)
  • tax_number hanya boleh berisi digit; hapus spasi, tanda hubung, dan tanda baca sebelum mengirim permintaan.
  • tax_number harus tepat 11 karakter.

Cara memanggilnya

Data yang dikembalikan

Kolom yang muncul di source_data bergantung pada apa yang dikembalikan registri. Contoh yang dihasilkan untuk bra_cpf saat ini mendokumentasikan bentuk ternormalisasi berikut:
  • date_of_birth
  • first_name
  • identification_number
  • last_name
  • lgpd_minor
  • minor_under_16
  • minor_under_18
  • registration_date

Harga & SLA

Brasil - kueri pemeriksaan status CPF hanya ditagih ketika Didit menerima hasil yang konklusif dari sumber validasi.
  • Harga per panggilan: $0.20 USD.
  • Penagihan: per kueri yang berhasil. Anda tidak dikenai biaya ketika registri tidak dapat dijangkau, ketika kolom wajib tidak ada, atau ketika permintaan ditolak sebelum mencapai sumber.
  • Latensi: p95 tipikal kurang dari 2 dtk.
  • Ketersediaan: 99.9% per kuartal di sisi Didit; ketersediaan sumber hilir bervariasi menurut negara dan dataset.

Lanjutkan membaca

Terakhir diubah pada 7 November 2026