Seguro-by-matricula

This endpoint allows users to search for the insurance company of a vehicle by using the license plate. It also requests a date, that corresponds to the date to be search, allowing to search for old insurances.


🚧

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

EnvironmentStatus
📚 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"
    },
    "licensePlate": {
      "type": "string",
      "description": "Matrícula do veículo"
    },
    "entity": {
      "type": "string",
      "description": "Seguradora"
    },
    "startDate": {
      "type": "string",
      "description": "Data de início do seguro"
    },
    "endDate": {
      "type": "string",
      "description": "Data de fim do seguro"
    },
    "policy": {
      "type": "string",
      "description": "Número de apólice"
    }
  }
}

English (ENG)

{
  "type": "object",
  "properties": {
    "requestId": {
      "type": "string",
      "description": "Unique request identifier"
    },
    "licensePlate": {
      "type": "string",
      "description": "Vehicle license plate"
    },
    "entity": {
      "type": "string",
      "description": "Insurance company"
    },
    "startDate": {
      "type": "string",
      "description": "Insurance start date"
    },
    "endDate": {
      "type": "string",
      "description": "Insurance end date"
    },
    "policy": {
      "type": "string",
      "description": "Policy number"
    }
  }
}

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 →

Language
Credentials
Header
Click Try It! to start a request and see the response here!