🚧
What's New in bizAPIs 3.0
Enhanced Error Responses with bizAPIs Status Codes
bizAPIs 3.0 introduces structured error responses with dedicated bizAPIs status codes, making debugging faster and support interactions more efficient. All error responses now include detailed metadata like requestId, errorCode, and errorName to help you quickly identify and resolve issues.
Availability by Environment
Environment Status
📚 Documentation ⏳ Coming Soon
🧪 QUAL ⏳ Coming Soon
🚀 Production ⏳ Coming Soon
Learn more about error handling →

Download Project

Watch the video

JSON Schema API Response

Portuguese (PT)

Anexo A — Standard SNC entities: {
    "type": "object",
    "properties": {
        "data": {
            "type": "object",
            "properties": {
                "anexoA": {
                    "type": "object",
                    "properties": {
                        "q0101_nif": {
                            "type": "integer",
                            "description": "NIF da entidade."
                        },
                        "q0102_exercicio": {
                            "type": "string",
                            "description": "Ano do exercício fiscal."
                        },
                        "q03_A5001": {
                            "type": "number",
                            "description": "Vendas e serviços prestados."
                        },
                        "q03_A5002": {
                            "type": "number",
                            "description": "Subsídios à exploração."
                        },
                        "q03_A5003": {
                            "type": "number",
                            "description": "Ganhos/perdas imputadas de subsidiárias e empreendimentos conjuntos."
                        },
                        "q03_A5004": {
                            "type": "number",
                            "description": "Variação nos inventários da produção."
                        },
                        "q03_A5005": {
                            "type": "number",
                            "description": "Trabalhos para a própria entidade."
                        },
                        "q03_A5006": {
                            "type": "number",
                            "description": "Custos das mercadorias vendidas e das matérias consumidas."
                        },
                        "q03_A5007": {
                            "type": "number",
                            "description": "Fornecimentos e serviços externos."
                        },
                        "q03_A5008": {
                            "type": "number",
                            "description": "Gastos com o pessoal."
                        },
                        "q03_A5009": {
                            "type": "number",
                            "description": "Imparidade de inventários (perdas/reversões)."
                        },
                        "q03_A5010": {
                            "type": "number",
                            "description": "Imparidade de dívidas a receber (perdas/reversões)."
                        },
                        "q03_A5011": {
                            "type": "number",
                            "description": "Provisões (aumentos/reduções)."
                        },
                        "q03_A5012": {
                            "type": "number",
                            "description": "Imparidade de investimentos não depreciáveis/amortizáveis (perdas/reversões)."
                        },
                        "q03_A5013": {
                            "type": "number",
                            "description": "Outras imparidades (perdas/reversões)."
                        },
                        "q03_A5014": {
                            "type": "number",
                            "description": "Aumentos/reduções de justo valor."
                        },
                        "q03_A5015": {
                            "type": "number",
                            "description": "Outros rendimentos e ganhos."
                        },
                        "q03_A5016": {
                            "type": "number",
                            "description": "Outros gastos e perdas."
                        },
                        "q03_A5017": {
                            "type": "number",
                            "description": "Resultado antes de depreciações, gastos de financiamento e impostos."
                        },
                        "q03_A5018": {
                            "type": "number",
                            "description": "Gastos/reversões de depreciação e de amortização."
                        },
                        "q03_A5019": {
                            "type": "number",
                            "description": "Imparidade de investimentos depreciáveis/amortizáveis (perdas/reversões)."
                        },
                        "q03_A5020": {
                            "type": "number",
                            "description": "Resultado operacional (antes de gastos de financiamento e impostos)."
                        },
                        "q03_A5021": {
                            "type": "number",
                            "description": "Juros e rendimentos similares obtidos."
                        },
                        "q03_A5022": {
                            "type": "number",
                            "description": "Juros e gastos similares suportados."
                        },
                        "q03_A5023": {
                            "type": "number",
                            "description": "Resultado antes de impostos."
                        },
                        "q03_A5024": {
                            "type": "number",
                            "description": "Imposto sobre o rendimento do período."
                        },
                        "q03_A5025": {
                            "type": "number",
                            "description": "Resultado líquido do período."
                        },
                        "q03_A5026": {
                            "type": "number",
                            "description": "Resultado das atividades descontinuadas (líquido de impostos)."
                        },
                        "q04_A5101": {
                            "type": "number",
                            "description": "Ativos fixos tangíveis."
                        },
                        "q04_A5102": {
                            "type": "number",
                            "description": "Propriedades de investimento."
                        },
                        "q04_A5103": {
                            "type": "number",
                            "description": "Goodwill."
                        },
                        "q04_A5104": {
                            "type": "number",
                            "description": "Ativos intangíveis."
                        },
                        "q04_A5105": {
                            "type": "number",
                            "description": "Ativos biológicos."
                        },
                        "q04_A5106": {
                            "type": "number",
                            "description": "Participações financeiras - equivalência patrimonial."
                        },
                        "q04_A5107": {
                            "type": "number",
                            "description": "Participações financeiras - outros métodos."
                        },
                        "q04_A5108": {
                            "type": "number",
                            "description": "Acionistas / sócios (ativo não corrente)."
                        },
                        "q04_A5109": {
                            "type": "number",
                            "description": "Outros ativos financeiros."
                        },
                        "q04_A5110": {
                            "type": "number",
                            "description": "Ativos por impostos diferidos."
                        },
                        "q04_A5111": {
                            "type": "number",
                            "description": "Investimentos financeiros (micro/pequenas entidades)."
                        },
                        "q04_A5112": {
                            "type": "number",
                            "description": "Soma (ativo não corrente)."
                        },
                        "q04_A5113": {
                            "type": "number",
                            "description": "Inventários."
                        },
                        "q04_A5114": {
                            "type": "number",
                            "description": "Ativos biológicos (corrente)."
                        },
                        "q04_A5115": {
                            "type": "number",
                            "description": "Clientes."
                        },
                        "q04_A5116": {
                            "type": "number",
                            "description": "Adiantamentos a fornecedores."
                        },
                        "q04_A5117": {
                            "type": "number",
                            "description": "Estado e outros entes públicos."
                        },
                        "q04_A5118": {
                            "type": "number",
                            "description": "Acionistas / sócios (ativo corrente)."
                        },
                        "q04_A5119": {
                            "type": "number",
                            "description": "Outras contas a receber."
                        },
                        "q04_A5120": {
                            "type": "number",
                            "description": "Diferimentos."
                        },
                        "q04_A5121": {
                            "type": "number",
                            "description": "Ativos financeiros detidos para negociação."
                        },
                        "q04_A5122": {
                            "type": "number",
                            "description": "Outros ativos financeiros (corrente)."
                        },
                        "q04_A5123": {
                            "type": "number",
                            "description": "Ativos não correntes detidos para venda."
                        },
                        "q04_A5124": {
                            "type": "number",
                            "description": "Outros ativos correntes."
                        },
                        "q04_A5125": {
                            "type": "number",
                            "description": "Caixa e depósitos bancários."
                        },
                        "q04_A5126": {
                            "type": "number",
                            "description": "Soma (ativo corrente)."
                        },
                        "q04_A5127": {
                            "type": "number",
                            "description": "Total do Ativo."
                        },
                        "q04_A5128": {
                            "type": "number",
                            "description": "Capital realizado."
                        },
                        "q04_A5129": {
                            "type": "number",
                            "description": "Ações (quotas) próprias."
                        },
                        "q04_A5130": {
                            "type": "number",
                            "description": "Outros instrumentos de capital próprio."
                        },
                        "q04_A5131": {
                            "type": "number",
                            "description": "Prémios de emissão."
                        },
                        "q04_A5132": {
                            "type": "number",
                            "description": "Reservas legais."
                        },
                        "q04_A5133": {
                            "type": "number",
                            "description": "Outras reservas."
                        },
                        "q04_A5134": {
                            "type": "number",
                            "description": "Resultados transitados."
                        },
                        "q04_A5135": {
                            "type": "number",
                            "description": "Ajustamentos em ativos financeiros."
                        },
                        "q04_A5136": {
                            "type": "number",
                            "description": "Excedentes de revalorização."
                        },
                        "q04_A5137": {
                            "type": "number",
                            "description": "Outras variações no capital próprio."
                        },
                        "q04_A5138": {
                            "type": "number",
                            "description": "Soma (capital próprio)."
                        },
                        "q04_A5139": {
                            "type": "number",
                            "description": "Resultado líquido do período."
                        },
                        "q04_A5140": {
                            "type": "number",
                            "description": "Dividendos antecipados."
                        },
                        "q04_A5141": {
                            "type": "number",
                            "description": "Total do capital próprio."
                        },
                        "q04_A5142": {
                            "type": "number",
                            "description": "Provisões."
                        },
                        "q04_A5143": {
                            "type": "number",
                            "description": "Financiamentos obtidos (não corrente)."
                        },
                        "q04_A5144": {
                            "type": "number",
                            "description": "Responsabilidades por benefícios pós-emprego."
                        },
                        "q04_A5145": {
                            "type": "number",
                            "description": "Passivos por impostos diferidos."
                        },
                        "q04_A5146": {
                            "type": "number",
                            "description": "Outras contas a pagar (não corrente)."
                        },
                        "q04_A5147": {
                            "type": "number",
                            "description": "Soma (passivo não corrente)."
                        },
                        "q04_A5148": {
                            "type": "number",
                            "description": "Fornecedores."
                        },
                        "q04_A5149": {
                            "type": "number",
                            "description": "Adiantamentos de clientes."
                        },
                        "q04_A5150": {
                            "type": "number",
                            "description": "Estado e outros entes públicos."
                        },
                        "q04_A5151": {
                            "type": "number",
                            "description": "Acionistas / sócios (passivo)."
                        },
                        "q04_A5152": {
                            "type": "number",
                            "description": "Financiamentos obtidos (corrente)."
                        },
                        "q04_A5153": {
                            "type": "number",
                            "description": "Outras contas a pagar (corrente)."
                        },
                        "q04_A5154": {
                            "type": "number",
                            "description": "Diferimentos."
                        },
                        "q04_A5155": {
                            "type": "number",
                            "description": "Passivos financeiros detidos para negociação."
                        },
                        "q04_A5156": {
                            "type": "number",
                            "description": "Outros passivos financeiros."
                        },
                        "q04_A5157": {
                            "type": "number",
                            "description": "Passivos não correntes detidos para venda."
                        },
                        "q04_A5158": {
                            "type": "number",
                            "description": "Outros passivos correntes."
                        },
                        "q04_A5159": {
                            "type": "number",
                            "description": "Soma (passivo corrente)."
                        },
                        "q04_A5160": {
                            "type": "number",
                            "description": "Total do Passivo."
                        },
                        "q04_A5161": {
                            "type": "number",
                            "description": "Total do Passivo e Capital Próprio."
                        },
                        "q05291_A6012": {
                            "type": "integer",
                            "description": "Pessoas ao serviço (remuneradas e não remuneradas)."
                        },
                        "q05291_A6013": {
                            "type": "integer",
                            "description": "Pessoas remuneradas."
                        },
                        "q05291_A6014": {
                            "type": "integer",
                            "description": "Pessoas não remuneradas."
                        },
                        "q05291_A6015": {
                            "type": "integer",
                            "description": "Pessoas a tempo completo."
                        },
                        "q05291_A6016": {
                            "type": "integer",
                            "description": "Pessoas remuneradas a tempo completo."
                        },
                        "q05291_A6017": {
                            "type": "integer",
                            "description": "Pessoas a tempo parcial."
                        },
                        "q05291_A6018": {
                            "type": "integer",
                            "description": "Pessoas remuneradas a tempo parcial."
                        },
                        "q05291_A6019": {
                            "type": "integer",
                            "description": "Homens."
                        },
                        "q05291_A6020": {
                            "type": "integer",
                            "description": "Mulheres."
                        },
                        "q05291_A6021": {
                            "type": "integer",
                            "description": "Afetos a I&D."
                        },
                        "q05291_A6022": {
                            "type": "integer",
                            "description": "Prestadores de serviços."
                        },
                        "q05291_A6023": {
                            "type": "integer",
                            "description": "Trabalho temporário."
                        }
                    }
                },
                "rosto": {
                    "type": "object",
                    "properties": {
                        "q01Ano": {
                            "type": "integer",
                            "description": "Ano fiscal."
                        },
                        "q03Name": {
                            "type": "string",
                            "description": "Nome da entidade."
                        },
                        "q03Nif": {
                            "type": "integer",
                            "description": "NIF da entidade."
                        }
                    }
                },
                "requestId": {
                    "type": "string",
                    "description": "Identificador único do pedido."
                }
            }
        }
    }
}

