OCR Certidão de Casamento

API de OCR para
Certidões de Casamento

Extraia dados estruturados de certidões de casamento brasileiras automaticamente com OCR alimentado por IA. Receba os dois cônjuges, o casamento e o cartório em JSON, em segundos.

Comece Grátis Ver Documentação

Campos extraídos

Todos os campos que a API devolve, com a chave de cada um na resposta JSON e o rótulo que o modelo oficial da certidão imprime para ele. Os cônjuges vêm na ordem em que a certidão os imprime.

Documento `documento`

O que a certidão é: seu tipo, título e forma.

tipoO tipo do documento: sempre Certidão de Casamento.
títuloNa certidão: CERTIDÃO DE CASAMENTOO título impresso no alto da certidão, como impresso. Ele distingue um casamento religioso com efeito civil, uma transcrição ou um inteiro teor de uma certidão comum.
formaA forma da certidão, pelo título: breve relato (o resumo que todo modelo imprime) ou inteiro teor (o texto completo do registro).

Registro `registro`

Onde o casamento está registrado.

matrículaNa certidão: MatrículaO número do registro (matrícula): 32 dígitos em nove grupos. Vazio numa certidão emitida antes de 2010, que não tem matrícula.
livroLivro do registro: como impresso nas certidões antigas, onde pode ter letras; senão, tirado da matrícula.
folhaFolha do registro: como impressa nas certidões antigas; senão, tirada da matrícula.
termoTermo do registro: como impresso nas certidões antigas; senão, tirado da matrícula.

Cônjuge 1 `cônjuge_1`

O cônjuge impresso primeiro na certidão (a ordem como impressa; nenhum gênero implícito).

nome_completoNa certidão: Nome atual dos cônjugesO nome do cônjuge no campo de nomes da certidão; num modelo sem esse campo, o nome que o texto dá ao cônjuge. Numa certidão emitida antes de 2025, pode ser o nome de antes do casamento: nome_atual diz quando a certidão declara o nome atual.
nome_atualNa certidão: Nome atual dos cônjugesO nome atual do cônjuge, só quando a certidão o declara assim, como faz o modelo em vigor desde 2025. Vazio nas certidões antigas: um nome atual nunca é deduzido.
cpfNa certidão: Número do CPFNúmero do CPF (Cadastro de Pessoa Física). Formato: XXX.XXX.XXX-XX. Certidões emitidas antes de 2018 não o imprimem.
nome_habilitaçãoNa certidão: Nome no momento da habilitaçãoO nome no momento da habilitação, como impresso; as certidões antigas o chamam de nome de solteiro.
nome_após_casamentoNa certidão: Nome que passou a utilizarO nome que o cônjuge passou a usar com o casamento, como impresso. Vazio quando a certidão não imprime um para este cônjuge: antes de 2025, só o cônjuge que mudou de nome tem um.
data_nascimento.diaNa certidão: Data de nascimento: diaDia do nascimento, em algarismos.
data_nascimento.mêsNa certidão: Data de nascimento: mêsMês do nascimento, em algarismos.
data_nascimento.anoNa certidão: Data de nascimento: anoAno do nascimento, em algarismos.
nacionalidadeNa certidão: NacionalidadeNacionalidade, como impressa.
estado_civilNa certidão: Estado civilEstado civil no momento da habilitação, como impresso. Não é a situação civil atual, que nunca é deduzida.
estado_civil_códigoestado_civil como código: solteiro, divorciado, viúvo ou outro. Vazio quando a certidão não imprime estado civil.
município_naturalidadeNa certidão: Município da naturalidadeMunicípio de nascimento; o país, para quem nasceu no exterior.
uf_naturalidadeNa certidão: UFEstado de nascimento, em duas letras; EX para quem nasceu no exterior.
genitoresNa certidão: Genitor(es)Os nomes dos genitores, separados por ; .
profissãoProfissão, como impressa. Certidões emitidas antes de 2010 e o inteiro teor a imprimem.
domicílioDomicílio e residência, como impressos. Certidões emitidas antes de 2010 e o inteiro teor os imprimem.

Cônjuge 2 `cônjuge_2`

O cônjuge impresso em segundo na certidão (a ordem como impressa; nenhum gênero implícito).

