> ## Documentation Index > Fetch the complete documentation index at: https://docs.userintuition.ai/llms.txt > Use this file to discover all available pages before exploring further. # List Studies > List studies visible to this account with pagination and optional filters. ## OpenAPI ````yaml /api-reference/openapi.json get /api/public/v1/studies/ openapi: 3.1.0 info: title: User Intuition Public API description: >- ## Public Integration API Programmatic access to User Intuition for external integrators: manage studies, participants, interviews, reports, and panels. ### Authentication All endpoints require a Bearer token — either an API key (prefixed `ui_sk_`, created in the dashboard) or a dashboard JWT: ``` Authorization: Bearer ``` ### Base URLs - **Production:** `https://api.userintuition.ai` - **Staging:** `https://staging.userintuition.ai` ### Support For API support, contact support@userintuition.ai version: 1.0.0 contact: name: User Intuition Support email: support@userintuition.ai servers: - url: https://api.userintuition.ai description: Production - url: https://staging.userintuition.ai description: Staging security: - BearerAuth: [] paths: /api/public/v1/studies/: get: tags: - public-studies summary: List Studies description: >- List studies visible to this account with pagination and optional filters. operationId: listStudies parameters: - name: page in: query required: false schema: type: integer minimum: 1 default: 1 title: Page example: 1 - name: page_size in: query required: false schema: type: integer maximum: 100 minimum: 1 default: 20 title: Page Size example: 20 - name: name in: query required: false schema: anyOf: - type: string - type: 'null' description: Filter by name title: Name description: Filter by name example: Appliance - name: status in: query required: false schema: anyOf: - type: string - type: 'null' description: 'Filter by provisioning status: draft, ready, provisioned' title: Status description: 'Filter by provisioning status: draft, ready, provisioned' - name: recruiting_method in: query required: false schema: anyOf: - type: string - type: 'null' description: Filter by panel, byop, or synthetic_respondents title: Recruiting Method description: Filter by panel, byop, or synthetic_respondents - name: created_after in: query required: false schema: anyOf: - type: string format: date-time - type: 'null' title: Created After - name: has_report in: query required: false schema: anyOf: - type: boolean - type: 'null' title: Has Report - name: X-UI-Organization-ID in: header required: false schema: anyOf: - type: string maxLength: 128 - type: 'null' description: >- Platform admins only: choose an organization for scoped reads and writes. Required to change another organization's study or use its wallet. title: X-Ui-Organization-Id description: >- Platform admins only: choose an organization for scoped reads and writes. Required to change another organization's study or use its wallet. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/PublicStudyList' '422': description: Public API error. X-Request-ID matches error.request_id. content: application/json: schema: $ref: '#/components/schemas/PublicApiErrorResponse' default: description: Public API error. X-Request-ID matches error.request_id. content: application/json: schema: $ref: '#/components/schemas/PublicApiErrorResponse' components: schemas: PublicStudyList: properties: studies: items: $ref: '#/components/schemas/PublicStudySummary' type: array title: Studies total_count: type: integer title: Total Count page: anyOf: - type: integer - type: 'null' title: Page page_size: anyOf: - type: integer - type: 'null' title: Page Size type: object required: - studies - total_count title: PublicStudyList PublicApiErrorResponse: type: object required: - detail - error properties: detail: description: Legacy error detail; may be a string, list, or object. error: $ref: '#/components/schemas/PublicApiError' PublicStudySummary: properties: id: type: string title: Id name: anyOf: - type: string maxLength: 40 - type: 'null' title: Name study_type: type: string enum: - in-depth-interview - concept-test - prototype-test title: Study Type description: Current study-type template slug use_case: anyOf: - type: string - type: 'null' title: Use Case description: Historical study-type label when it is outside the current catalog recruiting_method: anyOf: - type: string enum: - panel - byop - synthetic_respondents - type: 'null' enum: - panel - byop - synthetic_respondents title: Recruiting Method description: panel, byop, or synthetic_respondents interview_format: anyOf: - type: string enum: - chat - video - voice - type: 'null' title: Interview Format description: chat, video, or voice voice: anyOf: - type: string enum: - male - female - type: 'null' title: Voice description: male or female language: anyOf: - type: string - type: 'null' title: Language description: Interview language code, e.g. 'en' expected_duration_seconds: type: integer minimum: 300 title: Expected Duration Seconds description: >- Maximum planned interview duration in seconds, including transitions and likely follow-up probes. This is an estimate, not a guaranteed length. default: 900 byop_config: $ref: '#/components/schemas/PublicByopConfigOut' study_link: anyOf: - type: string - type: 'null' title: Study Link description: >- Live participant interview link; null until the interviewer is provisioned. This is not a researcher preview URL. dashboard_url: anyOf: - type: string - type: 'null' title: Dashboard Url description: Researcher management link for the study provisioning_status: type: string enum: - draft - ready - provisioned title: Provisioning Status description: >- draft when required interviewer settings are missing, ready when the study can be provisioned, and provisioned when interviews can run fielding_status: type: string enum: - not_started - starting - collecting - fielding - paused - complete - partial - failed - stopped - unavailable - not_applicable - unknown title: Fielding Status description: >- Recruitment state, separate from interviewer provisioning. Panel studies report their persisted lifecycle. BYOP studies are collecting once the interviewer is provisioned, and can be paused or stopped; invitation delivery is tracked per participant. Synthetic respondents are not_applicable. missing_requirements: items: type: string type: array title: Missing Requirements description: Fields still required before the study can be provisioned created_at: anyOf: - type: string format: date-time - type: 'null' title: Created At updated_at: anyOf: - type: string format: date-time - type: 'null' title: Updated At interview_count: anyOf: - type: integer - type: 'null' title: Interview Count description: >- Completed visible non-test interviews satisfying quality criteria, matching list_interviews(status=completed). report_status: anyOf: - type: string enum: - available - not_generated - type: 'null' title: Report Status type: object required: - id - study_type - provisioning_status - fielding_status title: PublicStudySummary description: |- Lightweight study shape returned by the list endpoint (heavy fields such as the study plan and screener questions are stripped — fetch by id). PublicApiError: type: object required: - code - message - field - request_id - outcome - recovery_action - docs_url properties: code: type: string message: type: string field: anyOf: - type: string - type: 'null' request_id: type: string format: uuid outcome: type: string enum: - not_started - failed - unknown recovery_action: type: string docs_url: type: string format: uri PublicByopConfigOut: properties: incentive_amount: anyOf: - type: number - type: 'null' title: Incentive Amount is_incentives_enabled: anyOf: - type: boolean - type: 'null' title: Is Incentives Enabled auto_send_incentives: anyOf: - type: boolean - type: 'null' title: Auto Send Incentives type: object title: PublicByopConfigOut securitySchemes: BearerAuth: type: http scheme: bearer description: >- Authenticate with an API key (prefixed `ui_sk_`) or a JWT token from the dashboard. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.