Extrair dados de uma certidão de casamento

POST /documents/marriage-certificate

O que faz: extrai todos os campos de uma certidão de casamento brasileira a partir de uma foto, um escaneamento ou um PDF.

Uma página: um inteiro teor, o texto completo do registro, é lido quando cabe em uma página, já que uma requisição leva uma imagem. Lemos apenas a primeira página do PDF.

Envie a imagem em uma URL pública (imageType: "url" com imageUrl) ou no corpo (imageType: "base64" com imageBase64). Teste com a certidão de exemplo hospedada, https://docsocr.com/samples/certidao-casamento-exemplo.jpg (dados fictícios).

Nosso padrão de imagem: 1344 a 2048 px no lado maior, onde todos os motores leem melhor. Uma imagem fora dele é recusada com 422, sem custo, a menos que resizeImage: true peça que a redimensionemos, pelo preço do redimensionamento; isso soma tempo à resposta.

O motor fast: "engine": "fast" o pede. Ele é tentado primeiro, e os motores padrão entram em seguida se ele não conseguir responder.

A resposta: os campos da certidão em data, o motor que respondeu (engine) e quanto a requisição custou (creditsCharged). Um valor que não pode estar certo, como um CPF cujos dígitos verificadores não conferem, vem como foi lido, com um aviso em warnings. Quando a imagem não é uma certidão de casamento, quando nada pode ser lido nela ou quando nenhum motor consegue responder, o status continua 201, com success: false, um errorCode e nada cobrado: DOCUMENT_NOT_RECOGNIZED (outro documento, ou uma imagem sem nada para ler) e IMAGE_NOT_PROCESSABLE pedem outra imagem; EXTRACTION_BUSY, EXTRACTION_TIMEOUT e EXTRACTION_UNAVAILABLE podem passar quando você envia a mesma requisição de novo mais tarde.

Repetindo uma requisição: o mesmo requestId, arquivo e opções em até 15 minutos da resposta recebem a mesma resposta sem custo, sem rodar os motores, com o header Idempotent-Replayed: true. Enquanto a primeira requisição ainda roda, uma repetição recebe 409 REQUEST_IN_PROGRESS com Retry-After.

Preço: uma resposta com dados custa o preço do motor que a responde, como GET /documents/prices o lista para cada documento: sem engine, nunca mais que o maior dos motores padrão; com "engine": "fast", nunca mais que o do fast. Verificar saldo

Autenticação

Sua chave de API DocsOCR, enviada como Authorization: Bearer <chave>. As chaves começam com dso_live_v1_ ou dso_test_v1_; as duas chamam os motores e usam créditos. Gerenciar chaves

Parâmetros

accept-language header "en" ou "pt-BR", padrão "en" Opcional
O idioma das mensagens de recusas, erros e avisos: pt-BR para português, inglês nos outros casos.

Corpo da requisição

A imagem da certidão, em uma URL pública ou em base64: imageType diz qual.

Content-Type: application/json

imageType "url" ou "base64" Obrigatório
"url": a imagem está em imageUrl. "base64": a imagem está em imageBase64.
requestId string Obrigatório
Seu ID para esta requisição, com até 128 caracteres: letras, dígitos, _, -, . e :. Não coloque dados pessoais nele. O mesmo requestId com o mesmo arquivo e as mesmas opções em até 15 minutos da resposta devolve a mesma resposta sem custo, sem rodar os motores; com outro arquivo ou outras opções, é uma nova requisição. A resposta não o repete.
imageUrl string Com imageType: "url"
URL pública da imagem da certidão: um link direto que abre sem login.
imageBase64 string Com imageType: "base64"
O arquivo da certidão em base64, com ou sem o prefixo data URI, por exemplo data:image/jpeg;base64,/9j/4AAQ.... PDF*, JPG, PNG, WebP ou GIF, com até 10 MB; o tipo é lido do próprio arquivo. *Lemos apenas a primeira página do PDF.
resizeImage boolean, padrão false Opcional
Redimensiona uma imagem fora do nosso padrão (1344 a 2048 px no lado maior) para caber nele, em vez de recusá-la: o preço do redimensionamento se soma ao da extração, e a resposta traz imageResized: true. A requisição precisa dos dois preços disponíveis enquanto roda (GET /documents/prices os lista para cada documento). Sem ele, essa imagem é recusada com 422 e não custa nada. Uma imagem dentro do padrão nunca é redimensionada e custa o preço da extração de qualquer forma.
engine "fast" Opcional
Pede o motor fast: ele é tentado primeiro e, quando não consegue responder, os motores padrão entram em seguida. Deixe de fora para usar os motores padrão. Só "fast" é aceito; qualquer outro valor é recusado com 400 e não custa nada.

Exemplos

A certidão de exemplo hospedada (dados fictícios)Um arquivo em base64 (encurtado aqui)Pedindo o motor fast

json

{
  "imageType": "url",
  "imageUrl": "https://docsocr.com/samples/certidao-casamento-exemplo.jpg",
  "requestId": "5d2e8f1a-7c3b-4a9e-8f6d-2b1c0e9a7d4f"
}

json

{
  "imageType": "base64",
  "imageBase64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAgGBgcG...",
  "requestId": "a3f7c9e1-2b4d-4c6e-9a8b-7d5f3e1c9b2a"
}

json

{
  "imageType": "url",
  "imageUrl": "https://docsocr.com/samples/certidao-casamento-exemplo.jpg",
  "requestId": "e8b4d2f6-1a3c-4e5b-9d7f-0c2a4b6d8e1f",
  "engine": "fast"
}