nome_completoNa certidão: Nome atual dos cônjugesO nome do cônjuge no campo de nomes da certidão; num modelo sem esse campo, o nome que o texto dá ao cônjuge. Numa certidão emitida antes de 2025, pode ser o nome de antes do casamento: nome_atual diz quando a certidão declara o nome atual.
nome_atualNa certidão: Nome atual dos cônjugesO nome atual do cônjuge, só quando a certidão o declara assim, como faz o modelo em vigor desde 2025. Vazio nas certidões antigas: um nome atual nunca é deduzido.
cpfNa certidão: Número do CPFNúmero do CPF (Cadastro de Pessoa Física). Formato: XXX.XXX.XXX-XX. Certidões emitidas antes de 2018 não o imprimem.
nome_habilitaçãoNa certidão: Nome no momento da habilitaçãoO nome no momento da habilitação, como impresso; as certidões antigas o chamam de nome de solteiro.
nome_após_casamentoNa certidão: Nome que passou a utilizarO nome que o cônjuge passou a usar com o casamento, como impresso. Vazio quando a certidão não imprime um para este cônjuge: antes de 2025, só o cônjuge que mudou de nome tem um.
data_nascimento.diaNa certidão: Data de nascimento: diaDia do nascimento, em algarismos.
data_nascimento.mêsNa certidão: Data de nascimento: mêsMês do nascimento, em algarismos.
data_nascimento.anoNa certidão: Data de nascimento: anoAno do nascimento, em algarismos.
nacionalidadeNa certidão: NacionalidadeNacionalidade, como impressa.
estado_civilNa certidão: Estado civilEstado civil no momento da habilitação, como impresso. Não é a situação civil atual, que nunca é deduzida.
estado_civil_códigoestado_civil como código: solteiro, divorciado, viúvo ou outro. Vazio quando a certidão não imprime estado civil.
município_naturalidadeNa certidão: Município da naturalidadeMunicípio de nascimento; o país, para quem nasceu no exterior.
uf_naturalidadeNa certidão: UFEstado de nascimento, em duas letras; EX para quem nasceu no exterior.
genitoresNa certidão: Genitor(es)Os nomes dos genitores, separados por ; .
profissãoProfissão, como impressa. Certidões emitidas antes de 2010 e o inteiro teor a imprimem.
domicílioDomicílio e residência, como impressos. Certidões emitidas antes de 2010 e o inteiro teor os imprimem.

Casamento `casamento`

O casamento: seu tipo, suas datas, sua celebração e o regime de bens.

tipoO tipo de casamento, pelo título, pelo livro e pela matrícula: civil, religioso com efeito civil ou conversão de união estável. Vazio quando nada na certidão o diz.
data_celebração.texto_completoNa certidão: Data da celebração do casamento ou, se for o caso de conversão da união estável, data do registro: por extensoA data por extenso, só quando a certidão a imprime por extenso.
data_celebração.diaNa certidão: Data da celebração do casamento ou, se for o caso de conversão da união estável, data do registro: diaDia, em algarismos.
data_celebração.mêsNa certidão: Data da celebração do casamento ou, se for o caso de conversão da união estável, data do registro: mêsMês, em algarismos.
data_celebração.anoNa certidão: Data da celebração do casamento ou, se for o caso de conversão da união estável, data do registro: anoAno, em algarismos.
local_celebraçãoLocal da celebração, como impresso. Certidões emitidas antes de 2010 o imprimem.
celebranteQuem celebrou o casamento, com o título impresso. Certidões emitidas antes de 2010 o imprimem.
documentos_apresentadosOs documentos apresentados para o casamento, como impressos. Certidões emitidas antes de 2010 os imprimem.
regime_bensNa certidão: Regime de bensO regime de bens como impresso, com os dados do pacto antenupcial quando a certidão os imprime.
regime_bens_códigoregime_bens como código: comunhão parcial, comunhão universal, separação convencional, separação obrigatória, participação final nos aquestos ou outro. Vazio quando a certidão não imprime regime.
data_registro.texto_completoNa certidão: Data de registro do casamento: por extensoA data por extenso, só quando a certidão a imprime por extenso.
data_registro.diaNa certidão: Data de registro do casamento: diaDia, em algarismos.
data_registro.mêsNa certidão: Data de registro do casamento: mêsMês, em algarismos.
data_registro.anoNa certidão: Data de registro do casamento: anoAno, em algarismos.

Observações `observações`

O que o cartório acrescentou ao registro, e qualquer dado impresso sem campo próprio.

averbações_anotaçõesNa certidão: Anotações/AverbaçõesO texto das averbações e anotações, como impresso: um divórcio, uma mudança de regime, uma retificação.
anotações_cadastroNa certidão: Anotações voluntárias de cadastroDados de cadastro impressos a pedido das partes, como números de documentos, como impressos. Certidões emitidas a partir de 2018 os imprimem.
outras_informaçõesQualquer dado que a certidão imprime e que não tem campo próprio, como impresso, para que nada impresso se perca. Nunca um título, um rótulo de campo ou um texto padrão.

Inteiro teor `inteiro_teor`

