--- 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 data is being requested for. - `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 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`. - `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. ## Changes - **2024-02-21** `5de70cc1e6ca` — 4 warning, 11 info - removed the optional property `activities/items/authentication` from the response with the `200` status - removed the optional property `error_code_reason` from the response with the `default` status - removed the optional property `provided_account_subtypes` from the response with the `default` status - removed the optional property `required_account_subtypes` from the response with the `default` status - …11 more [Change history](https://skmtc.dev/plaid/apis/the-plaid-api/changes/item/activity/list/post.md) --- [API](https://skmtc.dev/plaid/apis/the-plaid-api.md) · [All operations](https://skmtc.dev/plaid/apis/the-plaid-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/plaid/the-plaid-api/revisions/a5b45bccb4e8/schema)