--- title: "List a historical log of user consent events" method: POST path: "/item/activity/list" tags: ["plaid"] --- # List a historical log of user consent events `POST /item/activity/list` List a historical log of user consent events ## Request body - ItemActivityListRequest — Request to list a historical log of user consent events. - `client_id` string — Your Plaid API `client_id`. The `client_id` is required and may be provided either in the `PLAID-CLIENT-ID` header or as part of a request body. - `secret` string — Your Plaid API `secret`. The `secret` is required and may be provided either in the `PLAID-SECRET` header or as part of a request body. - `access_token` string — The access token associated with the Item for which data is being requested. - `cursor` string — Cursor used for pagination. - `count` integer ## Response `200` OK - ItemActivityListResponse — Describes a historical log of user consent events. - `request_id` string, required — A unique identifier for the request, which can be used for troubleshooting. This identifier, like all Plaid identifiers, is case sensitive. - `activities` Activity[], required — A list of activities. - `activity` 'UNKNOWN' | 'ITEM_CREATE' | 'ITEM_IMPORT' | 'ITEM_UPDATE' | 'ITEM_UNLINK' | 'PORTAL_UNLINK' | 'PORTAL_ITEMS_DELETE' | 'ITEM_REMOVE' | 'INVARIANT_CHECKER_DELETION' | 'SCOPES_UPDATE', required — Types of consent activities - `initiated_date` string, date, required — The date this activity was initiated [ISO 8601](https://wikipedia.org/wiki/ISO_8601) (YYYY-MM-DD) format in UTC. - `id` string, required — A unique identifier for the activity - `initiator` string, required — Application ID of the client who initiated the activity. - `state` 'UNKNOWN' | 'ATTEMPT' | 'SUCCESS' | 'FAILURE' | 'SKIPPED', required — Enum representing the state of the action/activity. - `target_application_id` string — This field will map to the application ID that is returned from `/item/application/list`, or provided to the institution in an oauth redirect. - `scopes` ScopesNullable, nullable — The scopes object - `product_access` ProductAccess — The product access being requested. Used to allow or disallow product access across all accounts. If unset, defaults to all products allowed. - `statements` boolean, nullable — Allow access to statements. Only used by certain partners. If relevant to the partner and unset, defaults to `true`. - `identity` boolean, nullable — Allow access to the Identity product (name, email, phone, address). Only used by certain partners. If relevant to the partner and unset, defaults to `true`. - `auth` boolean, nullable — Allow access to account number details. Only used by certain partners. If relevant to the partner and unset, defaults to `true`. - `transactions` boolean, nullable — Allow access to transaction details. Only used by certain partners. If relevant to the partner and unset, defaults to `true`. - `accounts_details_transactions` boolean, nullable — Allow access to `accounts_details_transactions`. Only used by certain partners. If relevant to the partner and unset, defaults to `true`. - `accounts_routing_number` boolean, nullable — Allow access to `accounts_routing_number`. Only used by certain partners. If relevant to the partner and unset, defaults to `true`. - `accounts_statements` boolean, nullable — Allow access to `accounts_statements`. Only used by certain partners. If relevant to the partner and unset, defaults to `true`. - `accounts_tax_statements` boolean, nullable — Allow access to `accounts_tax_statements`. Only used by certain partners. If relevant to the partner and unset, defaults to `true`. - `customers_profiles` boolean, nullable — Allow access to `customers_profiles`. Only used by certain partners. If relevant to the partner and unset, defaults to `true`. - `accounts` AccountAccess[] - `unique_id` string, required — The unique account identifier for this account. This value must match that returned by the data access API for this account. - `authorized` boolean, nullable — Allow the application to see this account (and associated details, including balance) in the list of accounts. If unset, defaults to `true`. - `account_product_access` AccountProductAccessNullable, nullable — Allow the application to access specific products on this account - `account_data` boolean, nullable — Allow the application to access account data. Only used by certain partners. If relevant to the partner and unset, defaults to `true`. - `statements` boolean, nullable — Allow the application to access bank statements. Only used by certain partners. If relevant to the partner and unset, defaults to `true`. - `tax_documents` boolean, nullable — Allow the application to access tax documents. Only used by certain partners. If relevant to the partner and unset, defaults to `true`. - `new_accounts` boolean, nullable — Allow access to newly opened accounts as they are opened. If unset, defaults to `true`. - `authentication` 'UNKNOWN' | 'DATA_PARTNER' | 'PLAID' — Enum representing the entity authenticating the user. - `last_data_access_times` LastDataAccessTimes[], required — An array of objects containing timestamps for the last time each data type was accessed per application. - `application_id` string, required — ID of the application accessing data. - `account_balance_info` string, date-time, nullable, required — The last time `account_balance_info` was accessed by this application in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format in UTC. null if never accessed. - `account_routing_number` string, date-time, nullable, required — The last time `account_routing_number` was accessed by this application in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format in UTC. null if never accessed. - `contact_details` string, date-time, nullable, required — The last time `contact_details` was accessed by this application in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format in UTC. null if never accessed. - `transactions` string, date-time, nullable, required — The last time `transactions` was accessed by this application in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format in UTC. null if never accessed. - `credit_and_loans` string, date-time, nullable, required — The last time `credit_and_loans` was accessed by this application in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format in UTC. null if never accessed. - `investments` string, date-time, nullable, required — The last time `investments` was accessed by this application in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format in UTC. null if never accessed. - `payroll_info` string, date-time, nullable, required — The last time `payroll_info` was accessed by this application in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format in UTC. null if never accessed. - `transaction_risk_info` string, date-time, nullable, required — The last time `transaction_risk_info` was accessed by this application in [ISO 8601](https://wikipedia.org/wiki/ISO_8601) format in UTC. null if never accessed. - `cursor` string — Cursor used for pagination. ## Other responses - `default` — Error response. --- [API](https://skmtc.net/plaid/apis/the-plaid-api.md) · [All operations](https://skmtc.net/plaid/apis/the-plaid-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/plaid/the-plaid-api/versions/64c4514ea59b/schema)