{"note":"OpenAPI conversion -- returning structured metadata","name":"va-gov-benefits","description":"Benefits Intake","version":"1.0.0","base_url":"https://sandbox-api.va.gov/services/vba_documents/v1","endpoints":6,"raw":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api Benefits Intake\n@base https://sandbox-api.va.gov/services/vba_documents/v1\n@version 1.0.0\n@auth ApiKey apikey in header\n@endpoints 6\n@toc uploads(5), path(1)\n\n@group uploads\n@endpoint POST /uploads\n@desc Get a location for subsequent document upload PUT request\n@returns(202) {data: any} # Accepted. Location generated\n@errors {401: Unauthorized request, 403: Forbidden, 422: Unprocessable Entity, 429: Too many requests, 500: Internal server error}\n\n@endgroup\n\n@group path\n@endpoint PUT /path\n@desc Accepts document upload.\n@optional {Content-MD5: str(md5) # Base64-encoded 128-bit MD5 digest of the message. Use for integrity control}\n@returns(200) Document upload staged\n@errors {401: Unauthorized request, 403: Document upload failed, 422: Unprocessable Entity, 429: Too many requests, 500: Internal server error}\n\n@endgroup\n\n@group uploads\n@endpoint GET /uploads/{id}\n@desc Get status for a previous benefits document upload\n@required {id: str(uuid) # ID as returned by a previous create upload request}\n@returns(200) {data: any} # Upload status retrieved successfully\n@errors {401: Unauthorized request, 403: Forbidden, 404: Not found, 429: Too many requests, 500: Internal server error}\n\n@endpoint GET /uploads/{id}/download\n@desc Download zip of \"what the server sees\"\n@required {id: str(uuid) # ID as returned by a previous create upload request}\n@returns(200) Zip file with the contents of your payload as parsed by our server\n@errors {401: Unauthorized request, 403: Forbidden, 404: Not found, 429: Too many requests, 500: Internal server error}\n\n@endpoint POST /uploads/report\n@desc Get a bulk status report for a list of previous uploads\n@required {ids: [str(uuid)] # List of IDs for previous document upload submissions (max 1000)}\n@returns(200) {data: [any]} # Upload status report retrieved successfully\n@errors {400: Bad Request - invalid, missing, or oversized list of guids (max 1000), 401: Unauthorized request, 403: Forbidden, 422: Unprocessable Entity, 429: Too many requests, 500: Internal server error}\n\n@endpoint POST /uploads/validate_document\n@desc Validate an individual document against system file requirements\n@returns(200) {data: any} # Document passed system requirements\n@errors {401: Unauthorized request, 403: Forbidden, 422: Document did NOT pass system requirements, 429: Too many requests, 500: Internal server error}\n\n@endgroup\n\n@end\n"}