Anexo B — Financial institutions: {
    "type": "object",
    "properties": {
        "data": {
            "type": "object",
            "properties": {
                "anexoB": {
                    "type": "object",
                    "properties": {
                        "q0101_nif": {
                            "type": "integer",
                            "description": "NIF da entidade."
                        },
                        "q0102_exercicio": {
                            "type": "string",
                            "description": "Ano do exercício fiscal."
                        },
                        "q03_B0101": {
                            "type": "number",
                            "description": "Juros e rendimentos similares."
                        },
                        "q03_B0102": {
                            "type": "number",
                            "description": "Juros e encargos similares."
                        },
                        "q03_B0103": {
                            "type": "number",
                            "description": "Margem financeira."
                        },
                        "q03_B0112": {
                            "type": "number",
                            "description": "Produto bancário."
                        },
                        "q03_B0113": {
                            "type": "number",
                            "description": "Custos com o pessoal."
                        },
                        "q03_B0120": {
                            "type": "number",
                            "description": "Resultado antes de impostos."
                        },
                        "q03_B0124": {
                            "type": "number",
                            "description": "Resultado após impostos."
                        },
                        "q04_B0319_bruto": {
                            "type": "number",
                            "description": "Total do Ativo - Bruto."
                        },
                        "q04_B0319_liquido": {
                            "type": "number",
                            "description": "Total do Ativo - Líquido."
                        },
                        "q04_B0335": {
                            "type": "number",
                            "description": "Total do Passivo."
                        },
                        "q04_B0336": {
                            "type": "number",
                            "description": "Capital."
                        },
                        "q04_B0341": {
                            "type": "number",
                            "description": "Outras reservas e resultados transitados."
                        },
                        "q04_B0342": {
                            "type": "number",
                            "description": "Resultado do exercício."
                        },
                        "q04_B0344": {
                            "type": "number",
                            "description": "Total do Capital Próprio."
                        },
                        "q04_B0345": {
                            "type": "number",
                            "description": "Total do Passivo + Capital Próprio."
                        },
                        "q061_B0501": {
                            "type": "integer",
                            "description": "Número médio de pessoas remuneradas."
                        },
                        "q061_B0513": {
                            "type": "integer",
                            "description": "Total horas trabalhadas."
                        },
                        "q061_B0518": {
                            "type": "number",
                            "description": "Remunerações brutas."
                        },
                        "q07_3": {
                            "type": "string",
                            "description": "Data de aprovação de contas (formato: YYYY-MM-DD)."
                        },
                        "q08_19": {
                            "type": "integer",
                            "description": "NIF do ROC/SROC nomeado."
                        }
                    }
                },
                "rosto": {
                    "type": "object",
                    "properties": {
                        "q01Ano": {
                            "type": "integer",
                            "description": "Ano fiscal."
                        },
                        "q03Name": {
                            "type": "string",
                            "description": "Nome da entidade."
                        },
                        "q03Nif": {
                            "type": "integer",
                            "description": "NIF da entidade."
                        }
                    }
                },
                "requestId": {
                    "type": "string",
                    "description": "Identificador único do pedido."
                }
            }
        }
    }
}

