---
title: "Get Contacts Upload Task"
method: GET
path: "/restapi/v1.0/account/{accountId}/address-book-bulk-upload/tasks/{taskId}"
tags: ["External Contacts"]
---

# Get Contacts Upload Task

`GET /restapi/v1.0/account/{accountId}/address-book-bulk-upload/tasks/{taskId}`

Returns the status of a task on adding multiple contacts to multiple extensions.

## Path parameters

- `accountId` string, required
- `taskId` string, required

## Response `200`

Contacts upload task

- AddressBookBulkUploadResponse — Information on a task for adding multiple contacts to multiple extensions
  - `id` string, required — Internal identifier of a task
  - `uri` string, uri, required — Link for the task status retrieval
  - `status` 'Accepted' | 'InProgress' | 'Completed' | 'Failed', required — Task status
  - `creationTime` string, date-time, required — Date/time of a task creation
  - `lastModifiedTime` string, date-time, required — Date/time of a task latest update
  - `results` AddressBookBulkUploadTaskResult
    - `affectedItems` AddressBookBulkUploadResource[]
      - `extensionId` string, required
      - `contacts` AddressBookBulkContactResource[], required
        - `email` string, email — Email of a contact
        - `notes` string — Notes for a contact
        - `company` string — Company name of a contact
        - `firstName` string — First name of a contact
        - `lastName` string — Last name of a contact
        - `jobTitle` string — Job title of a contact
        - `birthday` string, date-time — Date of birth of a contact
        - `webPage` string — Link to a contact home page
        - `middleName` string — Middle name of a contact
        - `nickName` string — Nick name of a contact
        - `email2` string, email — Second email of a contact
        - `email3` string, email — Third email of the contact
        - `homePhone` string — Home phone number of a contact in e.164 (with "+") format
        - `homePhone2` string — Second home phone number of a contact in e.164 (with "+") format
        - `businessPhone` string — Business phone of a contact in e.164 (with "+") format
        - `businessPhone2` string — Second business phone of a contact in e.164 (with "+") format
        - `mobilePhone` string — Mobile phone of the contact in e.164 (with "+") format
        - `businessFax` string — Business fax number of a contact in e.164 (with "+") format
        - `companyPhone` string — Company number of a contact in e.164 (with "+") format
        - `assistantPhone` string — Phone number of a contact assistant in e.164 (with "+") format
        - `carPhone` string — Car phone number of a contact in e.164 (with "+") format
        - `otherPhone` string — Other phone number of a contact in e.164 (with "+") format
        - `otherFax` string — Other fax number of a contact in e.164 (with "+") format
        - `callbackPhone` string — Callback phone number of a contact in e.164 (with "+") format
        - `businessAddress` AddressBookBulkContactAddressInfo
          - `country` string — Country name of the extension user company. Not returned for Address Book
          - `state` string — State/province name of the extension user company
          - `city` string — City name of the extension user company
          - `street` string — Street address of the extension user company
          - `zip` string — Zip code of the extension user company
        - `homeAddress` AddressBookBulkContactAddressInfo
          - `country` string — Country name of the extension user company. Not returned for Address Book
          - `state` string — State/province name of the extension user company
          - `city` string — City name of the extension user company
          - `street` string — Street address of the extension user company
          - `zip` string — Zip code of the extension user company
        - `otherAddress` AddressBookBulkContactAddressInfo
          - `country` string — Country name of the extension user company. Not returned for Address Book
          - `state` string — State/province name of the extension user company
          - `city` string — City name of the extension user company
          - `street` string — Street address of the extension user company
          - `zip` string — Zip code of the extension user company
    - `errors` ErrorEntity[]
      - `errorCode` string — Error code
      - `message` string — Error message
      - `parameterName` string — Name of invalid parameter
      - `parameterValue` string — Value of invalid parameter

---

[API](https://skmtc.net/ringcentral/apis/ringcentral-api.md) · [All operations](https://skmtc.net/ringcentral/apis/ringcentral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringcentral/ringcentral-api/revisions/8d602198ec97/schema)