---
title: "Get onboarding criteria by role"
method: GET
path: "/api/onboarding/conversational/criteria/role/{role}"
tags: ["Onboarding"]
---

# Get onboarding criteria by role

`GET /api/onboarding/conversational/criteria/role/{role}`

## Request

- Base URL: `https://api.chipprofessionals.com`
- URL: `https://api.chipprofessionals.com/api/onboarding/conversational/criteria/role/{role}`
- Auth: HTTP bearer

Fetch active onboarding criteria configuration for the provided role

## Path parameters

- `role` 'Consumer' | 'Professional', required

## Response `200`

Successful operation

- SuccessResponse: Standard success response format
  - `success` boolean
  - `message` string
  - `data` unknown

## Other responses

- `401`: Unauthenticated
- `404`: No onboarding criteria found
- `422`: Role must be Consumer or Professional

---

[API](https://skmtc.dev/chipprofessionals/apis/chip-api-documentation.md) - [All operations](https://skmtc.dev/chipprofessionals/apis/chip-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/chipprofessionals/apis/chip-api-documentation/revisions/05e58f424c25?raw)