Anexo C — Insurance companies: {
    "type": "object",
    "properties": {
        "data": {
            "type": "object",
            "properties": {
                "anexoC": {
                    "type": "object",
                    "properties": {
                        "q0101_nif": {
                            "type": "integer",
                            "description": "NIF da entidade."
                        },
                        "q0102_exercicio": {
                            "type": "string",
                            "description": "Ano do exercício fiscal."
                        },
                        "ativo_C7037_bruto": {
                            "type": "number",
                            "description": "Total Ativo - Valor Bruto."
                        },
                        "ativo_C7037_imparidade": {
                            "type": "number",
                            "description": "Total Ativo - Imparidade/Depreciações."
                        },
                        "ativo_C7037_liquido": {
                            "type": "number",
                            "description": "Total Ativo - Valor Líquido."
                        },
                        "passivo_C7067": {
                            "type": "number",
                            "description": "Total Passivo."
                        },
                        "passivo_C7068": {
                            "type": "number",
                            "description": "Capital."
                        },
                        "passivo_C7088": {
                            "type": "number",
                            "description": "Outras reservas."
                        },
                        "passivo_C7089": {
                            "type": "number",
                            "description": "Resultados transitados."
                        },
                        "passivo_C7090": {
                            "type": "number",
                            "description": "Resultado do exercício."
                        },
                        "passivo_C7092": {
                            "type": "number",
                            "description": "Total Capital Próprio."
                        },
                        "passivo_C7093": {
                            "type": "number",
                            "description": "Total Passivo e Capital Próprio."
                        },
                        "resultado_C7251": {
                            "type": "number",
                            "description": "Réditos de contratos de seguro."
                        },
                        "resultado_C7268": {
                            "type": "number",
                            "description": "Gastos de contratos de seguros."
                        },
                        "resultado_C7312": {
                            "type": "number",
                            "description": "Resultado de contratos de seguro."
                        },
                        "resultado_C7381": {
                            "type": "number",
                            "description": "Resultado líquido antes de impostos."
                        },
                        "resultado_C7384": {
                            "type": "number",
                            "description": "Resultado líquido do período."
                        }
                    }
                },
                "rosto": {
                    "type": "object",
                    "properties": {
                        "q01Ano": {
                            "type": "integer",
                            "description": "Ano fiscal."
                        },
                        "q03Name": {
                            "type": "string",
                            "description": "Nome da entidade."
                        },
                        "q03Nif": {
                            "type": "integer",
                            "description": "NIF da entidade."
                        }
                    }
                },
                "requestId": {
                    "type": "string",
                    "description": "Identificador único do pedido."
                }
            }
        }
    }
}

