Response format

Every endpoint returns the same JSON envelope, so you can write one parser for the whole API.

The envelope#

• success — boolean; true on a 2xx response.
• data — the payload (object, array or null).
• error — a human-readable message, or null on success.
• timestamp — ISO 8601 server time.
• meta — optional object for pagination/usage metadata, or null.

{
  "success": true,
  "data": {
    "enterpriseNumber": "0403.170.701",
    "status": "AC",
    "denomination": "Anheuser-Busch InBev"
  },
  "error": null,
  "timestamp": "2026-06-05T09:00:00.000Z",
  "meta": null
}

On error#

success is false, data is null and error describes the problem. The HTTP status code carries the category.

{
  "success": false,
  "data": null,
  "error": "Enterprise not found",
  "timestamp": "2026-06-05T09:00:00.000Z",
  "meta": null
}