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

# Retrieve a stored response

> Returns a response stored when data store is enabled on the model. See [Responses](/examples/responses).



## OpenAPI

````yaml /api-reference/responses.json get /v1/responses/{response_id}
openapi: 3.1.0
info:
  title: SynapsAI Responses API
  version: 1.0.0
servers:
  - url: https://api.synapsai.cloud
    description: Production server
security: []
paths:
  /v1/responses/{response_id}:
    get:
      summary: Retrieve a stored response
      description: >-
        Returns a response stored when data store is enabled on the model. See
        [Responses](/examples/responses).
      operationId: retrieveResponse
      parameters:
        - name: response_id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Stored response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponsesResponse'
        '404':
          description: No stored response with this id
components:
  schemas:
    ResponsesResponse:
      type: object
      description: OpenAI-compatible response object returned by the Responses API.
      properties:
        id:
          type: string
          description: Unique identifier for this response.
        object:
          type: string
          default: response
          description: Object type. Always `response`.
        created_at:
          type: integer
          description: Unix timestamp (seconds) when the response was created.
        model:
          type: string
          description: Model identifier used to generate the response.
        status:
          type: string
          enum:
            - completed
            - failed
            - in_progress
            - incomplete
            - cancelled
          description: Status of the response generation.
        output:
          type: array
          items:
            $ref: '#/components/schemas/ResponseOutputItem'
          description: >-
            Typed output items produced by the model (for example, messages,
            function calls, or reasoning items).
        output_text:
          type: string
          nullable: true
          description: >-
            Convenience field containing concatenated text output from the
            response.
        instructions:
          type: string
          nullable: true
          description: System or developer instructions used for this response.
        usage:
          $ref: '#/components/schemas/ChatUsage'
          nullable: true
          description: Token usage details for the request.
        error:
          type: object
          nullable: true
          properties:
            code:
              type: string
              description: Error code.
            message:
              type: string
              description: Human-readable error description.
          description: Error details when generation fails.
        incomplete_details:
          type: object
          nullable: true
          properties:
            reason:
              type: string
              enum:
                - max_output_tokens
                - content_filter
              description: Why the response is incomplete.
          description: Details about why the response ended before completion.
      required:
        - id
        - object
        - created_at
        - model
        - status
        - output
    ResponseOutputItem:
      type: object
      description: >-
        A typed item in the response `output` array (for example, a message,
        function call, or reasoning item).
      properties:
        id:
          type: string
          description: Unique identifier for this output item.
        type:
          type: string
          description: >-
            Item type discriminator (for example, `message`, `function_call`,
            `reasoning`).
        role:
          type: string
          description: Role for message output items (for example, `assistant`).
        status:
          type: string
          enum:
            - in_progress
            - completed
            - incomplete
          description: Status of this output item.
        content:
          type: array
          items:
            type: object
            additionalProperties: true
          description: Content parts for message output items.
        call_id:
          type: string
          description: Identifier for function tool calls.
        name:
          type: string
          description: Function name for function call output items.
        arguments:
          type: string
          description: JSON-encoded arguments for function call output items.
      additionalProperties: true
    ChatUsage:
      type: object
      description: Token usage counts for chat completions.
      properties:
        prompt_tokens:
          type: integer
          description: Number of tokens consumed by the input messages.
        completion_tokens:
          type: integer
          description: Number of tokens generated by the assistant in the response.
        total_tokens:
          type: integer
          description: Total tokens consumed for the chat request.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.