> ## Documentation Index > Fetch the complete documentation index at: https://docs.tetherai.ca/llms.txt > Use this file to discover all available pages before exploring further. # Get contact separation wizard data > Returns the contact plus all child records (conversations, applications, notes, reminders, training snapshots) needed to drive the admin Separation wizard. Admin/Superadmin only. ## OpenAPI ````yaml /api-reference/openapi.yaml get /api/contacts/{id}/separation-data openapi: 3.0.3 info: title: Tether Relay and Tether API version: 1.0.0 description: >- Route-derived OpenAPI contract generated from tether-relay backend sources. Regenerate with scripts/sync-openapi-from-backend.mjs. servers: - url: https://your-instance.example.com description: Production - url: http://localhost:2212 description: Local API service security: [] tags: - name: AI - name: Applications - name: Approval - name: Auth - name: Automations - name: Calls - name: Campaigns - name: Contact Analytics - name: Contact Metrics - name: Contact Notes - name: Contacts - name: Conversation Monitor - name: Conversations - name: Departments - name: Email - name: Escalation Dashboard - name: Event Logs - name: Google Sheets - name: Marketplace - name: Messages - name: Notification Sounds - name: Notifications - name: Org Snapshots - name: Organizations - name: Outreach - name: Outreach Metrics - name: Outreach Sources - name: Pipelines - name: Processes - name: Prompts - name: Reminders - name: Sms - name: Templates - name: Traces - name: Training - name: Upload - name: User Snapshots - name: Users - name: Vertical - name: Webchats - name: Webhook paths: /api/contacts/{id}/separation-data: get: tags: - Contacts summary: Get contact separation wizard data description: >- Returns the contact plus all child records (conversations, applications, notes, reminders, training snapshots) needed to drive the admin Separation wizard. Admin/Superadmin only. operationId: get_contact_separation_data parameters: - in: path name: id required: true schema: type: string responses: '200': description: Separation data returned content: application/json: schema: $ref: '#/components/schemas/ContactSeparationDataResponse' '400': description: Invalid contact id content: application/json: schema: $ref: '#/components/schemas/LegacyErrorResponse' '403': description: Caller is not admin content: application/json: schema: $ref: '#/components/schemas/LegacyErrorResponse' '404': description: Contact not found content: application/json: schema: $ref: '#/components/schemas/LegacyErrorResponse' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/LegacyErrorResponse' security: - bearerAuth: [] components: schemas: ContactSeparationDataResponse: type: object properties: success: type: boolean enum: - true data: type: object properties: contact: $ref: '#/components/schemas/ContactDto' conversations: type: array items: $ref: '#/components/schemas/ContactSeparationConversationSummary' applications: type: array items: $ref: '#/components/schemas/ContactSeparationApplicationSummary' contactNotes: type: array items: $ref: '#/components/schemas/ContactSeparationNoteSummary' reminders: type: array items: $ref: '#/components/schemas/ContactSeparationReminderSummary' trainingSnapshots: type: array items: $ref: '#/components/schemas/ContactSeparationTrainingSnapshotSummary' conversationMessages: type: object additionalProperties: type: array items: $ref: '#/components/schemas/SeparationMessageSummary' required: - contact - conversations - applications - contactNotes - reminders - trainingSnapshots - conversationMessages additionalProperties: true required: - success - data additionalProperties: true example: success: true data: contact: _id: 64f0a1b2c3d4e5f6a7b8c9d0 firstName: Jane lastName: Doe conversations: [] applications: [] contactNotes: [] reminders: [] trainingSnapshots: [] conversationMessages: {} LegacyErrorResponse: type: object properties: error: type: string message: type: string data: {} additionalProperties: true example: error: Attachment not found message: Attachment not found ContactDto: type: object properties: _id: type: string firstName: type: string nullable: true lastName: type: string nullable: true phoneNumber: nullable: true oneOf: - type: string - type: array items: $ref: '#/components/schemas/ContactPhoneNumber' secondaryPhoneNumber: type: array nullable: true items: type: string email: type: string nullable: true status: type: string nullable: true pipelineId: type: string nullable: true pipelineStage: type: string nullable: true organizationId: type: string nullable: true userId: type: string nullable: true createdBy: type: string nullable: true assignees: type: array items: {} createdAt: type: string format: date-time nullable: true updatedAt: type: string format: date-time nullable: true existingConversationId: type: string nullable: true description: >- Set on responses from /api/contacts/inactive when called with includeExisting=true. Identifies the caller-accessible conversation in the requested channel; clients should route to this conversation instead of creating a new one. additionalProperties: true example: _id: 64f0a1b2c3d4e5f6a7b8c9d0 firstName: Jane lastName: Doe phoneNumber: - value: '+14165550100' isPrimary: true secondaryPhoneNumber: [] email: jane.doe@example.com status: New Lead pipelineId: 64f0a1b2c3d4e5f6a7b8c9d1 pipelineStage: 64f0a1b2c3d4e5f6a7b8c9d2 organizationId: 64f0a1b2c3d4e5f6a7b8c9d3 userId: 64f0a1b2c3d4e5f6a7b8c9d4 createdBy: 64f0a1b2c3d4e5f6a7b8c9d4 assignees: - 64f0a1b2c3d4e5f6a7b8c9d4 createdAt: '2026-05-01T14:30:00.000Z' updatedAt: '2026-05-15T09:12:00.000Z' ContactSeparationConversationSummary: type: object properties: _id: type: string channelType: type: string messageCount: type: integer lastMessageTime: type: string format: date-time nullable: true assignees: type: array items: type: string required: - _id additionalProperties: true example: _id: 64f0a1b2c3d4e5f6a7b8c9e0 channelType: sms messageCount: 12 lastMessageTime: '2026-05-15T09:12:00.000Z' assignees: - 64f0a1b2c3d4e5f6a7b8c9d4 ContactSeparationApplicationSummary: type: object properties: _id: type: string status: type: string nullable: true pipelineStage: type: string nullable: true pipelineId: type: string nullable: true createdAt: type: string format: date-time nullable: true additionalProperties: true example: _id: 64f0a1b2c3d4e5f6a7b8c9f0 status: Submitted pipelineStage: 64f0a1b2c3d4e5f6a7b8c9f1 pipelineId: 64f0a1b2c3d4e5f6a7b8c9f2 createdAt: '2026-05-10T11:00:00.000Z' ContactSeparationNoteSummary: type: object properties: _id: type: string noteBody: type: string nullable: true userId: type: string nullable: true createdAt: type: string format: date-time nullable: true additionalProperties: true example: _id: 64f0a1b2c3d4e5f6a7b8c9f3 noteBody: Left voicemail; called back from home number. userId: 64f0a1b2c3d4e5f6a7b8c9d4 createdAt: '2026-05-12T16:00:00.000Z' ContactSeparationReminderSummary: type: object properties: _id: type: string note: type: string nullable: true reminderDate: type: string format: date-time nullable: true createdBy: type: string nullable: true additionalProperties: true example: _id: 64f0a1b2c3d4e5f6a7b8c9f4 note: Follow up on insurance docs reminderDate: '2026-05-20T17:00:00.000Z' createdBy: 64f0a1b2c3d4e5f6a7b8c9d4 ContactSeparationTrainingSnapshotSummary: type: object properties: _id: type: string category: type: string nullable: true quality: type: string nullable: true createdAt: type: string format: date-time nullable: true additionalProperties: true example: _id: 64f0a1b2c3d4e5f6a7b8c9f5 category: objection_handling quality: good createdAt: '2026-05-13T10:00:00.000Z' SeparationMessageSummary: type: object properties: _id: type: string body: type: string createdAt: type: string format: date-time isIncoming: type: boolean senderType: type: string required: - _id - body - createdAt - isIncoming - senderType additionalProperties: true example: _id: 64f0a1b2c3d4e5f6a7b8c9f6 body: Thanks, I will call you back tomorrow. createdAt: '2026-05-14T15:30:00.000Z' isIncoming: true senderType: contact ContactPhoneNumber: type: object properties: value: type: string isPrimary: type: boolean required: - value additionalProperties: true example: value: '+14165550100' isPrimary: true securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````