---
title: "Search"
method: POST
path: "/api/v1/search/step-up/providers"
tags: ["Step Up Authentication Providers"]
---

# Search

`POST /api/v1/search/step-up/providers`

Search allows searching for step-up providers with various filters

## Request body

- C1ApiStepupV1SearchStepUpProvidersRequest — Request message for searching step-up providers
  - `pageSize` integer — Maximum number of results to return
  - `pageToken` string — Token for pagination
  - `providerType` 'PROVIDER_TYPE_UNSPECIFIED' | 'PROVIDER_TYPE_OAUTH2' | 'PROVIDER_TYPE_MICROSOFT' — The providerType field.
  - `query` string — Filter by name (partial match)
  - `refs` C1ApiStepupV1StepUpProviderRef[], nullable — Filter to specific providers by their references.
    - `id` string — The unique identifier of the step-up provider.

## Response `200`

Response message for searching step-up providers

- C1ApiStepupV1SearchStepUpProvidersResponse — Response message for searching step-up providers
  - `list` C1ApiStepupV1StepUpProvider[], nullable — List of providers matching the search criteria
    - `clientId` string — The OAuth2 client ID used to authenticate with the step-up provider.
    - `createdAt` string, date-time, nullable
    - `displayName` string — The human-readable name of the step-up provider.
    - `enabled` boolean — Whether the step-up provider is active and available for use.
    - `id` string — The unique identifier of the step-up provider.
    - `issuerUrl` string — The OIDC issuer URL for the step-up provider.
    - `lastTestedAt` string, date-time, nullable
    - `microsoft` C1ApiStepupV1StepUpMicrosoftSettings — StepUpMicrosoftSettings configures a Microsoft Entra step-up provider using Conditional Access.
      - `conditionalAccessIds` string[], nullable — Authentication context IDs (C1-C99). Required for ACRS mode; ignored for OIDC mode.
      - `tenant` string — Microsoft Entra tenant ID (GUID or domain). Used for response validation.
      - `validationMode` 'MICROSOFT_VALIDATION_MODE_UNSPECIFIED' | 'MICROSOFT_VALIDATION_MODE_ACRS' | 'MICROSOFT_VALIDATION_MODE_OIDC' — Validation approach. See MicrosoftValidationMode for details on each mode.
    - `oauth2` C1ApiStepupV1StepUpOAuth2Settings — StepUpOAuth2Settings repersents an OAuth2 provider that supports RFC 9470 <https://www.rfc-editor.org/rfc/rfc9470> Common ACR values for OAuth2 providers include: - "urn:okta:loa:1fa:any" (okta) - "urn:okta:loa:1fa:pwd" (okta) - "urn:okta:loa:2fa:any" (okta) - "urn:okta:loa:2fa:any:ifpossible" (okta) - "phr" (okta) - "phrh" (okta)
      - `acrValues` string[], nullable — The acrValues field.
    - `updatedAt` string, date-time, nullable
  - `nextPageToken` string — Token for retrieving the next page of results

---

[API](https://skmtc.net/conductorone/apis/c1-api.md) · [All operations](https://skmtc.net/conductorone/apis/c1-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/conductorone/c1-api/revisions/f2cf3228f366/schema)