Respostas

201 Created

Os dados da certidão. Com success: false, nenhum motor conseguiu responder: errorCode diz por quê, e nada foi cobrado.

Idempotent-Replayed header
true quando a resposta é a guardada para uma repetição: a mesma resposta da primeira vez, sem custo, sem os motores. Ausente nos outros casos.

Campos da resposta

success boolean
true se a extração foi bem-sucedida. Verifique o campo error se false.
error string
O que deu errado. Presente apenas quando success é false.
errorCode "IMAGE_MISSING" ou "IMAGE_BASE64_INVALID" ou "IMAGE_TOO_LARGE" ou "IMAGE_TOO_MANY_PIXELS" ou "IMAGE_FORMAT_UNSUPPORTED" ou "IMAGE_UNREADABLE" ou "IMAGE_URL_NOT_ALLOWED" ou "IMAGE_RESOLUTION_TOO_LOW" ou "IMAGE_RESOLUTION_TOO_HIGH" ou "IMAGE_INVALID" ou "PDF_PASSWORD_PROTECTED" ou "PDF_UNREADABLE" ou "PDF_TOO_MANY_PAGES" ou "IMAGE_DOWNLOAD_FAILED" ou "IMAGE_NOT_PROCESSABLE" ou "DOCUMENT_NOT_RECOGNIZED" ou "EXTRACTION_TIMEOUT" ou "EXTRACTION_BUSY" ou "EXTRACTION_UNAVAILABLE"
Por que a extração falhou, como um código que o seu sistema pode tratar. error explica em palavras simples. Presente apenas quando success é false.
processingTimeMs number
Quanto tempo a extração levou, em milissegundos.
warnings objeto[]
Valores de data para conferir no documento. Um valor que não pode estar certo, como um CPF cujos dígitos verificadores não conferem, vem como foi lido, com um aviso aqui; a requisição é cobrada como qualquer outra. Presente apenas quando há um.
warnings[].code "INVALID_CPF"
O que há de errado com o valor, como um código que o seu sistema pode tratar.
warnings[].field string
O campo de data a que se refere, como um caminho com pontos.
warnings[].message string
O que há de errado e o que fazer, em palavras simples.
imageResized boolean
true quando a imagem estava fora do nosso padrão (1344 a 2048 px no lado maior) e foi redimensionada para caber nele, como resizeImage pediu: o preço do redimensionamento se somou ao da extração. Presente apenas quando isso aconteceu.
originalImageSize objeto
Tamanho da imagem como você a enviou, na orientação de exibição. Presente apenas quando imageResized é true.
originalImageSize.width number
Largura, em pixels.
originalImageSize.height number
Altura, em pixels.
finalImageSize objeto
Tamanho da imagem depois de redimensionada ao nosso padrão. Presente apenas quando imageResized é true.
finalImageSize.width number
Largura, em pixels.
finalImageSize.height number
Altura, em pixels.
engine "mini" ou "large" ou "fast"
O motor que respondeu com dados: mini ou large para os motores padrão, ou fast quando a requisição o pediu e o fast respondeu. Presente apenas quando um motor respondeu.
creditsCharged number
Créditos que esta requisição custou, ao centésimo: o preço do motor que respondeu (nunca mais que o do motor que você pediu), mais o redimensionamento. 0 quando nada foi cobrado: uma imagem recusada, nenhum motor conseguiu responder, ou uma repetição respondida com a resposta guardada (Idempotent-Replayed: true).
data objeto
Dados extraídos da certidão. Todos os campos de uma certidão de casamento, vazios onde a certidão não imprime nada. Quando success é false, todos os campos vêm vazios, menos o tipo do documento.

A certidão de exemplo, respondida por um motor padrãoUm CPF cujos dígitos verificadores não conferem: vem como foi lido, com um avisoNenhum motor conseguiu responder: nada cobrado, envie de novo mais tardeNão é uma certidão de casamento: nada cobrado, não repitaOutro documento que a API lê: nada cobrado, a mensagem diz o endpoint que o lê

json

{
  "success": true,
  "processingTimeMs": 7480,
  "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
}

json

{
  "success": true,
  "processingTimeMs": 7480,
  "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-00",
      "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": ""
    }
  },
  "warnings": [
    {
      "code": "INVALID_CPF",
      "field": "cônjuge_1.cpf",
      "message": "The value read is not a valid CPF: it is returned as read. Check it on the document."
    }
  ],
  "engine": "large",
  "creditsCharged": 1.5
}

json

