> ## Documentation Index > Fetch the complete documentation index at: https://docs.brudcast.com/llms.txt > Use this file to discover all available pages before exploring further. # Get a contact import > Returns one import at `data.import`, including its status and the processed, success, error, new and duplicate row counters. This is the endpoint to poll while an import runs. Uploaded drafts are reachable here even though they are hidden from the listing. Requires the `contacts:read` scope. ## OpenAPI ````yaml /api-reference/openapi.json get /api/v1/user/contact-imports/{id} openapi: 3.0.0 info: title: Brudcast API version: 1.0.0 servers: - url: https://core-service.prod.brudcast.com description: Production security: [] tags: - name: Analytics x-displayName: Analytics - name: Campaigns x-displayName: Campaigns - name: Contacts x-displayName: Contacts - name: Mailboxes x-displayName: Mailboxes - name: Messages x-displayName: Messages - name: Sender Identities x-displayName: Sender Identities - name: Sending Domains x-displayName: Sending Domains - name: Templates x-displayName: Templates - name: Webhooks x-displayName: Webhooks paths: /api/v1/user/contact-imports/{id}: get: tags: - Contacts summary: Get a contact import description: >- Returns one import at `data.import`, including its status and the processed, success, error, new and duplicate row counters. This is the endpoint to poll while an import runs. Uploaded drafts are reachable here even though they are hidden from the listing. Requires the `contacts:read` scope. parameters: - in: header name: X-Organization-Id required: false description: >- Required when authenticating with an access token. Optional with an API key, whose own organization binding is authoritative; a value contradicting it is refused with 403. schema: type: string format: uuid - in: path name: id required: true schema: type: string responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/ContactImportDataResponse' '401': description: The credential is missing, malformed, revoked or expired content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: >- The key lacks the scope the endpoint requires, or the organization does not match the credential content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: No such import in the organization content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '422': description: The payload or query string failed validation content: application/json: schema: $ref: '#/components/schemas/ValidationErrorResponse' '429': description: >- Rate limit exceeded; retry after the number of seconds in `retryAfter` content: application/json: schema: $ref: '#/components/schemas/RateLimitErrorResponse' security: - apiKey: [] - apiKeyBearer: [] components: schemas: ContactImportDataResponse: type: object properties: success: type: boolean example: true message: type: string data: $ref: '#/components/schemas/ContactImportData' required: - success - message - data ErrorResponse: type: object properties: success: type: boolean example: false message: type: string example: Resource not found code: type: string enum: - E_VALIDATION_ERROR - E_UNAUTHORIZED_ACCESS - E_UNAUTHORIZED - E_FORBIDDEN - E_INSUFFICIENT_SCOPE - E_ROW_NOT_FOUND - E_TOO_MANY_REQUESTS - E_BUSINESS_RULE_VIOLATION - E_CAMPAIGN_NOT_SENDABLE - INSUFFICIENT_CREDITS - SUBSCRIPTION_REQUIRED example: E_ROW_NOT_FOUND required: - success - message - code ValidationErrorResponse: type: object properties: success: type: boolean example: false message: type: string example: The payload is invalid code: type: string enum: - E_VALIDATION_ERROR - E_UNAUTHORIZED_ACCESS - E_UNAUTHORIZED - E_FORBIDDEN - E_INSUFFICIENT_SCOPE - E_ROW_NOT_FOUND - E_TOO_MANY_REQUESTS - E_BUSINESS_RULE_VIOLATION - E_CAMPAIGN_NOT_SENDABLE - INSUFFICIENT_CREDITS - SUBSCRIPTION_REQUIRED example: E_VALIDATION_ERROR errors: type: array items: $ref: '#/components/schemas/ValidationErrorItem' required: - success - message - code - errors RateLimitErrorResponse: type: object properties: success: type: boolean example: false message: type: string example: Too many requests code: type: string enum: - E_VALIDATION_ERROR - E_UNAUTHORIZED_ACCESS - E_UNAUTHORIZED - E_FORBIDDEN - E_INSUFFICIENT_SCOPE - E_ROW_NOT_FOUND - E_TOO_MANY_REQUESTS - E_BUSINESS_RULE_VIOLATION - E_CAMPAIGN_NOT_SENDABLE - INSUFFICIENT_CREDITS - SUBSCRIPTION_REQUIRED example: E_TOO_MANY_REQUESTS retryAfter: type: number example: 60 required: - success - message - code - retryAfter ContactImportData: type: object properties: import: $ref: '#/components/schemas/ContactImport' required: - import ValidationErrorItem: type: object properties: field: type: string example: emailAddress rule: type: string example: email message: type: string example: The emailAddress field must be a valid email address required: - field - rule - message ContactImport: type: object properties: id: type: string format: uuid organizationId: type: string format: uuid fileName: type: string example: subscribers.csv filePath: type: string description: Storage path the uploaded file was written to status: type: string enum: - uploaded - pending - processing - completed - failed totalRows: type: number processedRows: type: number successCount: type: number errorCount: type: number newCount: type: number duplicateCount: type: number duplicateHandling: type: string enum: - skip - update - create_new allowPartialUpload: type: boolean description: Whether valid rows are kept when other rows in the same file fail listName: type: string nullable: true description: >- Contact list the imported contacts are subscribed to, created if it is new tags: type: array items: type: string description: Tag names applied to every imported contact consentConfirmed: type: boolean fieldMappings: type: array items: $ref: '#/components/schemas/ContactImportFieldMapping' errorsFilePath: type: string nullable: true description: >- Storage path of the generated error report, set once processing has produced failures createdAt: type: string format: date-time completedAt: type: string format: date-time nullable: true required: - id - organizationId - fileName - filePath - status - totalRows - processedRows - successCount - errorCount - newCount - duplicateCount - duplicateHandling - allowPartialUpload - listName - tags - consentConfirmed - fieldMappings - errorsFilePath - createdAt - completedAt ContactImportFieldMapping: type: object properties: csvHeader: type: string example: Email Address brudcastField: type: string example: email required: - csvHeader - brudcastField securitySchemes: apiKey: type: apiKey in: header name: X-API-Key description: >- An organization API key, prefixed `bk_live_`. Takes precedence over `Authorization` when both are sent. The key is bound to one organization, and the scopes it was issued with are enforced per endpoint. apiKeyBearer: type: http scheme: bearer bearerFormat: bk_live_... description: >- The same organization API key sent as `Authorization: Bearer bk_live_...`. Accepted only when the value begins with `bk_` and no `X-API-Key` header is present. ````