English (ENG)

Anexo A — Standard SNC entities: {
    "type": "object",
    "properties": {
        "data": {
            "type": "object",
            "properties": {
                "anexoA": {
                    "type": "object",
                    "properties": {
                        "q0101_nif": {
                            "type": "integer",
                            "description": "Entity tax identification number (NIF)."
                        },
                        "q0102_exercicio": {
                            "type": "string",
                            "description": "Fiscal year."
                        },
                        "q03_A5001": {
                            "type": "number",
                            "description": "Sales and services rendered."
                        },
                        "q03_A5002": {
                            "type": "number",
                            "description": "Operating subsidies."
                        },
                        "q03_A5003": {
                            "type": "number",
                            "description": "Gains/losses from subsidiaries and joint ventures."
                        },
                        "q03_A5004": {
                            "type": "number",
                            "description": "Changes in production inventories."
                        },
                        "q03_A5005": {
                            "type": "number",
                            "description": "Work for the entity itself."
                        },
                        "q03_A5006": {
                            "type": "number",
                            "description": "Cost of goods sold and materials consumed."
                        },
                        "q03_A5007": {
                            "type": "number",
                            "description": "External supplies and services."
                        },
                        "q03_A5008": {
                            "type": "number",
                            "description": "Employee expenses."
                        },
                        "q03_A5009": {
                            "type": "number",
                            "description": "Inventory impairment (losses/reversals)."
                        },
                        "q03_A5010": {
                            "type": "number",
                            "description": "Receivables impairment (losses/reversals)."
                        },
                        "q03_A5011": {
                            "type": "number",
                            "description": "Provisions (increases/decreases)."
                        },
                        "q03_A5012": {
                            "type": "number",
                            "description": "Impairment of non-depreciable investments (losses/reversals)."
                        },
                        "q03_A5013": {
                            "type": "number",
                            "description": "Other impairments (losses/reversals)."
                        },
                        "q03_A5014": {
                            "type": "number",
                            "description": "Fair value increases/decreases."
                        },
                        "q03_A5015": {
                            "type": "number",
                            "description": "Other income and gains."
                        },
                        "q03_A5016": {
                            "type": "number",
                            "description": "Other expenses and losses."
                        },
                        "q03_A5017": {
                            "type": "number",
                            "description": "Result before depreciation, financing costs and taxes."
                        },
                        "q03_A5018": {
                            "type": "number",
                            "description": "Depreciation and amortization expenses/reversals."
                        },
                        "q03_A5019": {
                            "type": "number",
                            "description": "Impairment of depreciable investments (losses/reversals)."
                        },
                        "q03_A5020": {
                            "type": "number",
                            "description": "Operating result (before financing costs and taxes)."
                        },
                        "q03_A5021": {
                            "type": "number",
                            "description": "Interest and similar income."
                        },
                        "q03_A5022": {
                            "type": "number",
                            "description": "Interest and similar expenses."
                        },
                        "q03_A5023": {
                            "type": "number",
                            "description": "Result before taxes."
                        },
                        "q03_A5024": {
                            "type": "number",
                            "description": "Income tax for the period."
                        },
                        "q03_A5025": {
                            "type": "number",
                            "description": "Net result for the period."
                        },
                        "q03_A5026": {
                            "type": "number",
                            "description": "Result from discontinued operations (net of taxes)."
                        },
                        "q04_A5101": {
                            "type": "number",
                            "description": "Tangible fixed assets."
                        },
                        "q04_A5102": {
                            "type": "number",
                            "description": "Investment properties."
                        },
                        "q04_A5103": {
                            "type": "number",
                            "description": "Goodwill."
                        },
                        "q04_A5104": {
                            "type": "number",
                            "description": "Intangible assets."
                        },
                        "q04_A5105": {
                            "type": "number",
                            "description": "Biological assets."
                        },
                        "q04_A5106": {
                            "type": "number",
                            "description": "Financial holdings - equity method."
                        },
                        "q04_A5107": {
                            "type": "number",
                            "description": "Financial holdings - other methods."
                        },
                        "q04_A5108": {
                            "type": "number",
                            "description": "Shareholders / partners (non-current asset)."
                        },
                        "q04_A5109": {
                            "type": "number",
                            "description": "Other financial assets."
                        },
                        "q04_A5110": {
                            "type": "number",
                            "description": "Deferred tax assets."
                        },
                        "q04_A5111": {
                            "type": "number",
                            "description": "Financial investments (micro/small entities)."
                        },
                        "q04_A5112": {
                            "type": "number",
                            "description": "Subtotal (non-current assets)."
                        },
                        "q04_A5113": {
                            "type": "number",
                            "description": "Inventories."
                        },
                        "q04_A5114": {
                            "type": "number",
                            "description": "Biological assets (current)."
                        },
                        "q04_A5115": {
                            "type": "number",
                            "description": "Customers."
                        },
                        "q04_A5116": {
                            "type": "number",
                            "description": "Advances to suppliers."
                        },
                        "q04_A5117": {
                            "type": "number",
                            "description": "Government and other public entities."
                        },
                        "q04_A5118": {
                            "type": "number",
                            "description": "Shareholders / partners (current asset)."
                        },
                        "q04_A5119": {
                            "type": "number",
                            "description": "Other receivables."
                        },
                        "q04_A5120": {
                            "type": "number",
                            "description": "Deferrals."
                        },
                        "q04_A5121": {
                            "type": "number",
                            "description": "Financial assets held for trading."
                        },
                        "q04_A5122": {
                            "type": "number",
                            "description": "Other financial assets (current)."
                        },
                        "q04_A5123": {
                            "type": "number",
                            "description": "Non-current assets held for sale."
                        },
                        "q04_A5124": {
                            "type": "number",
                            "description": "Other current assets."
                        },
                        "q04_A5125": {
                            "type": "number",
                            "description": "Cash and bank deposits."
                        },
                        "q04_A5126": {
                            "type": "number",
                            "description": "Subtotal (current assets)."
                        },
                        "q04_A5127": {
                            "type": "number",
                            "description": "Total Assets."
                        },
                        "q04_A5128": {
                            "type": "number",
                            "description": "Paid-up capital."
                        },
                        "q04_A5129": {
                            "type": "number",
                            "description": "Treasury shares (quotas)."
                        },
                        "q04_A5130": {
                            "type": "number",
                            "description": "Other equity instruments."
                        },
                        "q04_A5131": {
                            "type": "number",
                            "description": "Share premiums."
                        },
                        "q04_A5132": {
                            "type": "number",
                            "description": "Legal reserves."
                        },
                        "q04_A5133": {
                            "type": "number",
                            "description": "Other reserves."
                        },
                        "q04_A5134": {
                            "type": "number",
                            "description": "Retained earnings."
                        },
                        "q04_A5135": {
                            "type": "number",
                            "description": "Financial asset adjustments."
                        },
                        "q04_A5136": {
                            "type": "number",
                            "description": "Revaluation surpluses."
                        },
                        "q04_A5137": {
                            "type": "number",
                            "description": "Other changes in equity."
                        },
                        "q04_A5138": {
                            "type": "number",
                            "description": "Subtotal (equity)."
                        },
                        "q04_A5139": {
                            "type": "number",
                            "description": "Net result for the period."
                        },
                        "q04_A5140": {
                            "type": "number",
                            "description": "Anticipated dividends."
                        },
                        "q04_A5141": {
                            "type": "number",
                            "description": "Total Equity."
                        },
                        "q04_A5142": {
                            "type": "number",
                            "description": "Provisions."
                        },
                        "q04_A5143": {
                            "type": "number",
                            "description": "Borrowings (non-current)."
                        },
                        "q04_A5144": {
                            "type": "number",
                            "description": "Post-employment benefit obligations."
                        },
                        "q04_A5145": {
                            "type": "number",
                            "description": "Deferred tax liabilities."
                        },
                        "q04_A5146": {
                            "type": "number",
                            "description": "Other payables (non-current)."
                        },
                        "q04_A5147": {
                            "type": "number",
                            "description": "Subtotal (non-current liabilities)."
                        },
                        "q04_A5148": {
                            "type": "number",
                            "description": "Suppliers."
                        },
                        "q04_A5149": {
                            "type": "number",
                            "description": "Customer advances."
                        },
                        "q04_A5150": {
                            "type": "number",
                            "description": "Government and other public entities."
                        },
                        "q04_A5151": {
                            "type": "number",
                            "description": "Shareholders / partners (liability)."
                        },
                        "q04_A5152": {
                            "type": "number",
                            "description": "Borrowings (current)."
                        },
                        "q04_A5153": {
                            "type": "number",
                            "description": "Other payables (current)."
                        },
                        "q04_A5154": {
                            "type": "number",
                            "description": "Deferrals."
                        },
                        "q04_A5155": {
                            "type": "number",
                            "description": "Financial liabilities held for trading."
                        },
                        "q04_A5156": {
                            "type": "number",
                            "description": "Other financial liabilities."
                        },
                        "q04_A5157": {
                            "type": "number",
                            "description": "Non-current liabilities held for sale."
                        },
                        "q04_A5158": {
                            "type": "number",
                            "description": "Other current liabilities."
                        },
                        "q04_A5159": {
                            "type": "number",
                            "description": "Subtotal (current liabilities)."
                        },
                        "q04_A5160": {
                            "type": "number",
                            "description": "Total Liabilities."
                        },
                        "q04_A5161": {
                            "type": "number",
                            "description": "Total Liabilities and Equity."
                        },
                        "q05291_A6012": {
                            "type": "integer",
                            "description": "Total persons employed (paid and unpaid)."
                        },
                        "q05291_A6013": {
                            "type": "integer",
                            "description": "Paid employees."
                        },
                        "q05291_A6014": {
                            "type": "integer",
                            "description": "Unpaid employees."
                        },
                        "q05291_A6015": {
                            "type": "integer",
                            "description": "Full-time employees."
                        },
                        "q05291_A6016": {
                            "type": "integer",
                            "description": "Paid full-time employees."
                        },
                        "q05291_A6017": {
                            "type": "integer",
                            "description": "Part-time employees."
                        },
                        "q05291_A6018": {
                            "type": "integer",
                            "description": "Paid part-time employees."
                        },
                        "q05291_A6019": {
                            "type": "integer",
                            "description": "Male employees."
                        },
                        "q05291_A6020": {
                            "type": "integer",
                            "description": "Female employees."
                        },
                        "q05291_A6021": {
                            "type": "integer",
                            "description": "R&D employees."
                        },
                        "q05291_A6022": {
                            "type": "integer",
                            "description": "Service providers."
                        },
                        "q05291_A6023": {
                            "type": "integer",
                            "description": "Temporary workers."
                        }
                    }
                },
                "rosto": {
                    "type": "object",
                    "properties": {
                        "q01Ano": {
                            "type": "integer",
                            "description": "Fiscal year."
                        },
                        "q03Name": {
                            "type": "string",
                            "description": "Entity name."
                        },
                        "q03Nif": {
                            "type": "integer",
                            "description": "Entity tax identification number (NIF)."
                        }
                    }
                },
                "requestId": {
                    "type": "string",
                    "description": "Unique request identifier."
                }
            }
        }
    }
}

