Write API documentation

Write clear API documentation for this endpoint: [describe endpoint, method, parameters, response]. Include example requests and responses.