> ## Documentation Index > Fetch the complete documentation index at: https://docs.ontora.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Interview Detail > Get interview with contacts and question sets in a single call. This is much more efficient than calling separate endpoints, as it reduces the number of database roundtrips and auth checks. ## OpenAPI ````yaml /openapi.json get /v1/interviews/{interview_id}/detail openapi: 3.1.0 info: title: Ontora API description: >- Ontora's public API. Covers interview campaigns, transcripts, synthesis reports, graph queries, webhooks, and workspace management. **Authentication**: endpoints accept either a Clerk JWT (`Authorization: Bearer `) or a workspace API key (`X-API-Key: ont_...`). Workspace keys are managed via `/v1/api-keys`. version: 0.1.0 servers: [] security: - ClerkJWT: [] - WorkspaceApiKey: [] tags: - name: interviews description: Campaign CRUD, lifecycle, contacts, question sets. - name: campaign-insights description: Synthesis outputs — cartography, roadmap, personas, conversations. - name: interview-query description: Graph RAG query over campaign data. - name: interview-export description: Markdown / ZIP exports of transcripts and reports. - name: api-keys description: Manage workspace-scoped API keys for programmatic access. - name: webhook-endpoints description: Outbound webhook endpoints for automation. - name: booking description: Public self-scheduling endpoints for interview participants. - name: workspaces description: Workspace and membership management. - name: vaults description: Context vault management. paths: /v1/interviews/{interview_id}/detail: get: tags: - interviews summary: Get Interview Detail description: |- Get interview with contacts and question sets in a single call. This is much more efficient than calling separate endpoints, as it reduces the number of database roundtrips and auth checks. operationId: get_interview_detail_v1_interviews__interview_id__detail_get parameters: - name: interview_id in: path required: true schema: type: string format: uuid title: Interview Id - name: X-API-Key in: header required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Key responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/InterviewDetailOut' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - HTTPBearer: [] components: schemas: InterviewDetailOut: properties: interview: $ref: '#/components/schemas/InterviewOut' contacts: items: $ref: '#/components/schemas/app__api__interview_schemas__ContactOut' type: array title: Contacts question_sets: items: $ref: '#/components/schemas/QuestionSetOut' type: array title: Question Sets type: object required: - interview - contacts - question_sets title: InterviewDetailOut description: >- Combined response with interview, contacts, and question sets in one call. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError InterviewOut: properties: id: type: string format: uuid title: Id workspace_id: type: string format: uuid title: Workspace Id project_id: anyOf: - type: string format: uuid - type: 'null' title: Project Id name: type: string title: Name description: anyOf: - type: string - type: 'null' title: Description goal: anyOf: - type: string - type: 'null' title: Goal agent_behavior: anyOf: - type: string - type: 'null' title: Agent Behavior status: type: string title: Status channel: type: string title: Channel completion_threshold: type: integer title: Completion Threshold timeframe_start: anyOf: - type: string format: date-time - type: 'null' title: Timeframe Start timeframe_end: anyOf: - type: string format: date-time - type: 'null' title: Timeframe End interview_order: type: string title: Interview Order interview_duration_minutes: type: integer title: Interview Duration Minutes timezone: anyOf: - type: string - type: 'null' title: Timezone start_immediately: type: boolean title: Start Immediately default: true scheduling_mode: type: string title: Scheduling Mode default: availability quick_mode_hours: anyOf: - type: integer - type: 'null' title: Quick Mode Hours weekly_availability: anyOf: - additionalProperties: true type: object - type: 'null' title: Weekly Availability project_context: anyOf: - type: string - type: 'null' title: Project Context success_criteria: anyOf: - type: string - type: 'null' title: Success Criteria interview_context_for_employee: anyOf: - type: string - type: 'null' title: Interview Context For Employee interview_type: anyOf: - type: string - type: 'null' title: Interview Type welcome_screen: anyOf: - type: string - type: 'null' title: Welcome Screen closing_message: anyOf: - type: string - type: 'null' title: Closing Message folder: anyOf: - type: string - type: 'null' title: Folder recurring_interval: anyOf: - type: string - type: 'null' title: Recurring Interval contact_count: type: integer title: Contact Count default: 0 completed_count: type: integer title: Completed Count default: 0 scheduled_count: type: integer title: Scheduled Count default: 0 created_by: anyOf: - type: string - type: 'null' title: Created By created_at: type: string format: date-time title: Created At updated_at: type: string format: date-time title: Updated At type: object required: - id - workspace_id - project_id - name - description - goal - agent_behavior - status - channel - completion_threshold - timeframe_start - timeframe_end - interview_order - interview_duration_minutes - created_by - created_at - updated_at title: InterviewOut app__api__interview_schemas__ContactOut: properties: id: type: string format: uuid title: Id interview_id: type: string format: uuid title: Interview Id question_set_id: anyOf: - type: string format: uuid - type: 'null' title: Question Set Id name: type: string title: Name email: anyOf: - type: string - type: 'null' title: Email phone: anyOf: - type: string - type: 'null' title: Phone job_title: anyOf: - type: string - type: 'null' title: Job Title department: anyOf: - type: string - type: 'null' title: Department seniority_level: anyOf: - type: integer - type: 'null' title: Seniority Level is_required: type: boolean title: Is Required meeting_url: anyOf: - type: string - type: 'null' title: Meeting Url booking_token: anyOf: - type: string - type: 'null' title: Booking Token status: type: string title: Status reminder_count: type: integer title: Reminder Count default: 0 last_reminder_at: anyOf: - type: string format: date-time - type: 'null' title: Last Reminder At scheduled_at: anyOf: - type: string format: date-time - type: 'null' title: Scheduled At completed_at: anyOf: - type: string format: date-time - type: 'null' title: Completed At created_at: type: string format: date-time title: Created At type: object required: - id - interview_id - question_set_id - name - email - phone - job_title - department - seniority_level - is_required - meeting_url - status - scheduled_at - completed_at - created_at title: ContactOut QuestionSetOut: properties: id: type: string format: uuid title: Id interview_id: type: string format: uuid title: Interview Id name: type: string title: Name description: anyOf: - type: string - type: 'null' title: Description sort_order: type: integer title: Sort Order questions: items: $ref: '#/components/schemas/QuestionOut' type: array title: Questions default: [] created_at: type: string format: date-time title: Created At type: object required: - id - interview_id - name - description - sort_order - created_at title: QuestionSetOut ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError QuestionOut: properties: id: type: string format: uuid title: Id question_set_id: type: string format: uuid title: Question Set Id question_text: type: string title: Question Text is_required: type: boolean title: Is Required sort_order: type: integer title: Sort Order created_at: type: string format: date-time title: Created At type: object required: - id - question_set_id - question_text - is_required - sort_order - created_at title: QuestionOut securitySchemes: ClerkJWT: type: http scheme: bearer bearerFormat: JWT description: Clerk-issued RS256 JWT. WorkspaceApiKey: type: apiKey in: header name: X-API-Key description: 'Workspace-scoped API key (prefix: `ont_`).' HTTPBearer: type: http scheme: bearer ````