---
title: "Retrieve a list of all Challenges for a Factor."
method: GET
path: "/v2/Services/{ServiceSid}/Entities/{Identity}/Challenges"
tags: ["VerifyV2Challenge"]
---

# Retrieve a list of all Challenges for a Factor.

`GET /v2/Services/{ServiceSid}/Entities/{Identity}/Challenges`

Retrieve a list of all Challenges for a Factor.

## Path parameters

- `ServiceSid` string, required
- `Identity` string, required

## Query parameters

- `FactorSid` string
- `Status` 'pending' | 'expired' | 'approved' | 'denied' — The Status of this Challenge. One of `pending`, `expired`, `approved` or `denied`.
- `Order` 'asc' | 'desc'
- `PageSize` integer
- `Page` integer
- `PageToken` string

## Response `200`

OK

- object
  - `challenges` VerifyV2ServiceEntityChallenge[]
    - `sid` string, nullable — A 34 character string that uniquely identifies this Challenge.
    - `account_sid` string, nullable — The unique SID identifier of the Account.
    - `service_sid` string, nullable — The unique SID identifier of the Service.
    - `entity_sid` string, nullable — The unique SID identifier of the Entity.
    - `identity` string, nullable — Customer unique identity for the Entity owner of the Challenge. This identifier should be immutable, not PII, length between 8 and 64 characters, and generated by your external system, such as your user's UUID, GUID, or SID. It can only contain dash (-) separated alphanumeric characters.
    - `factor_sid` string, nullable — The unique SID identifier of the Factor.
    - `date_created` string, date-time, nullable — The date that this Challenge was created, given in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
    - `date_updated` string, date-time, nullable — The date that this Challenge was updated, given in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
    - `date_responded` string, date-time, nullable — The date that this Challenge was responded, given in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
    - `expiration_date` string, date-time, nullable — The date-time when this Challenge expires, given in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. The default value is five (5) minutes after Challenge creation. The max value is sixty (60) minutes after creation.
    - `status` 'pending' | 'expired' | 'approved' | 'denied' — The Status of this Challenge. One of `pending`, `expired`, `approved` or `denied`.
    - `responded_reason` 'none' | 'not_needed' | 'not_requested' — Reason for the Challenge to be in certain `status`. One of `none`, `not_needed` or `not_requested`.
    - `details` unknown
    - `hidden_details` unknown
    - `metadata` unknown
    - `factor_type` 'push' | 'totp' | 'passkeys' — The Factor Type of this Challenge. Currently `push` and `totp` are supported.
    - `url` string, uri, nullable — The URL of this resource.
    - `links` object, nullable — Contains a dictionary of URL links to nested resources of this Challenge.
  - `meta` object
    - `first_page_url` string, uri
    - `key` string
    - `next_page_url` string, uri, nullable
    - `page` integer
    - `page_size` integer
    - `previous_page_url` string, uri, nullable
    - `url` string, uri

## Changes

- **2025-08-18** (v2) `3fd4376faab5` — 1 warning
  - added the new `passkeys` enum value to the `challenges/items/factor_type` response property for the response status `200`
- **2025-07-03** (v2) `1548692e6804` — 3 breaking
  - the `challenges/items/details` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - the `challenges/items/hidden_details` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - the `challenges/items/metadata` response's property type/format changed from `object`/`` to ``/`` for status `200`
- **2025-03-11** (v2) `43e0e113369c` — 3 breaking
  - the `challenges/items/details` response's property type/format changed from ``/`` to `object`/`` for status `200`
  - the `challenges/items/hidden_details` response's property type/format changed from ``/`` to `object`/`` for status `200`
  - the `challenges/items/metadata` response's property type/format changed from ``/`` to `object`/`` for status `200`
- **2025-02-20** (v2) `b8075ab6f350` — 1 breaking
  - for the `query` request parameter `PageSize`, the type/format was changed from `integer`/`` to `integer`/`int64`
- **2023-08-10** (v2) `fb6ded97d73f` — 1 info
  - api tag `VerifyV2Challenge` added

[Change history](https://skmtc.dev/twilio/apis/verify-v2/changes/v2/Services/:ServiceSid/Entities/:Identity/Challenges/get.md)

---

[API](https://skmtc.dev/twilio/apis/verify-v2.md) · [All operations](https://skmtc.dev/twilio/apis/verify-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/twilio/verify-v2/revisions/995c3e7a8bfb/schema)