---
title: "Query actions"
method: GET
path: "/users/{userId}/actions"
tags: ["users", "actions", "query"]
---

# Query actions

`GET /users/{userId}/actions`

Query actions for a user.

## Path parameters

- `userId` string, required

## Query parameters

- `codes` string — A comma-separated list of action codes to include in your query. If omitted, all action codes will be included.
- `fromDate` string — If provided, the query will include actions from this date. Must be specified in ISO 8601 format - e.g. `2020-01-01T00:00:00Z`. The default and maximum value is 30 days ago.

## Response `200`

OK

- QueryActionsResponseBody[]
  - `actionCode` string — The action code.
  - `idempotencyKey` string — The idempotency key for the user action.
  - `createdAt` string, date-time — The time in ISO 8061 format when the action was first created.
  - `updatedAt` string, date-time — The time in ISO 8061 format when the action was last updated.
  - `state` 'ALLOW' | 'BLOCK' | 'CHALLENGE_REQUIRED' | 'CHALLENGE_FAILED' | 'CHALLENGE_SUCCEEDED' | 'REVIEW_REQUIRED' | 'REVIEW_FAILED' | 'REVIEW_SUCCEEDED' — The current state of the action.
  - `stateUpdatedAt` string, date-time — The time in ISO 8061 format when the state of the action was last updated.
  - `verificationMethod` 'SMS' | 'AUTHENTICATOR_APP' | 'EMAIL_MAGIC_LINK' | 'EMAIL_OTP' | 'PUSH' | 'DEVICE' | 'SECURITY_KEY' | 'PASSKEY' | 'VERIFF' | 'IPROOV' | 'PALM_BIOMETRICS_RR' | 'IDVERSE'
  - `verifiedByAuthenticatorId` string — The ID of the authenticator which was used to complete the challenge associated with the action.
  - `userAgent` string — The user agent provided when the action was tracked.
  - `ipAddress` string — The IP address provided when the action was tracked.
  - `countryCode` string — The country code derived from the IP address if provided.

## Other responses

- `401` — Unauthorized
- `404` — Not Found

---

[API](https://skmtc.net/authsignal/apis/call-connect-api.md) · [All operations](https://skmtc.net/authsignal/apis/call-connect-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/authsignal/call-connect-api/versions/5604d744e3ad/schema)