{
  "success": false,
  "processingTimeMs": 1203,
  "error": "The extraction service is busy. Please retry in a few moments. No credit was charged.",
  "errorCode": "EXTRACTION_BUSY",
  "data": {
    "documento": {
      "tipo": "Certidão de Casamento",
      "título": "",
      "forma": ""
    },
    "registro": {
      "matrícula": "",
      "livro": "",
      "folha": "",
      "termo": ""
    },
    "cônjuge_1": {
      "nome_completo": "",
      "nome_atual": "",
      "cpf": "",
      "nome_habilitação": "",
      "nome_após_casamento": "",
      "data_nascimento": {
        "dia": "",
        "mês": "",
        "ano": ""
      },
      "nacionalidade": "",
      "estado_civil": "",
      "estado_civil_código": "",
      "município_naturalidade": "",
      "uf_naturalidade": "",
      "genitores": "",
      "profissão": "",
      "domicílio": ""
    },
    "cônjuge_2": {
      "nome_completo": "",
      "nome_atual": "",
      "cpf": "",
      "nome_habilitação": "",
      "nome_após_casamento": "",
      "data_nascimento": {
        "dia": "",
        "mês": "",
        "ano": ""
      },
      "nacionalidade": "",
      "estado_civil": "",
      "estado_civil_código": "",
      "município_naturalidade": "",
      "uf_naturalidade": "",
      "genitores": "",
      "profissão": "",
      "domicílio": ""
    },
    "casamento": {
      "tipo": "",
      "data_celebração": {
        "texto_completo": "",
        "dia": "",
        "mês": "",
        "ano": ""
      },
      "local_celebração": "",
      "celebrante": "",
      "documentos_apresentados": "",
      "regime_bens": "",
      "regime_bens_código": "",
      "data_registro": {
        "texto_completo": "",
        "dia": "",
        "mês": "",
        "ano": ""
      }
    },
    "observações": {
      "averbações_anotações": "",
      "anotações_cadastro": "",
      "outras_informações": ""
    },
    "inteiro_teor": {
      "texto": ""
    },
    "cartório": {
      "nome": "",
      "cns": "",
      "município": "",
      "uf": "",
      "endereço": "",
      "telefone": "",
      "email": ""
    },
    "autenticação": {
      "selo_digital": "",
      "consulta_autenticidade": "",
      "oficial_registro": "",
      "assinante": "",
      "cargo_assinante": "",
      "data_emissão": "",
      "número_papel": ""
    }
  },
  "creditsCharged": 0
}

json

{
  "success": false,
  "processingTimeMs": 2410,
  "error": "The document could not be processed. Check that the image shows a marriage certificate. No credit was charged.",
  "errorCode": "DOCUMENT_NOT_RECOGNIZED",
  "data": {
    "documento": {
      "tipo": "Certidão de Casamento",
      "título": "",
      "forma": ""
    },
    "registro": {
      "matrícula": "",
      "livro": "",
      "folha": "",
      "termo": ""
    },
    "cônjuge_1": {
      "nome_completo": "",
      "nome_atual": "",
      "cpf": "",
      "nome_habilitação": "",
      "nome_após_casamento": "",
      "data_nascimento": {
        "dia": "",
        "mês": "",
        "ano": ""
      },
      "nacionalidade": "",
      "estado_civil": "",
      "estado_civil_código": "",
      "município_naturalidade": "",
      "uf_naturalidade": "",
      "genitores": "",
      "profissão": "",
      "domicílio": ""
    },
    "cônjuge_2": {
      "nome_completo": "",
      "nome_atual": "",
      "cpf": "",
      "nome_habilitação": "",
      "nome_após_casamento": "",
      "data_nascimento": {
        "dia": "",
        "mês": "",
        "ano": ""
      },
      "nacionalidade": "",
      "estado_civil": "",
      "estado_civil_código": "",
      "município_naturalidade": "",
      "uf_naturalidade": "",
      "genitores": "",
      "profissão": "",
      "domicílio": ""
    },
    "casamento": {
      "tipo": "",
      "data_celebração": {
        "texto_completo": "",
        "dia": "",
        "mês": "",
        "ano": ""
      },
      "local_celebração": "",
      "celebrante": "",
      "documentos_apresentados": "",
      "regime_bens": "",
      "regime_bens_código": "",
      "data_registro": {
        "texto_completo": "",
        "dia": "",
        "mês": "",
        "ano": ""
      }
    },
    "observações": {
      "averbações_anotações": "",
      "anotações_cadastro": "",
      "outras_informações": ""
    },
    "inteiro_teor": {
      "texto": ""
    },
    "cartório": {
      "nome": "",
      "cns": "",
      "município": "",
      "uf": "",
      "endereço": "",
      "telefone": "",
      "email": ""
    },
    "autenticação": {
      "selo_digital": "",
      "consulta_autenticidade": "",
      "oficial_registro": "",
      "assinante": "",
      "cargo_assinante": "",
      "data_emissão": "",
      "número_papel": ""
    }
  },
  "creditsCharged": 0
}

json