O texto completo do registro, para um inteiro teor.

textoNa certidão: Texto do registro digitadoO texto completo do registro, como impresso, quando a certidão é um inteiro teor. Um inteiro teor é lido quando cabe em uma página: uma requisição leva uma imagem. Lemos apenas a primeira página do PDF. Vazio para um breve relato.

Cartório `cartório`

O cartório que emitiu a certidão.

nomeNa certidão: Oficial de Registro Civil de Pessoas NaturaisO nome do cartório, como impresso.
cnsNa certidão: CNS nºO código nacional do cartório (CNS): como impresso; senão, os seis primeiros dígitos da matrícula.
municípioNa certidão: CidadeO município do cartório.
ufNa certidão: UFO estado do cartório, em duas letras.
endereçoNa certidão: Rua, nº, complemento, CEPO endereço do cartório, como impresso.
telefoneO telefone do cartório, como impresso.
emailO e-mail do cartório, como impresso.

Autenticação `autenticação`

O que torna a certidão conferível: o selo, quem assinou e quando foi emitida.

selo_digitalNa certidão: QR CodeO selo digital ou código de verificação, onde o estado tem um.
consulta_autenticidadeOnde a certidão diz que sua autenticidade pode ser conferida, como impresso.
oficial_registroNa certidão: Nome do OficialO nome impresso do oficial de registro.
assinanteNa certidão: Nome do Oficial/EscreventeQuem assinou a certidão, como impresso ao lado da assinatura: o oficial, um substituto ou um escrevente.
cargo_assinanteNa certidão: CargoO cargo de quem assinou, como impresso.
data_emissãoNa certidão: Cidade – UF, dataData em que a certidão foi emitida. Formato: DD/MM/AAAA.
número_papelO número de série do papel de segurança da certidão.

Uma requisição, todos os campos

Envie uma imagem de certidão de casamento e receba JSON estruturado. Cada certidão lida custa 1,5 crédito nos motores padrão.

Requisição
#!/usr/bin/env bash
# Extract the hosted sample marriage certificate (fictitious data).
# Needs DOCSOCR_API_KEY in the environment; create a key in the panel.
set -euo pipefail

REQUEST_ID="marriage-$(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/marriage-certificate \
  -H "Authorization: Bearer $DOCSOCR_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<EOF
{
  "imageType": "url",
  "imageUrl": "https://docsocr.com/samples/certidao-casamento-exemplo.jpg",
  "requestId": "$REQUEST_ID"
}
EOF

Resposta201 Created
{
  "success": true,
  "processingTimeMs": 7107,
  "data": {
    "documento": {
      "tipo": "Certidão de Casamento",
      "título": "CERTIDÃO DE CASAMENTO",
      "forma": "breve relato"
    },
    "registro": {
      "matrícula": "123456 01 55 2025 2 00034 045 0009876 12",
      "livro": "34",
      "folha": "45",
      "termo": "9876"
    },
    "cônjuge_1": {
      "nome_completo": "RAFAEL COSTA TESTE",
      "nome_atual": "RAFAEL COSTA TESTE",
      "cpf": "123.456.789-09",
      "nome_habilitação": "RAFAEL COSTA TESTE",
      "nome_após_casamento": "RAFAEL COSTA TESTE",
      "data_nascimento": {
        "dia": "12",
        "mês": "05",
        "ano": "1994"
      },
      "nacionalidade": "BRASILEIRA",
      "estado_civil": "SOLTEIRO",
      "estado_civil_código": "solteiro",
      "município_naturalidade": "RECIFE",
      "uf_naturalidade": "PE",
      "genitores": "JOSÉ COSTA TESTE; MARIA COSTA TESTE",
      "profissão": "",
      "domicílio": ""
    },
    "cônjuge_2": {
      "nome_completo": "JULIANA MENDES COSTA TESTE",
      "nome_atual": "JULIANA MENDES COSTA TESTE",
      "cpf": "987.654.321-00",
      "nome_habilitação": "JULIANA MENDES TESTE",
      "nome_após_casamento": "JULIANA MENDES COSTA TESTE",
      "data_nascimento": {
        "dia": "03",
        "mês": "09",
        "ano": "1996"
      },
      "nacionalidade": "BRASILEIRA",
      "estado_civil": "SOLTEIRA",
      "estado_civil_código": "solteiro",
      "município_naturalidade": "OLINDA",
      "uf_naturalidade": "PE",
      "genitores": "PAULO MENDES TESTE; ANA MENDES TESTE",
      "profissão": "",
      "domicílio": ""
    },
    "casamento": {
      "tipo": "civil",
      "data_celebração": {
        "texto_completo": "VINTE E DOIS DE MARÇO DE DOIS MIL E VINTE E CINCO",
        "dia": "22",
        "mês": "03",
        "ano": "2025"
      },
      "local_celebração": "",
      "celebrante": "",
      "documentos_apresentados": "",
      "regime_bens": "COMUNHÃO PARCIAL DE BENS",
      "regime_bens_código": "comunhão parcial",
      "data_registro": {
        "texto_completo": "VINTE E DOIS DE MARÇO DE DOIS MIL E VINTE E CINCO",
        "dia": "22",
        "mês": "03",
        "ano": "2025"
      }
    },
    "observações": {
      "averbações_anotações": "",
      "anotações_cadastro": "",
      "outras_informações": ""
    },
    "inteiro_teor": {
      "texto": ""
    },
    "cartório": {
      "nome": "CARTÓRIO DO 1º OFÍCIO DE REGISTRO CIVIL DE RECIFE - PE",
      "cns": "123456",
      "município": "RECIFE",
      "uf": "PE",
      "endereço": "RUA DO EXEMPLO, 100, BOA VISTA, CEP 50000-000",
      "telefone": "",
      "email": ""
    },
    "autenticação": {
      "selo_digital": "",
      "consulta_autenticidade": "",
      "oficial_registro": "PEDRO EXEMPLO",
      "assinante": "MARIANA EXEMPLO",
      "cargo_assinante": "ESCREVENTE",
      "data_emissão": "25/03/2025",
      "número_papel": ""
    }
  },
  "engine": "large",
  "creditsCharged": 1.5
}

