---
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}`

## Request

- Base URL: `https://platform.ringcentral.com`
- URL: `https://platform.ringcentral.com/restapi/v1.0/account/{accountId}/address-book-bulk-upload/tasks/{taskId}`
- Auth: OAuth 2
  - Authorization code: `https://platform.ringcentral.com/restapi/oauth/authorize`
  - Token URL: `https://platform.ringcentral.com/restapi/oauth/token`
- TypeScript: <https://skmtc.dev/ringcentral/apis/ringcentral-api/docs/restapi/v1.0/account/:accountId/address-book-bulk-upload/tasks/:taskId/get.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/ringcentral/apis/ringcentral-api.md) - [All operations](https://skmtc.dev/ringcentral/apis/ringcentral-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ringcentral/apis/ringcentral-api/revisions/8d602198ec97?raw)