{
  "success": false,
  "processingTimeMs": 2410,
  "error": "The image shows a birth certificate, which this endpoint does not read. Send it to POST /documents/birth-certificate. No credit was charged.",
  "errorCode": "DOCUMENT_NOT_RECOGNIZED",
  "data": {
    "documento": {
      "tipo": "Certidão de Casamento",
      "título": "",
      "forma": ""
    },
    "registro": {
      "matrícula": "",
      "livro": "",
      "folha": "",
      "termo": ""
    },
    "cônjuge_1": {
      "nome_completo": "",
      "nome_atual": "",
      "cpf": "",
      "nome_habilitação": "",
      "nome_após_casamento": "",
      "data_nascimento": {
        "dia": "",
        "mês": "",
        "ano": ""
      },
      "nacionalidade": "",
      "estado_civil": "",
      "estado_civil_código": "",
      "município_naturalidade": "",
      "uf_naturalidade": "",
      "genitores": "",
      "profissão": "",
      "domicílio": ""
    },
    "cônjuge_2": {
      "nome_completo": "",
      "nome_atual": "",
      "cpf": "",
      "nome_habilitação": "",
      "nome_após_casamento": "",
      "data_nascimento": {
        "dia": "",
        "mês": "",
        "ano": ""
      },
      "nacionalidade": "",
      "estado_civil": "",
      "estado_civil_código": "",
      "município_naturalidade": "",
      "uf_naturalidade": "",
      "genitores": "",
      "profissão": "",
      "domicílio": ""
    },
    "casamento": {
      "tipo": "",
      "data_celebração": {
        "texto_completo": "",
        "dia": "",
        "mês": "",
        "ano": ""
      },
      "local_celebração": "",
      "celebrante": "",
      "documentos_apresentados": "",
      "regime_bens": "",
      "regime_bens_código": "",
      "data_registro": {
        "texto_completo": "",
        "dia": "",
        "mês": "",
        "ano": ""
      }
    },
    "observações": {
      "averbações_anotações": "",
      "anotações_cadastro": "",
      "outras_informações": ""
    },
    "inteiro_teor": {
      "texto": ""
    },
    "cartório": {
      "nome": "",
      "cns": "",
      "município": "",
      "uf": "",
      "endereço": "",
      "telefone": "",
      "email": ""
    },
    "autenticação": {
      "selo_digital": "",
      "consulta_autenticidade": "",
      "oficial_registro": "",
      "assinante": "",
      "cargo_assinante": "",
      "data_emissão": "",
      "número_papel": ""
    }
  },
  "creditsCharged": 0
}

400 Bad Request

O corpo não é válido: message lista o que corrigir. Nada foi cobrado.

Campos da resposta

statusCode number
Código de status HTTP (sempre 400)
message string[]
O que corrigir, uma linha por problema
error string
Categoria do erro

Um campo está ausente ou errado

json

{
  "message": [
    "imageUrl is required when imageType is \"url\"",
    "requestId may only contain letters, digits, _, -, . and : (up to 128 characters)"
  ],
  "error": "Bad Request",
  "statusCode": 400
}

401 Unauthorized

A chave de API está ausente, malformada, é desconhecida, foi revogada ou expirou.

Campos da resposta

error string
Categoria do erro (sempre Unauthorized)
message string
O que há de errado com a chave. Gerenciar chaves de API
timestamp string
Quando a requisição foi recusada, em UTC

Uma chave desconhecida, revogada ou expiradaSem chave

json

{
  "error": "Unauthorized",
  "message": "Invalid or expired API key",
  "timestamp": "2026-10-02T12:00:00.000Z"
}

json

{
  "error": "Unauthorized",
  "message": "API key is required. Provide Authorization: Bearer <your-api-key>",
  "timestamp": "2026-10-02T12:00:00.000Z"
}

402 Payment Required

Créditos insuficientes para esta requisição (errorCode NOT_ENOUGH_CREDITS). Uma requisição reserva o seu preço enquanto roda: o preço do motor (veja GET /documents/prices), mais o do redimensionamento com resizeImage: true. message traz o preço e o saldo; envie Accept-Language: pt-BR para recebê-la em português. A repetição de uma requisição respondida nos últimos 15 minutos não precisa de créditos.

Campos da resposta

statusCode number
Código de status HTTP (sempre 402)
message string
O preço da requisição e o saldo, com o que fazer. Envie Accept-Language: pt-BR para recebê-la em português.
error string
Categoria do erro
errorCode string
Sempre NOT_ENOUGH_CREDITS
action string
O que fazer: comprar créditos ou mudar de plano
creditsAvailable number
Créditos que a organização pode usar agora, ao centésimo
creditsRequired number
O preço da requisição, que ela reserva enquanto roda
planCreditsRemaining number
Créditos restantes da franquia mensal do plano
purchasedCreditsRemaining number
Créditos restantes de compras

O saldo não paga a requisição

json

{
  "statusCode": 402,
  "message": "This request costs 1.5 credits, and the available balance is 0 credits. Buy credits or upgrade your plan to continue.",
  "error": "Payment Required",
  "errorCode": "NOT_ENOUGH_CREDITS",
  "action": "purchase_credits",
  "creditsAvailable": 0,
  "creditsRequired": 1.5,
  "planCreditsRemaining": 0,
  "purchasedCreditsRemaining": 0
}

409 Conflict

Uma requisição com o mesmo requestId, arquivo e opções ainda está rodando (errorCode REQUEST_IN_PROGRESS). Nada rodou e nada foi cobrado. Aguarde os segundos do Retry-After e envie de novo: você recebe a resposta sem custo.

Retry-After header
Segundos para aguardar antes de enviar de novo, como retryAfter

Campos da resposta

statusCode number
Código de status HTTP (sempre 409)
message string
O que fazer — legível
error string
Categoria do erro
errorCode string
Sempre REQUEST_IN_PROGRESS
retryAfter number
Segundos para aguardar antes de enviar a requisição de novo

A mesma requisição ainda está rodando

json

{
  "statusCode": 409,
  "message": "A request with this requestId and the same content is still being processed. Try again in a few seconds to get its answer, at no charge.",
  "error": "Conflict",
  "errorCode": "REQUEST_IN_PROGRESS",
  "retryAfter": 5
}

413 Payload Too Large

O corpo da requisição passa de 15 MB: errorCode IMAGE_TOO_LARGE. Nada foi cobrado.

Campos da resposta

success boolean
Sempre false
errorCode string
Sempre IMAGE_TOO_LARGE
error string
O que enviar no lugar. Accept-Language: pt-BR a traz em português.
processingTimeMs number
Sempre 0: nada foi processado

O corpo passa do limite

json

