> ## Documentation Index > Fetch the complete documentation index at: https://docs.coldsend.pro/llms.txt > Use this file to discover all available pages before exploring further. # Get bulk SMTP job progress > **Track the progress of a bulk SMTP inbox creation job** Returns the current status and results of a bulk SMTP inbox creation job. ## Status Values - **PENDING**: Job is queued, not yet started - **VALIDATING**: Connection tests are running - **COMPLETED**: All inboxes have been processed - **FAILED**: Job encountered an error ## Per-Inbox Status Values - **PENDING**: Not yet processed - **VALIDATING**: Connection test in progress - **SUCCESS**: Inbox created successfully - **FAILED**: Connection test failed or creation error ## OpenAPI ````yaml /public_openapi.json get /api/public/v1/sender-accounts/smtp/bulk/{job_id}/progress openapi: 3.0.3 info: title: ColdSend Public API description: >- Programmatic access to ColdSend for managing cold email campaigns and sender accounts. version: 1.0.0 contact: name: ColdSend Support email: support@coldsend.pro url: https://coldsend.pro servers: - url: https://api.coldsend.pro description: Production security: - ApiKeyAuth: [] paths: /api/public/v1/sender-accounts/smtp/bulk/{job_id}/progress: get: tags: - Sender Accounts summary: Get bulk SMTP job progress description: >- **Track the progress of a bulk SMTP inbox creation job** Returns the current status and results of a bulk SMTP inbox creation job. ## Status Values - **PENDING**: Job is queued, not yet started - **VALIDATING**: Connection tests are running - **COMPLETED**: All inboxes have been processed - **FAILED**: Job encountered an error ## Per-Inbox Status Values - **PENDING**: Not yet processed - **VALIDATING**: Connection test in progress - **SUCCESS**: Inbox created successfully - **FAILED**: Connection test failed or creation error operationId: >- get_smtp_bulk_job_progress_api_public_v1_sender_accounts_smtp_bulk__job_id__progress_get parameters: - name: job_id in: path required: true schema: type: string description: Job ID from bulk creation response title: Job Id description: Job ID from bulk creation response responses: '200': description: Job progress retrieved content: application/json: schema: $ref: '#/components/schemas/SMTPBulkJobProgressResponse' '401': description: Missing or invalid API key '403': description: Insufficient permissions '404': description: Job not found '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: SMTPBulkJobProgressResponse: properties: success: type: boolean title: Success message: type: string title: Message job: $ref: '#/components/schemas/SMTPBulkJobProgress' description: Job progress details type: object required: - success - message - job title: SMTPBulkJobProgressResponse description: Response for bulk SMTP job progress. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError SMTPBulkJobProgress: properties: job_id: type: string title: Job Id description: Job ID status: type: string title: Status description: 'Job status: PENDING, VALIDATING, COMPLETED, FAILED' progress_percentage: type: integer title: Progress Percentage description: Progress percentage (0-100) total_rows: type: integer title: Total Rows description: Total inboxes in job processed_count: type: integer title: Processed Count description: Number of inboxes processed success_count: type: integer title: Success Count description: Number of successfully created inboxes failed_count: type: integer title: Failed Count description: Number of failed inboxes started_at: type: string nullable: true title: Started At description: Job start timestamp completed_at: type: string nullable: true title: Completed At description: Job completion timestamp results: items: $ref: '#/components/schemas/SMTPBulkJobProgressItem' type: array title: Results description: Individual inbox results default: [] type: object required: - job_id - status - progress_percentage - total_rows - processed_count - success_count - failed_count title: SMTPBulkJobProgress description: Progress response for a bulk SMTP inbox creation job. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError SMTPBulkJobProgressItem: properties: row_number: type: integer title: Row Number description: Row number in the original request email_address: type: string title: Email Address description: Email address display_name: type: string nullable: true title: Display Name description: Display name inbox_type: type: string nullable: true title: Inbox Type description: Inbox type status: type: string title: Status description: 'Validation status: PENDING, VALIDATING, SUCCESS, FAILED' smtp_test_passed: type: boolean nullable: true title: Smtp Test Passed description: Whether SMTP test passed smtp_error: type: string nullable: true title: Smtp Error description: SMTP error message if failed imap_test_passed: type: boolean nullable: true title: Imap Test Passed description: Whether IMAP test passed imap_error: type: string nullable: true title: Imap Error description: IMAP error message if failed inbox_id: type: string nullable: true title: Inbox Id description: Inbox ID if created successfully error_message: type: string nullable: true title: Error Message description: General error message type: object required: - row_number - email_address - status title: SMTPBulkJobProgressItem description: Progress item for a single inbox in a bulk SMTP job. securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: API key with format cs_live_xxx ````