Only approved submissions with valid fullName and birthDate fields can be registered for ongoing monitoring.
Endpoint
Base URLs
Authentication
Include your API key in the request header:Your API key for authentication
Path Parameters
The ID of the active worklist where records will be registered
Request Body
Array of submission IDs to register for ongoing monitoring (1-25 submissions)
Email address of the administrator making the request (must be registered in the project’s admin list)
Request Example
Response
Success Response
Response Fields
Overall success status of the batch operation
Number of submissions successfully processed
Number of submissions that failed to process
Array of successfully processed submissions
Array of submissions that failed to process
Error Response
Error Codes
Error Code | HTTP Status | Description |
---|---|---|
invalid_path | 400 | Invalid request method |
invalid_project | 400 | Invalid project ID or Ongoing Monitoring option disabled |
invalid_worklist | 400 | Worklist is inactive |
invalid_submissionIds | 400 | Submission IDs array format error or exceeds maximum count |
invalid_admin | 400 | Admin not found in project’s admin list |
missing_required_parameters | 400 | Required request parameters missing |
all_submissions_failed | 500 | All submissions failed to process |
processing_failed | 500 | Record registration or data processing failed |
internal_server_error | 500 | Unexpected server error |
Important Notes
Prerequisites for Registration:
- Submissions must be approved before they can be registered
- Each submission must have valid
fullName
andbirthDate
fields - Only active worklists can accept new records
- Maximum 25 submissions per request
Best Practices:
- Verify submission approval status before attempting registration
- Use batch operations for multiple submissions to improve efficiency
- Monitor the response for partial failures and handle them appropriately
- Keep track of generated record IDs for future reference
Rate Limits
This endpoint follows the standard rate limiting policies. Each request can process up to 25 submissions simultaneously.