{
  "success": false,
  "errorCode": "IMAGE_TOO_LARGE",
  "error": "The image is larger than 10 MB. Send a smaller image, for example a JPG with lower resolution or quality.",
  "processingTimeMs": 0
}

422 Unprocessable Entity

A imagem não pode ser usada, ou a imageUrl não pôde ser baixada. success é false, errorCode informa o problema (por exemplo IMAGE_TOO_LARGE, IMAGE_FORMAT_UNSUPPORTED, IMAGE_RESOLUTION_TOO_LOW, IMAGE_DOWNLOAD_FAILED) e error o explica em palavras simples, com o que corrigir. Envie PDF*, JPG, PNG, WebP ou GIF, com até 10 MB, dentro do nosso padrão de 1344 a 2048 px no lado maior. *Lemos apenas a primeira página do PDF. Uma requisição recusada não custa nada. Envie Accept-Language: pt-BR para receber a mensagem em português.

Campos da resposta

success boolean
true se a extração foi bem-sucedida. Verifique o campo error se false.
error string
O que deu errado. Presente apenas quando success é false.
errorCode "IMAGE_MISSING" ou "IMAGE_BASE64_INVALID" ou "IMAGE_TOO_LARGE" ou "IMAGE_TOO_MANY_PIXELS" ou "IMAGE_FORMAT_UNSUPPORTED" ou "IMAGE_UNREADABLE" ou "IMAGE_URL_NOT_ALLOWED" ou "IMAGE_RESOLUTION_TOO_LOW" ou "IMAGE_RESOLUTION_TOO_HIGH" ou "IMAGE_INVALID" ou "PDF_PASSWORD_PROTECTED" ou "PDF_UNREADABLE" ou "PDF_TOO_MANY_PAGES" ou "IMAGE_DOWNLOAD_FAILED" ou "IMAGE_NOT_PROCESSABLE" ou "DOCUMENT_NOT_RECOGNIZED" ou "EXTRACTION_TIMEOUT" ou "EXTRACTION_BUSY" ou "EXTRACTION_UNAVAILABLE"
Por que a extração falhou, como um código que o seu sistema pode tratar. error explica em palavras simples. Presente apenas quando success é false.
processingTimeMs number
Quanto tempo a extração levou, em milissegundos.
warnings objeto[]
Valores de data para conferir no documento. Um valor que não pode estar certo, como um CPF cujos dígitos verificadores não conferem, vem como foi lido, com um aviso aqui; a requisição é cobrada como qualquer outra. Presente apenas quando há um.
warnings[].code "INVALID_CPF"
O que há de errado com o valor, como um código que o seu sistema pode tratar.
warnings[].field string
O campo de data a que se refere, como um caminho com pontos.
warnings[].message string
O que há de errado e o que fazer, em palavras simples.
imageResized boolean
true quando a imagem estava fora do nosso padrão (1344 a 2048 px no lado maior) e foi redimensionada para caber nele, como resizeImage pediu: o preço do redimensionamento se somou ao da extração. Presente apenas quando isso aconteceu.
originalImageSize objeto
Tamanho da imagem como você a enviou, na orientação de exibição. Presente apenas quando imageResized é true.
originalImageSize.width number
Largura, em pixels.
originalImageSize.height number
Altura, em pixels.
finalImageSize objeto
Tamanho da imagem depois de redimensionada ao nosso padrão. Presente apenas quando imageResized é true.
finalImageSize.width number
Largura, em pixels.
finalImageSize.height number
Altura, em pixels.
engine "mini" ou "large" ou "fast"
O motor que respondeu com dados: mini ou large para os motores padrão, ou fast quando a requisição o pediu e o fast respondeu. Presente apenas quando um motor respondeu.
creditsCharged number
Créditos que esta requisição custou, ao centésimo: o preço do motor que respondeu (nunca mais que o do motor que você pediu), mais o redimensionamento. 0 quando nada foi cobrado: uma imagem recusada, nenhum motor conseguiu responder, ou uma repetição respondida com a resposta guardada (Idempotent-Replayed: true).
data objeto
Dados extraídos da certidão. Todos os campos de uma certidão de casamento, vazios onde a certidão não imprime nada. Quando success é false, todos os campos vêm vazios, menos o tipo do documento.

IMAGE_RESOLUTION_TOO_LOW: uma imagem abaixo do nosso padrão, sem resizeImageIMAGE_DOWNLOAD_FAILED: o link respondeu 404IMAGE_FORMAT_UNSUPPORTED: não é uma imagem que lemos

json