Anexo B — Financial institutions: {
    "type": "object",
    "properties": {
        "data": {
            "type": "object",
            "properties": {
                "anexoB": {
                    "type": "object",
                    "properties": {
                        "q0101_nif": {
                            "type": "integer",
                            "description": "Entity tax identification number (NIF)."
                        },
                        "q0102_exercicio": {
                            "type": "string",
                            "description": "Fiscal year."
                        },
                        "q03_B0101": {
                            "type": "number",
                            "description": "Interest and similar income."
                        },
                        "q03_B0102": {
                            "type": "number",
                            "description": "Interest and similar expenses."
                        },
                        "q03_B0103": {
                            "type": "number",
                            "description": "Net interest income."
                        },
                        "q03_B0112": {
                            "type": "number",
                            "description": "Banking product."
                        },
                        "q03_B0113": {
                            "type": "number",
                            "description": "Employee expenses."
                        },
                        "q03_B0120": {
                            "type": "number",
                            "description": "Result before taxes."
                        },
                        "q03_B0124": {
                            "type": "number",
                            "description": "Result after taxes."
                        },
                        "q04_B0319_bruto": {
                            "type": "number",
                            "description": "Total Assets - Gross."
                        },
                        "q04_B0319_liquido": {
                            "type": "number",
                            "description": "Total Assets - Net."
                        },
                        "q04_B0335": {
                            "type": "number",
                            "description": "Total Liabilities."
                        },
                        "q04_B0336": {
                            "type": "number",
                            "description": "Capital."
                        },
                        "q04_B0341": {
                            "type": "number",
                            "description": "Other reserves and retained earnings."
                        },
                        "q04_B0342": {
                            "type": "number",
                            "description": "Net result for the year."
                        },
                        "q04_B0344": {
                            "type": "number",
                            "description": "Total Equity."
                        },
                        "q04_B0345": {
                            "type": "number",
                            "description": "Total Liabilities and Equity."
                        },
                        "q061_B0501": {
                            "type": "integer",
                            "description": "Average number of paid employees."
                        },
                        "q061_B0513": {
                            "type": "integer",
                            "description": "Total hours worked."
                        },
                        "q061_B0518": {
                            "type": "number",
                            "description": "Gross remuneration."
                        },
                        "q07_3": {
                            "type": "string",
                            "description": "Date of accounts approval (format: YYYY-MM-DD)."
                        },
                        "q08_19": {
                            "type": "integer",
                            "description": "Statutory auditor NIF (ROC/SROC)."
                        }
                    }
                },
                "rosto": {
                    "type": "object",
                    "properties": {
                        "q01Ano": {
                            "type": "integer",
                            "description": "Fiscal year."
                        },
                        "q03Name": {
                            "type": "string",
                            "description": "Entity name."
                        },
                        "q03Nif": {
                            "type": "integer",
                            "description": "Entity tax identification number (NIF)."
                        }
                    }
                },
                "requestId": {
                    "type": "string",
                    "description": "Unique request identifier."
                }
            }
        }
    }
}

