Birth Certificate
OCR API
Automatically extract structured data from Brazilian birth certificates (certidões de nascimento) with AI-powered OCR. Get JSON results in seconds.
Extracted Fields
Every field the API returns, with its key in the JSON answer
Document information documento
tipoDocument typeórgão_emissorIssuing authority
Personal data dados_pessoais
nome_completoFull name as written on the certificate.cpfCPF number (Brazilian tax ID). Format:XXX.XXX.XXX-XXmatrículaRegistration number (matrícula) — the unique certificate identifier.data_nascimento.texto_completoComplete birth date textdata_nascimento.diaDay of birthdata_nascimento.mêsMonth of birthdata_nascimento.anoYear of birthhora_nascimentoTime of birth in 24-hour format.naturalidadePlace of birth — city name.sexoGender as written on the certificate.
Birth location local_nascimento
estabelecimentoBirth establishmentmunicípioMunicipality of birthufState/province of birth
Registration information registro
municípioMunicipality of registrationufState/province of registrationcartórioRegistry officedata_registroRegistration datenúmero_dnvLive birth declaration numberlivroBook (livro) of the registration: as printed on older certificates, else taken from the 32-digit matrículafolhaPage (folha) of the registration: as printed on older certificates, else taken from the 32-digit matrículatermoEntry (termo) of the registration: as printed on older certificates, else taken from the 32-digit matrícula
Filiation information filiação
genitor_1.nome_completoFull namegenitor_1.naturalidadePlace of birthgenitor_2.nome_completoFull namegenitor_2.naturalidadePlace of birth
Grandparents information avós
paternos.avôGrandfather's namepaternos.avóGrandmother's namematernos.avôGrandfather's namematernos.avóGrandmother's name
Twin information gêmeos
statusTwin statusinformações_adicionaisAdditional twin information
Observations and notes observações
averbaçõesAmendments to the registrationanotaçõesAdditional notes
Authentication information autenticação
selo_digitalDigital sealoficial_registroRegistry officialdata_emissãoIssue date
One request, every field
Send a birth certificate image and get structured JSON back
Request
#!/usr/bin/env bash
# Your first call: extract the hosted sample certificate (fictitious data).
# Needs DOCSOCR_API_KEY in the environment; create a key in the panel.
set -euo pipefail
REQUEST_ID="first-call-$(date +%s)-$RANDOM" # one id per document
# The API answers within 90 s
curl -sS --max-time 120 https://api.docsocr.com/api/v1/documents/birth-certificate \
-H "Authorization: Bearer $DOCSOCR_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<EOF
{
"imageType": "url",
"imageUrl": "https://docsocr.com/samples/certidao-nascimento-exemplo.jpg",
"requestId": "$REQUEST_ID"
}
EOFResponse
{
"success": true,
"processingTimeMs": 6120,
"data": {
"documento": {
"tipo": "Certidão de Nascimento",
"órgão_emissor": "CARTÓRIO DO 1º OFÍCIO DE REGISTRO CIVIL DE RECIFE - PE"
},
"dados_pessoais": {
"nome_completo": "ANA BEATRIZ DOS SANTOS TESTE",
"cpf": "123.456.789-09",
"matrícula": "123456 01 55 2020 1 00012 123 0001234 56",
"data_nascimento": {
"texto_completo": "",
"dia": "15",
"mês": "03",
"ano": "2020"
},
"hora_nascimento": "08:45",
"naturalidade": "RECIFE - PE",
"sexo": "FEMININO"
},
"local_nascimento": {
"estabelecimento": "HOSPITAL EXEMPLO",
"município": "RECIFE",
"uf": "PE"
},
"registro": {
"município": "RECIFE",
"uf": "PE",
"cartório": "CARTÓRIO DO 1º OFÍCIO DE REGISTRO CIVIL DE RECIFE - PE",
"data_registro": "20/03/2020",
"número_dnv": "",
"livro": "A-123",
"folha": "045",
"termo": "00012"
},
"filiação": {
"genitor_1": {
"nome_completo": "CARLA DOS SANTOS TESTE",
"naturalidade": ""
},
"genitor_2": {
"nome_completo": "JOÃO PEREIRA TESTE",
"naturalidade": ""
}
},
"avós": {
"paternos": {
"avô": "ANTÔNIO PEREIRA",
"avó": "LÚCIA PEREIRA"
},
"maternos": {
"avô": "JOSÉ DOS SANTOS",
"avó": "MARIA DOS SANTOS"
}
},
"gêmeos": {
"status": "Não",
"informações_adicionais": ""
},
"observações": {
"averbações": "",
"anotações": ""
},
"autenticação": {
"selo_digital": "",
"oficial_registro": "PEDRO EXEMPLO",
"data_emissão": "20/03/2020"
}
},
"engine": "mini",
"creditsCharged": 1
}Quality & Reliability
Extraction built for your system
How It Works
Extract birth certificate data in 3 simple steps
Create your API key
Sign up for free and generate an API key from the admin dashboard.
Send the certificate image
Make a POST request with the image URL or base64-encoded image data.
Get structured JSON
Receive all extracted fields as clean, structured JSON ready for your application.
Frequently Asked Questions
Common questions about birth certificate OCR
What file formats and sizes are accepted?
We accept PDF*, JPG, PNG, WebP and GIF files, up to 10 MB per document. You can send files via URL or Base64-encoded content in the API request. Our image standard is 1344 to 2048 px on the long side (for an A4 scan, about 120 to 175 DPI), where extraction reads best: an image outside it is refused at no charge, or resized on our side for 1 extra credit when the request sets resizeImage: true, which adds a little time to the answer. *Only the first page of a PDF is read.
Does it work with handwritten birth certificates?
The API is optimized for typed/printed birth certificates, which represent the vast majority of modern Brazilian certificates. Handwritten documents may have lower accuracy depending on legibility.
Does it support both old and new format certificates?
Yes. The API handles both the older format (pre-2010) and the current standardized format with the matrícula number. Field extraction adapts automatically to the certificate format detected.
How accurate is the extraction?
Accuracy depends on the image quality and the document's condition: that is why our standard takes images of 1344 to 2048 px on the long side, where extraction reads best. If one AI engine fails on a document, another processes it automatically. We recommend testing with your own documents.
Is my data secure?
Yes. DocsOCR is 100% compliant with LGPD (Brazilian data protection law), GDPR, and CCPA. Document images are processed in real time and are not stored after extraction. Communication uses TLS 1.2 or 1.3, and stored data is encrypted at rest.
Start extracting birth certificate data
Free credits included. No credit card required.