---
title: "GET an Activity Status"
method: GET
path: "/activities/{activity_id}"
tags: ["Bulk Activities"]
---

# GET an Activity Status

`GET /activities/{activity_id}`

This endpoint returns an activity status report.

## Path parameters

- `activity_id` string, required

## Response `200`

Request Successful

- Activity — Generic bulk activity status response object
  - `activity_id` string, uuid — Unique ID for the activity.
  - `state` string — The state of the request: <p><ul> <li>initialized - request has been received</li> <li>processing - request is being processed</li> <li>completed - job completed</li> <li>cancelled - request was cancelled</li> <li>failed - job failed to complete</li> <li>timed_out - the request timed out before completing"</li> </ul> </p>
  - `started_at` string, date-time — Timestamp showing when we began processing the activity request, in ISO-8601 format.
  - `completed_at` string, date-time — Timestamp showing when we completed processing the activity, in ISO-8601 format.
  - `created_at` string, date-time — Timestamp showing when we created the activity, in ISO-8601 format.
  - `updated_at` string, date-time — Timestamp showing when we last updated the activity, in ISO-8601 format.
  - `source_file_name` string — Name of the file used for an add_contacts activity.
  - `percent_done` integer — Shows the percent done for an activity that we are still processing.
  - `activity_errors` string[] — Array of messages describing the errors that occurred.
  - `status` ActivityStatus
    - `items_total_count` integer — The total number of items to be processed.
    - `items_completed_count` integer — The number of items processed in the activity request.
    - `person_count` integer — The total number of contacts in an import contacts request.
    - `error_count` integer — The number of non-correctable errors encountered during an import contacts request.
    - `correctable_count` integer — The number of correctable errors. Correctable errors include invalid email address format, birthday or anniversary format error, or does not have minimal contact information (no name or email address). Correctable errors are available in the product UI to correct.
    - `cannot_add_to_list_count` integer — The number of contacts that cannot be added to a list because they were previously unsubscribed, valid for contacts_file_ or json_import requests.
    - `list_count` integer — The number of lists processed in an add or remove list membership activity request.
  - `_links` ActivityStatusExportLink
    - `self` object — HATEOS-style link to the activity status (this object).
      - `href` string
    - `results` object — Link to an activity result resource; as an example, for file_export, the link to the exported contacts file.
      - `href` string

## Other responses

- `400` — Bad request. Either the JSON was malformed or there was a data validation error.
- `401` — The Access Token used is invalid.
- `403` — Forbidden request. You lack the necessary scopes, you lack the necessary user privileges, or the application is deactivated.
- `404` — Resource not found for the activity_id provided
- `500` — There was a problem with our internal service.
- `503` — Our internal service is temporarily unavailable.

---

[API](https://skmtc.net/cc/apis/appconnect-v3.md) · [All operations](https://skmtc.net/cc/apis/appconnect-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cc/appconnect-v3/versions/4b4a534c818d/schema)