{
  "success": false,
  "processingTimeMs": 35,
  "error": "The image has 800 px on its long side; our standard is 1,344 to 2,048 px. Send a photo with more resolution, or set resizeImage: true to have it enlarged, at the resize's price.",
  "errorCode": "IMAGE_RESOLUTION_TOO_LOW",
  "data": {
    "documento": {
      "tipo": "Certidão de Casamento",
      "título": "",
      "forma": ""
    },
    "registro": {
      "matrícula": "",
      "livro": "",
      "folha": "",
      "termo": ""
    },
    "cônjuge_1": {
      "nome_completo": "",
      "nome_atual": "",
      "cpf": "",
      "nome_habilitação": "",
      "nome_após_casamento": "",
      "data_nascimento": {
        "dia": "",
        "mês": "",
        "ano": ""
      },
      "nacionalidade": "",
      "estado_civil": "",
      "estado_civil_código": "",
      "município_naturalidade": "",
      "uf_naturalidade": "",
      "genitores": "",
      "profissão": "",
      "domicílio": ""
    },
    "cônjuge_2": {
      "nome_completo": "",
      "nome_atual": "",
      "cpf": "",
      "nome_habilitação": "",
      "nome_após_casamento": "",
      "data_nascimento": {
        "dia": "",
        "mês": "",
        "ano": ""
      },
      "nacionalidade": "",
      "estado_civil": "",
      "estado_civil_código": "",
      "município_naturalidade": "",
      "uf_naturalidade": "",
      "genitores": "",
      "profissão": "",
      "domicílio": ""
    },
    "casamento": {
      "tipo": "",
      "data_celebração": {
        "texto_completo": "",
        "dia": "",
        "mês": "",
        "ano": ""
      },
      "local_celebração": "",
      "celebrante": "",
      "documentos_apresentados": "",
      "regime_bens": "",
      "regime_bens_código": "",
      "data_registro": {
        "texto_completo": "",
        "dia": "",
        "mês": "",
        "ano": ""
      }
    },
    "observações": {
      "averbações_anotações": "",
      "anotações_cadastro": "",
      "outras_informações": ""
    },
    "inteiro_teor": {
      "texto": ""
    },
    "cartório": {
      "nome": "",
      "cns": "",
      "município": "",
      "uf": "",
      "endereço": "",
      "telefone": "",
      "email": ""
    },
    "autenticação": {
      "selo_digital": "",
      "consulta_autenticidade": "",
      "oficial_registro": "",
      "assinante": "",
      "cargo_assinante": "",
      "data_emissão": "",
      "número_papel": ""
    }
  },
  "creditsCharged": 0
}

json

{
  "success": false,
  "processingTimeMs": 410,
  "error": "We could not download the image from imageUrl: the link answered HTTP 404 (file not found). Use a public, direct link to a PDF, JPG, PNG, WebP or GIF file that opens without a login, or send the image as imageBase64.",
  "errorCode": "IMAGE_DOWNLOAD_FAILED",
  "data": {
    "documento": {
      "tipo": "Certidão de Casamento",
      "título": "",
      "forma": ""
    },
    "registro": {
      "matrícula": "",
      "livro": "",
      "folha": "",
      "termo": ""
    },
    "cônjuge_1": {
      "nome_completo": "",
      "nome_atual": "",
      "cpf": "",
      "nome_habilitação": "",
      "nome_após_casamento": "",
      "data_nascimento": {
        "dia": "",
        "mês": "",
        "ano": ""
      },
      "nacionalidade": "",
      "estado_civil": "",
      "estado_civil_código": "",
      "município_naturalidade": "",
      "uf_naturalidade": "",
      "genitores": "",
      "profissão": "",
      "domicílio": ""
    },
    "cônjuge_2": {
      "nome_completo": "",
      "nome_atual": "",
      "cpf": "",
      "nome_habilitação": "",
      "nome_após_casamento": "",
      "data_nascimento": {
        "dia": "",
        "mês": "",
        "ano": ""
      },
      "nacionalidade": "",
      "estado_civil": "",
      "estado_civil_código": "",
      "município_naturalidade": "",
      "uf_naturalidade": "",
      "genitores": "",
      "profissão": "",
      "domicílio": ""
    },
    "casamento": {
      "tipo": "",
      "data_celebração": {
        "texto_completo": "",
        "dia": "",
        "mês": "",
        "ano": ""
      },
      "local_celebração": "",
      "celebrante": "",
      "documentos_apresentados": "",
      "regime_bens": "",
      "regime_bens_código": "",
      "data_registro": {
        "texto_completo": "",
        "dia": "",
        "mês": "",
        "ano": ""
      }
    },
    "observações": {
      "averbações_anotações": "",
      "anotações_cadastro": "",
      "outras_informações": ""
    },
    "inteiro_teor": {
      "texto": ""
    },
    "cartório": {
      "nome": "",
      "cns": "",
      "município": "",
      "uf": "",
      "endereço": "",
      "telefone": "",
      "email": ""
    },
    "autenticação": {
      "selo_digital": "",
      "consulta_autenticidade": "",
      "oficial_registro": "",
      "assinante": "",
      "cargo_assinante": "",
      "data_emissão": "",
      "número_papel": ""
    }
  },
  "creditsCharged": 0
}

json

