1. 📚 Improve API Documentation Examples

[Kcodess2807]

Description:
The API documentation needs more comprehensive examples showing request/response formats for all endpoints.

What needs to be done:

• Add curl examples for each API endpoint in API_DOCUMENTATION.md
• Include sample request bodies and expected responses
• Add error response examples with different status codes

Files to modify:

• API_DOCUMENTATION.md

Acceptance Criteria:

• All endpoints have curl examples
• Request/response examples are properly formatted
• Error scenarios are documented with examples
• Examples use realistic sample data

[louraider]

Hi! I'd like to work on this issue. I'll add comprehensive curl examples for all API endpoints in API_DOCUMENTATION.md, including sample request/response bodies and error scenarios with different status codes. I'll make sure to use realistic sample data throughout.