Appendix F: Request & Response Formats

Request & Response Formats

Request Headers

• X-BL-API-Key: Your API key (required)
• Content-Type: application/json (required)

Success Response

{
  "status": "success",
  "message": "Operation completed",
  "data": {...}
}

Error Response

{
  "status": "failure",
  "message": "Operation failed",
  "errors": ["Error message"]
}

Data Types

• String: quoted text
• Number: integer or decimal
• Boolean: true/false
• Date: ISO 8601 format
• Array: [item1, item2]
• Object: {key: value}