> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pokulabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Interaction Status

> Returns the current status for an interaction. Use this to poll an interaction created by an async request, such as an outbound call placed with `waitForCallEnd` set to `false`.



## OpenAPI

````yaml GET /interactions/{interactionId}/status
openapi: 3.1.0
info:
  title: Poku API
  version: 1.0.0
  description: OpenAPI document for the authenticated Poku API routes.
servers:
  - url: https://api.pokulabs.com
security:
  - bearerAuth: []
tags:
  - name: calls
  - name: messages
  - name: forms
  - name: interactions
  - name: numbers
  - name: webhooks
paths:
  /interactions/{interactionId}/status:
    get:
      tags:
        - interactions
      summary: Get Interaction Status
      description: >-
        Returns the current status for an interaction. Use this to poll an
        interaction created by an async request, such as an outbound call placed
        with `waitForCallEnd` set to `false`.
      operationId: getInteractionStatus
      parameters:
        - name: interactionId
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: The interaction ID returned by a Poku API request.
      responses:
        '200':
          description: Interaction status returned successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InteractionStatusResponse'
              examples:
                pending:
                  summary: Interaction still in progress
                  value:
                    interactionId: f3f7870f-30f5-4bf2-83b0-a05bc140030c
                    status: pending
                    createdAt: '2026-04-28T22:30:00.000Z'
                ended:
                  summary: Call interaction completed
                  value:
                    interactionId: f3f7870f-30f5-4bf2-83b0-a05bc140030c
                    status: ended
                    createdAt: '2026-04-28T22:30:00.000Z'
                    completionEvent:
                      event: call.conversation.ended
                      payload:
                        interactionId: f3f7870f-30f5-4bf2-83b0-a05bc140030c
                        summary: >-
                          ABC restaurant confirmed your reservation for 2 people
                          at 6 pm tomorrow.
                        from: '+12155551234'
                        to: '+14155550100'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  schemas:
    InteractionStatusResponse:
      type: object
      required:
        - interactionId
        - status
        - createdAt
      properties:
        interactionId:
          type: string
          format: uuid
          description: Unique identifier for the interaction.
        status:
          type: string
          enum:
            - pending
            - ended
          description: >-
            `pending` means Poku is still waiting for a response or call
            completion. `ended` means the interaction is complete or its
            response window has expired.
        createdAt:
          type: string
          format: date-time
          description: When the interaction was created.
        completionEvent:
          oneOf:
            - $ref: '#/components/schemas/MessageReceivedCompletionEvent'
            - $ref: '#/components/schemas/FormReceivedCompletionEvent'
            - $ref: '#/components/schemas/CallConversationEndedCompletionEvent'
          description: >-
            Present when the interaction completed with a response. The shape
            matches the corresponding webhook event payload.
      additionalProperties: false
    MessageReceivedCompletionEvent:
      type: object
      required:
        - event
        - payload
      properties:
        event:
          type: string
          enum:
            - message.received
        payload:
          type: object
          required:
            - interactionId
            - medium
            - from
            - to
            - body
          properties:
            interactionId:
              type: string
              format: uuid
            medium:
              $ref: '#/components/schemas/Medium'
            from:
              type: string
            to:
              type: string
            body:
              type: string
            mediaUrls:
              type: array
              items:
                type: string
                format: uri
          additionalProperties: false
      additionalProperties: false
    FormReceivedCompletionEvent:
      type: object
      required:
        - event
        - payload
      properties:
        event:
          type: string
          enum:
            - form.received
        payload:
          type: object
          required:
            - interactionId
            - values
          properties:
            interactionId:
              type: string
              format: uuid
            values:
              type: object
              additionalProperties: true
          additionalProperties: false
      additionalProperties: false
    CallConversationEndedCompletionEvent:
      type: object
      required:
        - event
        - payload
      properties:
        event:
          type: string
          enum:
            - call.conversation.ended
        payload:
          type: object
          required:
            - interactionId
            - summary
            - from
            - to
          properties:
            interactionId:
              type: string
              format: uuid
            summary:
              type: string
            from:
              type: string
            to:
              type: string
          additionalProperties: false
      additionalProperties: false
    ErrorResponse:
      type: object
      description: Generic error shape returned by Express error middleware.
      additionalProperties: true
    Medium:
      type: string
      enum:
        - sms
        - whatsapp
        - slack
  responses:
    NotFound:
      description: Requested resource was not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Authentication header containing your Poku API key. Find it in the [Poku
        dashboard](https://dashboard.pokulabs.com/). The format is "Bearer
        YOUR_API_KEY"

````