🚧
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)

{
  "type" : "object",
  "properties" : {
    "RequestId" : {
      "type" : "string",
      "description" : "Identificador único do pedido."
    },
    "Date" : {
      "type" : "string",
      "description" : "Data da publicação do ato ou facto (formato: YYYY-MM-DD)."
    },
    "NIPC" : {
      "type" : "string",
      "description" : "Número de Identificação de Pessoa Coletiva (NIPC) da entidade."
    },
    "Entity" : {
      "type" : "string",
      "description" : "Nome da entidade associada."
    },
    "County" : {
      "type" : "string",
      "description" : "Concelho onde a entidade está localizada."
    },
    "Act/Fact" : {
      "type" : "string",
      "description" : "Descrição do ato ou facto publicado."
    },
    "Status" : {
      "type" : "string",
      "description" : "Estado atual da entidade."
    },
    "Code" : {
      "type" : "string",
      "description" : "Código associado ao tipo de Act/Fact."
    }
  }
}

English (ENG)

{
  "type": "object",
  "properties": {
    "RequestId": {
      "type": "string",
      "description": "Unique identifier for the request."
    },
    "Date": {
      "type": "string",
      "description": "Date of the publication of the act or fact (format: YYYY-MM-DD)."
    },
    "NIPC": {
      "type": "string",
      "description": "Corporate Taxpayer Identification Number (NIPC) of the entity."
    },
    "Entity": {
      "type": "string",
      "description": "Name of the associated entity."
    },
    "County": {
      "type": "string",
      "description": "County where the entity is located."
    },
    "Act/Fact": {
      "type": "string",
      "description": "Description of the published act or fact."
    },
    "Status": {
      "type": "string",
      "description": "Current status of the entity."
    },
    "Code": {
      "type": "string",
      "description": "Code associated with the type of Act/Fact."
    }
  }
}

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