> ## Documentation Index > Fetch the complete documentation index at: https://docs.trata.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get a Specific Conversation by ID > Get a Specific Conversation by ID ## OpenAPI ````yaml openapi.json get /v1/conversations/{conversation_id} openapi: 3.1.0 info: title: Trata AI API description: >- Human like conversation to answer calls, drive engagement, automate follow-ups & schedule bookings 24/7 with end to end integrations ensuring you never miss a sales enquiry. version: 1.0.0 servers: - url: https://api.trata.ai description: Production - url: http://localhost:8000 description: Development security: [] paths: /v1/conversations/{conversation_id}: get: tags: - Conversations summary: Get a Specific Conversation by ID description: Get a Specific Conversation by ID operationId: getConversationV1 parameters: - name: conversation_id in: path required: true schema: type: string description: ID of the conversation title: Conversation Id description: ID of the conversation responses: '200': description: Conversation retrieved successfully content: application/json: schema: $ref: '#/components/schemas/Conversation-Output' example: orgId: org.1726902940.GZChqlpU prospectId: pro.1731301754.OZSMSU1S source: 35.191.28.74 sourceType: BROWSER aiAgentId: aia.1726903132.obUuT7vM transcriptText: - speaker: AI message: >- Hi, thanks for calling the Restaurant. I am Sophia, the Restaurant manager powered by AI, how may I assist you today? timestamp: '2024-11-11T05:06:21.049339' message_id: dia.1731301581.gTtTGu8J - speaker: USER message: Hey. timestamp: '2024-11-11T05:06:31.737515' message_id: Hey. - speaker: USER message: What do you actually do? timestamp: '2024-11-11T05:06:33.756877' message_id: What do you actually do? - speaker: AI message: >- Hi there! I'm Sophia, your virtual receptionist at Cote Korean Steak House. I'm here to help with table reservations, taking food orders for pickup or delivery, and providing information about our restaurant. How can I assist you today? timestamp: '2024-11-11T05:06:45.615287' message_id: dia.1731301593.fT6cGFVG - speaker: USER message: Okay. So I want to book an order. timestamp: '2024-11-11T05:06:51.225919' message_id: Okay. So I want to book an order. - speaker: USER message: Can you help me with your many options? timestamp: '2024-11-11T05:06:53.730469' message_id: Can you help me with your many options? - speaker: AI message: >- Of course! Let's get started with your order. Could you please tell me which dishes you're interested in ordering from our menu today? This will help me suggest more options or confirm your choices. timestamp: '2024-11-11T05:06:59.973358' message_id: dia.1731301613.bsgHIXmI - speaker: USER message: Okay. Can you tell me, like, timestamp: '2024-11-11T05:07:07.064393' message_id: Okay. Can you tell me, like, - speaker: USER message: are the menu options you have? timestamp: '2024-11-11T05:07:08.017518' message_id: are the menu options you have? - speaker: AI message: >- Certainly! At Cote Korean Steak House, we offer a variety of delicious Korean-inspired dishes. Could you let me know if you're looking for something specific, or would you like a recommendation? timestamp: '2024-11-11T05:07:14.763742' message_id: dia.1731301627.GvyyOv8z - speaker: USER message: >- Yeah. So recommendation would be helpful, and it has to be, like, timestamp: '2024-11-11T05:07:23.723846' message_id: >- Yeah. So recommendation would be helpful, and it has to be, like, - speaker: AI message: >- Certainly! At Cote Korean Steak House, we offer a variety of delicious Korean-inspired dishes. Could you let me know if you're looking for something specific, or would you like a recommendation? timestamp: '2024-11-11T05:07:14.763742' message_id: dia.1731301627.GvyyOv8z - speaker: USER message: >- Yeah. So recommendation would be helpful, and it has to be, like, timestamp: '2024-11-11T05:07:23.723846' message_id: >- Yeah. So recommendation would be helpful, and it has to be, like, - speaker: USER message: spicy. timestamp: '2024-11-11T05:07:24.471512' message_id: spicy. - speaker: AI message: >- I'd recommend trying our Spicy Beef Bulgogi or the Spicy Korean Chicken Wings. Both dishes pack a punch and are quite popular. Would you like to place an order for either of these spicy options? timestamp: '2024-11-11T05:07:31.442200' message_id: dia.1731301644.Ez3q1ui5 - speaker: USER message: Oh, yeah. So, spicy chicken wings that you mentioned. timestamp: '2024-11-11T05:07:40.424171' message_id: Oh, yeah. So, spicy chicken wings that you mentioned. - speaker: AI message: >- Great choice! Our Spicy Korean Chicken Wings are a customer favorite. Would you like to go ahead and place an order for those wings? timestamp: '2024-11-11T05:07:45.458102' message_id: dia.1731301660.pkrs8vlF - speaker: USER message: Yes. That's right. Go ahead and place the order. timestamp: '2024-11-11T05:07:51.744204' message_id: Yes. That's right. Go ahead and place the order. - speaker: AI message: >- Great! I'll place the order for our Spicy Korean Chicken Wings. Could you please provide your name, phone number, and whether this is for pickup or delivery? timestamp: '2024-11-11T05:07:57.954998' message_id: dia.1731301671.xmruoj53 - speaker: USER message: Yes. So I'll pick it up. My phone number is timestamp: '2024-11-11T05:08:05.574647' message_id: Yes. So I'll pick it up. My phone number is - speaker: USER message: '96260' timestamp: '2024-11-11T05:08:07.455466' message_id: '96260' - speaker: USER message: '12778.' timestamp: '2024-11-11T05:08:08.983412' message_id: '12778.' - speaker: USER message: And my name is Hari. timestamp: '2024-11-11T05:08:10.966606' message_id: And my name is Hari. - speaker: USER message: And my name is Hari. timestamp: '2024-11-11T05:08:10.966606' message_id: And my name is Hari. - speaker: AI message: >- Thank you, Hari! Your order for our Spicy Korean Chicken Wings is confirmed for pickup. It will be ready in the next 30-45 minutes. You will receive a confirmation text shortly. Is there anything else you'd like to add to your order? timestamp: '2024-11-11T05:08:19.965214' message_id: dia.1731301690.DkHamrVu - speaker: USER message: Nothing. All good. Thank you. timestamp: '2024-11-11T05:08:28.021255' message_id: Nothing. All good. Thank you. - speaker: AI message: Thanks for calling us, you have a great one! Bye timestamp: '2024-11-11T05:08:29.093613' message_id: dia.1731301709.wcahGaIm transcriptSummary: >- The caller, Hari, called to place an order at Cote Korean Steak House. He requested recommendations for spicy menu items and chose the Spicy Korean Chicken Wings for pick-up. His phone number is 96260-12778. The order is confirmed for pickup within 30-45 minutes. transcriptRecordingUrl: >- https://storage.googleapis.com/trata-staging-recordings-storage/org.1726902940.GZChqlpU/fil.1731301754.8FQUmNBJ.mp3 timestampStart: '2024-11-11T05:06:20.733912' timestampEnd: '2024-11-11T05:08:41.585099' conversationAnalytics: summary: >- The caller, Hari, called to place an order at Cote Korean Steak House. He requested recommendations for spicy menu items and chose the Spicy Korean Chicken Wings for pick-up. His phone number is 96260-12778. The order is confirmed for pickup within 30-45 minutes. action_items: - >- Confirm the order for Hari and prepare the Spicy Korean Chicken Wings for pickup. - Send a confirmation text to Hari about his order. is_audio_consent_given: false email_address_of_caller: hari@gmail.com name_of_caller: Hari phone_number_of_caller: 96260-12778 address_of_caller: 123, Main Street, New York, NY, 10001 sentiment_of_caller: positive prospectStatus: SERVICE_ORDER_PLACED status: active createdBy: trata-system createdAt: '2024-12-06T19:23:38.618331' updatedBy: trata-system updatedAt: '2024-12-06T19:23:38.618332' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - HTTPBearer: [] components: schemas: Conversation-Output: properties: id: type: string title: Id orgId: type: string title: Orgid prospectId: anyOf: - type: string - type: 'null' title: Prospectid source: type: string title: Source sourceType: type: string title: Sourcetype aiAgentId: type: string title: Aiagentid transcriptText: anyOf: - items: $ref: '#/components/schemas/DialogLine' type: array - type: 'null' title: Transcripttext transcriptSummary: anyOf: - type: string - type: 'null' title: Transcriptsummary transcriptRecordingUrl: anyOf: - type: string - type: 'null' title: Transcriptrecordingurl timestampStart: type: string format: date-time title: Timestampstart timestampEnd: anyOf: - type: string format: date-time - type: 'null' title: Timestampend conversationAnalytics: anyOf: - $ref: '#/components/schemas/ConversationAnalyticsModel' - type: 'null' description: Analytics of the conversation status: type: string title: Status createdBy: type: string title: Createdby createdAt: type: string format: date-time title: Createdat updatedBy: type: string title: Updatedby updatedAt: type: string format: date-time title: Updatedat type: object required: - status title: Conversation description: >- Any conversation happening between the end user and assistant is stored in this table HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError DialogLine: properties: speaker: type: string title: Speaker message: type: string title: Message timestamp: type: string format: date-time title: Timestamp message_id: type: string title: Message Id type: object required: - speaker - message - timestamp - message_id title: DialogLine ConversationAnalyticsModel: properties: summary: type: string title: Summary description: >- Summary of the conversation happened with important details on the conversation. The summary should be concise and to the point. It should contain the important details of the conversation like name, phone number, email, address and any other details shared by the user. action_items: anyOf: - items: type: string type: array - type: 'null' title: Action Items description: >- List of action items and the next steps to be performed from the conversation details. is_audio_consent_given: type: boolean title: Is Audio Consent Given description: >- If the user has given consent to store the audio of the conversation. Unless the user explicitly says yes, this should be false. email_address_of_caller: anyOf: - type: string - type: 'null' title: Email Address Of Caller description: >- Extracted email address of the caller from the conversation details. Email should be a valid email address format name_of_caller: anyOf: - type: string - type: 'null' title: Name Of Caller description: Extracted name of the caller from the conversation details. phone_number_of_caller: anyOf: - type: string - type: 'null' title: Phone Number Of Caller description: Extracted phone number of the caller from the conversation details. address_of_caller: anyOf: - type: string - type: 'null' title: Address Of Caller description: Extracted address of the caller from the conversation details. sentiment_of_caller: allOf: - $ref: '#/components/schemas/CallSentiment' description: Sentiment of the caller based on the conversation details. prospectStatus: anyOf: - $ref: '#/components/schemas/ProspectStatus' - type: 'null' description: Status of the prospect after this conversation. additionalProperties: false type: object required: - summary - action_items - is_audio_consent_given - email_address_of_caller - name_of_caller - phone_number_of_caller - address_of_caller - sentiment_of_caller - prospectStatus title: ConversationAnalyticsModel description: Expected output of the post conversation task ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError CallSentiment: type: string enum: - positive - negative - neutral title: CallSentiment ProspectStatus: type: string enum: - NEW - GENERAL_ENQUIRY - SCHEDULED_CALLBACK_WITH_BOT - SCHEDULED_APPOINTMENT_WITH_PERSON - SCHEDULED_APPOINTMENT_FOR_SERVICE - NOT_INTERESTED - PRODUCT_ORDER_PLACED - SERVICE_ORDER_PLACED title: ProspectStatus securitySchemes: HTTPBearer: type: http scheme: bearer ````