Anexo C — Insurance companies: {
    "type": "object",
    "properties": {
        "data": {
            "type": "object",
            "properties": {
                "anexoC": {
                    "type": "object",
                    "properties": {
                        "q0101_nif": {
                            "type": "integer",
                            "description": "Entity tax identification number (NIF)."
                        },
                        "q0102_exercicio": {
                            "type": "string",
                            "description": "Fiscal year."
                        },
                        "ativo_C7037_bruto": {
                            "type": "number",
                            "description": "Total Assets - Gross value."
                        },
                        "ativo_C7037_imparidade": {
                            "type": "number",
                            "description": "Total Assets - Impairment/Depreciation."
                        },
                        "ativo_C7037_liquido": {
                            "type": "number",
                            "description": "Total Assets - Net value."
                        },
                        "passivo_C7067": {
                            "type": "number",
                            "description": "Total Liabilities."
                        },
                        "passivo_C7068": {
                            "type": "number",
                            "description": "Capital."
                        },
                        "passivo_C7088": {
                            "type": "number",
                            "description": "Other reserves."
                        },
                        "passivo_C7089": {
                            "type": "number",
                            "description": "Retained earnings."
                        },
                        "passivo_C7090": {
                            "type": "number",
                            "description": "Net result for the year."
                        },
                        "passivo_C7092": {
                            "type": "number",
                            "description": "Total Equity."
                        },
                        "passivo_C7093": {
                            "type": "number",
                            "description": "Total Liabilities and Equity."
                        },
                        "resultado_C7251": {
                            "type": "number",
                            "description": "Insurance contract revenue."
                        },
                        "resultado_C7268": {
                            "type": "number",
                            "description": "Insurance contract expenses."
                        },
                        "resultado_C7312": {
                            "type": "number",
                            "description": "Insurance contract result."
                        },
                        "resultado_C7381": {
                            "type": "number",
                            "description": "Net result before taxes."
                        },
                        "resultado_C7384": {
                            "type": "number",
                            "description": "Net result for the period."
                        }
                    }
                },
                "rosto": {
                    "type": "object",
                    "properties": {
                        "q01Ano": {
                            "type": "integer",
                            "description": "Fiscal year."
                        },
                        "q03Name": {
                            "type": "string",
                            "description": "Entity name."
                        },
                        "q03Nif": {
                            "type": "integer",
                            "description": "Entity tax identification number (NIF)."
                        }
                    }
                },
                "requestId": {
                    "type": "string",
                    "description": "Unique request identifier."
                }
            }
        }
    }
}

Best Practices

Always log the requestId - Include it when contacting support for faster issue resolution
Use errorCode or errorName for programmatic error handling in your application
Reference the timestamp for correlating errors with your application logs

📖 View complete error codes reference →

200200

401401

503503