{
  "success": false,
  "processingTimeMs": 35,
  "error": "The file is not in one of these formats: PDF, JPG, PNG, WebP or GIF. Convert it to one of them and send it again.",
  "errorCode": "IMAGE_FORMAT_UNSUPPORTED",
  "data": {
    "documento": {
      "tipo": "Certidão de Casamento",
      "título": "",
      "forma": ""
    },
    "registro": {
      "matrícula": "",
      "livro": "",
      "folha": "",
      "termo": ""
    },
    "cônjuge_1": {
      "nome_completo": "",
      "nome_atual": "",
      "cpf": "",
      "nome_habilitação": "",
      "nome_após_casamento": "",
      "data_nascimento": {
        "dia": "",
        "mês": "",
        "ano": ""
      },
      "nacionalidade": "",
      "estado_civil": "",
      "estado_civil_código": "",
      "município_naturalidade": "",
      "uf_naturalidade": "",
      "genitores": "",
      "profissão": "",
      "domicílio": ""
    },
    "cônjuge_2": {
      "nome_completo": "",
      "nome_atual": "",
      "cpf": "",
      "nome_habilitação": "",
      "nome_após_casamento": "",
      "data_nascimento": {
        "dia": "",
        "mês": "",
        "ano": ""
      },
      "nacionalidade": "",
      "estado_civil": "",
      "estado_civil_código": "",
      "município_naturalidade": "",
      "uf_naturalidade": "",
      "genitores": "",
      "profissão": "",
      "domicílio": ""
    },
    "casamento": {
      "tipo": "",
      "data_celebração": {
        "texto_completo": "",
        "dia": "",
        "mês": "",
        "ano": ""
      },
      "local_celebração": "",
      "celebrante": "",
      "documentos_apresentados": "",
      "regime_bens": "",
      "regime_bens_código": "",
      "data_registro": {
        "texto_completo": "",
        "dia": "",
        "mês": "",
        "ano": ""
      }
    },
    "observações": {
      "averbações_anotações": "",
      "anotações_cadastro": "",
      "outras_informações": ""
    },
    "inteiro_teor": {
      "texto": ""
    },
    "cartório": {
      "nome": "",
      "cns": "",
      "município": "",
      "uf": "",
      "endereço": "",
      "telefone": "",
      "email": ""
    },
    "autenticação": {
      "selo_digital": "",
      "consulta_autenticidade": "",
      "oficial_registro": "",
      "assinante": "",
      "cargo_assinante": "",
      "data_emissão": "",
      "número_papel": ""
    }
  },
  "creditsCharged": 0
}

429 Too Many Requests

Acima de um dos limites do seu plano. retryAfter diz quantos segundos aguardar; não há header Retry-After. Um limite por dia volta à meia-noite UTC.

Campos da resposta

statusCode number
Código de status HTTP (sempre 429)
message string
Qual limite foi atingido, e o seu tamanho. Ver uso
error string
Categoria do erro
retryAfter number
Segundos para aguardar antes de enviar a requisição de novo. Um limite por dia dura até a meia-noite UTC, então a espera pode ser de horas.

Requisições demais neste minutoO limite do dia foi atingido: ele volta à meia-noite UTC

json

{
  "statusCode": 429,
  "message": "Organization rate limit exceeded (10 requests per minute). Retry after 6 seconds.",
  "error": "Too Many Requests",
  "retryAfter": 6
}

json

{
  "statusCode": 429,
  "message": "Daily quota exceeded (1000 requests per day). Current usage: 1000",
  "error": "Too Many Requests",
  "retryAfter": 43200
}

503 Service Unavailable

O serviço está reiniciando: o proxy responde com uma página HTML, e pode responder 502 ou 504 da mesma forma. Envie a mesma requisição de novo depois de alguns segundos, com o mesmo requestId, para nunca pagar duas vezes.

503

html

<html>
<head><title>503 Service Temporarily Unavailable</title></head>
<body>
<center><h1>503 Service Temporarily Unavailable</h1></center>
<hr><center>nginx</center>
</body>
</html>

Valores de errorCode

O errorCode de uma resposta sem dados diz por quê, como um código que o seu sistema pode tratar. Os valores desta operação:

IMAGE_MISSING
IMAGE_BASE64_INVALID
IMAGE_TOO_LARGE
IMAGE_TOO_MANY_PIXELS
IMAGE_FORMAT_UNSUPPORTED
IMAGE_UNREADABLE
IMAGE_URL_NOT_ALLOWED
IMAGE_RESOLUTION_TOO_LOW
IMAGE_RESOLUTION_TOO_HIGH
IMAGE_INVALID
PDF_PASSWORD_PROTECTED
PDF_UNREADABLE
PDF_TOO_MANY_PAGES
IMAGE_DOWNLOAD_FAILED
IMAGE_NOT_PROCESSABLE
DOCUMENT_NOT_RECOGNIZED
EXTRACTION_TIMEOUT
EXTRACTION_BUSY
EXTRACTION_UNAVAILABLE
NOT_ENOUGH_CREDITS
REQUEST_IN_PROGRESS

bash

#!/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

python

"""Extract the hosted sample marriage certificate (fictitious data).

Needs the requests package and DOCSOCR_API_KEY in the environment.
"""
import os
import uuid

import requests

response = requests.post(
    "https://api.docsocr.com/api/v1/documents/marriage-certificate",
    headers={"Authorization": f"Bearer {os.environ['DOCSOCR_API_KEY']}"},
    json={
        "imageType": "url",
        "imageUrl": "https://docsocr.com/samples/certidao-casamento-exemplo.jpg",
        "requestId": str(uuid.uuid4()),  # one id per document
    },
    timeout=120,  # above the API's 90 s extraction budget
)
answer = response.json()
if response.status_code != 201 or not answer["success"]:
    raise SystemExit(f"{response.status_code} {answer.get('errorCode', '')} {answer.get('message') or answer.get('error')}")
# The spouses in the order the certificate prints them
print(answer["data"]["cônjuge_1"]["nome_completo"])
print(answer["data"]["cônjuge_2"]["nome_completo"])

// Extract the hosted sample marriage certificate (fictitious data).
// Needs Node.js 18+ and DOCSOCR_API_KEY in the environment.
import { randomUUID } from 'node:crypto'

