---
title: "GET Activity Status Collection"
method: GET
path: "/activities"
tags: ["Bulk Activities"]
---

# GET Activity Status Collection

`GET /activities`

This endpoint returns a collection of activities. Use the state query parameter to include only activities with a specific status (processing, completed, cancelled, failed, or time_out). Use the limit query parameter to define the number of activities returned per page. Learn [more](/api_guide/activity_status.html).

## Query parameters

- `limit` integer
- `state` 'processing' | 'completed' | 'cancelled' | 'failed' | 'timed_out'

## Response `200`

Request Successful

- Activities
  - `activities` object[] — A list of bulk activity jobs and status submitted by the account over the past 10 days.
    - `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
  - `_links` PagingLinks
    - `next` Link
      - `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` — The requested resource was not found.
- `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/revisions/4b4a534c818d/schema)