Qualidade e Confiabilidade

Extração feita para o seu sistema

1344–2048 px

Padrão de imagem, onde a extração lê melhor

Motores de IA com fallback automático

Imagens armazenadas após a extração

JSON

Campos com o rótulo oficial da certidão

Como Funciona

Extraia dados de certidões de casamento em 3 passos simples

Crie sua chave de API

Cadastre-se gratuitamente e gere uma chave de API no painel administrativo.

Envie a imagem da certidão

Faça uma requisição POST para o endpoint da certidão de casamento, com a URL da imagem ou dados codificados em base64.

Receba JSON estruturado

Receba todos os campos extraídos como JSON limpo e estruturado, pronto para sua aplicação.

Comece agora grátis

Perguntas Frequentes

Dúvidas comuns sobre OCR de certidões de casamento

Quais formatos e tamanhos de arquivo são aceitos?

Aceitamos arquivos PDF*, JPG, PNG, WebP e GIF, com até 10 MB por documento. Você pode enviar arquivos via URL ou conteúdo codificado em Base64 na requisição da API. Nosso padrão de imagem é de 1344 a 2048 px no lado maior (numa digitalização A4, cerca de 120 a 175 DPI), onde a extração lê melhor: uma imagem fora dele é recusada sem custo, ou redimensionada do nosso lado pelo preço do redimensionamento quando a requisição usa resizeImage: true, o que soma um pouco de tempo à resposta. *Lemos apenas a primeira página do PDF.

Quais modelos de certidão de casamento a API lê?

Os modelos de certidão emitidos de antes de 2010 até 2024, de casamentos civis e religiosos com efeito civil, inclusive com averbação de divórcio. A resposta tem os campos de todos esses modelos: um campo que a certidão não imprime vem vazio.

E as certidões em inteiro teor?

Uma certidão em inteiro teor é lida quando cabe em uma página: o texto completo do registro vem em inteiro_teor.texto, e os campos da resposta são preenchidos a partir dele.

Como a API identifica os dois cônjuges?

Pela ordem em que a certidão os imprime: cônjuge_1 é o primeiro e cônjuge_2 é o segundo, sem supor gênero.

Qual é a precisão da extração?

A precisão depende da qualidade da imagem e do estado do documento: por isso nosso padrão aceita imagens de 1344 a 2048 px no lado maior, onde a extração lê melhor. Se um motor de IA falhar com um documento, outro o processa automaticamente. Recomendamos testar com os seus próprios documentos.

Meus dados estão seguros?

Sim. O DocsOCR é 100% compatível com LGPD, GDPR e CCPA. Imagens de documentos são processadas em tempo real e não são armazenadas após a extração. A comunicação usa TLS 1.2 ou 1.3, e os dados guardados são criptografados em repouso.

Comece a extrair dados de certidões de casamento

Créditos grátis incluídos. Sem necessidade de cartão de crédito.

Criar Conta Grátis Ler a Documentação

Campos extraídos

Documento documento

Registro registro

Cônjuge 1 cônjuge_1

Cônjuge 2 cônjuge_2

Casamento casamento

Observações observações

Inteiro teor inteiro_teor

Cartório cartório

Autenticação autenticação