const response = await fetch('https://api.docsocr.com/api/v1/documents/marriage-certificate', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DOCSOCR_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    imageType: 'url',
    imageUrl: 'https://docsocr.com/samples/certidao-casamento-exemplo.jpg',
    requestId: randomUUID(), // one id per document
  }),
  signal: AbortSignal.timeout(120_000), // above the API's 90 s extraction budget
})
const answer = await response.json()
if (response.status !== 201 || !answer.success) {
  console.error(response.status, answer.errorCode ?? '', answer.message ?? answer.error)
  process.exit(1)
}
// The spouses in the order the certificate prints them
console.log(answer.data['cônjuge_1'].nome_completo)
console.log(answer.data['cônjuge_2'].nome_completo)

php

<?php
// Extract the hosted sample marriage certificate (fictitious data).
// Needs the curl extension and DOCSOCR_API_KEY in the environment.

$request = curl_init('https://api.docsocr.com/api/v1/documents/marriage-certificate');
curl_setopt_array($request, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 120, // above the API's 90 s extraction budget
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('DOCSOCR_API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'imageType' => 'url',
        'imageUrl' => 'https://docsocr.com/samples/certidao-casamento-exemplo.jpg',
        'requestId' => bin2hex(random_bytes(16)), // one id per document
    ]),
]);
$body = curl_exec($request);
if ($body === false) {
    fwrite(STDERR, curl_error($request) . PHP_EOL);
    exit(1);
}
$status = curl_getinfo($request, CURLINFO_RESPONSE_CODE);
$answer = json_decode($body, true);
if ($status !== 201 || empty($answer['success'])) {
    fwrite(STDERR, "$status " . ($answer['errorCode'] ?? '') . ' ' . implode('; ', (array) ($answer['message'] ?? $answer['error'] ?? '')) . PHP_EOL);
    exit(1);
}
// The spouses in the order the certificate prints them
echo $answer['data']['cônjuge_1']['nome_completo'], PHP_EOL;
echo $answer['data']['cônjuge_2']['nome_completo'], PHP_EOL;

java

// Extract the hosted sample marriage certificate (fictitious data).
// Needs Java 17+ and DOCSOCR_API_KEY in the environment. Run: java MarriageCertificate.java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;
import java.util.UUID;

public class MarriageCertificate {
    public static void main(String[] args) throws Exception {
        String body = """
            {
              "imageType": "url",
              "imageUrl": "https://docsocr.com/samples/certidao-casamento-exemplo.jpg",
              "requestId": "%s"
            }""".formatted(UUID.randomUUID()); // one id per document

        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.docsocr.com/api/v1/documents/marriage-certificate"))
            .timeout(Duration.ofSeconds(120)) // above the API's 90 s extraction budget
            .header("Authorization", "Bearer " + System.getenv("DOCSOCR_API_KEY"))
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(body))
            .build();
        HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());

        // The answer is JSON: read data.cônjuge_1 and data.cônjuge_2 with your JSON library
        System.out.println(response.body());
        if (response.statusCode() != 201 || !response.body().contains("\"success\":true")) {
            System.exit(1);
        }
    }
}

csharp

// Extract the hosted sample marriage certificate (fictitious data).
// Needs .NET 8+ and DOCSOCR_API_KEY in the environment. Run: dotnet run MarriageCertificate.cs (.NET 10)
using System.Net.Http.Headers;
using System.Text;
using System.Text.Json;
using System.Text.Json.Nodes;

using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(120) }; // above the API's 90 s extraction budget
http.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("DOCSOCR_API_KEY"));

var body = new JsonObject
{
    ["imageType"] = "url",
    ["imageUrl"] = "https://docsocr.com/samples/certidao-casamento-exemplo.jpg",
    ["requestId"] = Guid.NewGuid().ToString(), // one id per document
};
using var content = new StringContent(body.ToJsonString(), Encoding.UTF8, "application/json");
using var response = await http.PostAsync("https://api.docsocr.com/api/v1/documents/marriage-certificate", content);
using var answer = JsonDocument.Parse(await response.Content.ReadAsStringAsync());
var root = answer.RootElement;

if ((int)response.StatusCode != 201 || !root.GetProperty("success").GetBoolean())
{
    Console.Error.WriteLine($"{(int)response.StatusCode} {root}");
    return 1;
}
// The spouses in the order the certificate prints them
var data = root.GetProperty("data");
Console.WriteLine(data.GetProperty("cônjuge_1").GetProperty("nome_completo").GetString());
Console.WriteLine(data.GetProperty("cônjuge_2").GetProperty("nome_completo").GetString());
return 0;

Testar

Envia esta requisição para a API em produção, com a sua chave.

Chave de API

A chave fica só nesta aba do navegador e vai apenas para a API. Gerar chave no painel

Idioma das mensagens (Accept-Language)

Corpo (JSON)

Lendo os preços…

Cole a sua chave de API para enviar.

Resposta 201

json

{
  "success": true,
  "processingTimeMs": 7480,
  "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
}

Extrair dados de uma certidão de casamento ​

Autenticação ​

Parâmetros ​

Corpo da requisição ​

Exemplos ​

Respostas ​

201 Created ​

400 Bad Request ​

401 Unauthorized ​

402 Payment Required ​

409 Conflict ​

413 Payload Too Large ​

422 Unprocessable Entity ​

429 Too Many Requests ​

503 Service Unavailable ​

Valores de errorCode ​

Testar

Extrair dados de uma certidão de casamento

Autenticação

Parâmetros

Corpo da requisição

Exemplos

Respostas

201 Created

400 Bad Request

401 Unauthorized

402 Payment Required

409 Conflict

413 Payload Too Large

422 Unprocessable Entity

429 Too Many Requests

503 Service Unavailable

Valores de errorCode