> ## Documentation Index
> Fetch the complete documentation index at: https://supermemory-claude-naughty-bhaskara-7bc56a.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get document

> Get a document by ID



## OpenAPI

````yaml https://api.supermemory.ai/v3/openapi get /v3/documents/{id}
openapi: 3.1.0
info:
  title: supermemory API
  description: The Memory API for the AI era
  version: 3.0.0
servers:
  - description: Production Server
    url: https://api.supermemory.ai
security:
  - bearerAuth: []
tags:
  - name: Ingest
    description: Ingest documents, files, URLs, conversations, and other content
  - name: Recall (Search)
    description: >-
      Semantic recall across your content — supports memories, hybrid, and
      documents modes
  - name: Profiles
    description: >-
      Entity profiles for users, participants, or any entity — includes profile
      search
  - name: Content Management
    description: List, get, update, and delete content and memories
  - name: Spaces
    description: Organize content into spaces (container tags)
  - name: Knowledge Graph
    description: Knowledge graph and entity relationships
  - name: Connections
    description: External service integrations
  - name: Settings
    description: Organization settings
  - name: Analytics
    description: Usage analytics and insights
  - name: Documents
    description: List, get, and search documents
paths:
  /v3/documents/{id}:
    get:
      tags:
        - Documents
      summary: Get document
      description: Get a document by ID
      operationId: getV3DocumentsById
      parameters:
        - in: path
          name: id
          schema:
            type: string
          required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  connectionId:
                    anyOf:
                      - anyOf:
                          - type: string
                            minLength: 22
                            maxLength: 22
                          - type: 'null'
                        description: >-
                          Optional ID of connection the document was created
                          from. This is useful for identifying the source of the
                          document.
                        example: conn_gdrive_8f2k
                      - type: 'null'
                  content:
                    anyOf:
                      - type: string
                        description: >-
                          The content to extract and process into a document.
                          This can be a URL to a website, a PDF, an image, or a
                          video. 


                          Plaintext: Any plaintext format


                          URL: A URL to a website, PDF, image, or video


                          We automatically detect the content type from the
                          url's response format.
                        examples:
                          - >-
                            Our API rate limits are 100 req/min on free and 1000
                            on pro. Clients should use exponential backoff on
                            429s.
                          - https://docs.example.com/guides/authentication
                          - https://youtube.com/watch?v=dQw4w9WgXcQ
                          - https://example.com/podcasts/episode-42.mp3
                          - https://example.com/reports/q3-summary.pdf
                          - https://example.com/diagrams/architecture.png
                      - type: 'null'
                  containerTags:
                    readOnly: true
                    description: >-
                      Optional tags this document should be containerized by.
                      This can be an ID for your user, a project ID, or any
                      other identifier you wish to use to group documents.
                    deprecated: true
                    hidden: true
                    type: array
                    items:
                      type: string
                  createdAt:
                    type: string
                    description: Creation timestamp
                    example: '1970-01-01T00:00:00.000Z'
                    format: datetime
                  customId:
                    anyOf:
                      - type: string
                        maxLength: 255
                        description: >-
                          Optional custom ID of the document. This could be an
                          ID from your database that will uniquely identify this
                          document.
                        example: doc-api-rate-limits
                      - type: 'null'
                  id:
                    type: string
                    minLength: 22
                    maxLength: 22
                    description: Unique identifier of the document.
                    example: acxV5LHMEsG2hMSNb4umbn
                  metadata:
                    anyOf:
                      - anyOf:
                          - anyOf:
                              - type: string
                              - type: number
                              - type: boolean
                              - type: 'null'
                          - type: object
                            propertyNames:
                              type: string
                            additionalProperties: {}
                          - type: array
                            items: {}
                        description: >-
                          Optional metadata for the document. This is used to
                          store additional information about the document. You
                          can use this to store any additional information you
                          need about the document. Metadata can be filtered
                          through. Keys must be strings and are case sensitive.
                          Values can be strings, numbers, or booleans. You
                          cannot nest objects.
                        example:
                          source: upload
                          language: en
                      - type: 'null'
                  ogImage:
                    anyOf:
                      - type: string
                      - type: 'null'
                  raw:
                    anyOf:
                      - description: Raw content of the document
                        example: >-
                          Our API rate limits are 100 req/min on free and 1000
                          on pro. Clients should use exponential backoff on
                          429s.
                      - type: 'null'
                  source:
                    anyOf:
                      - type: string
                        maxLength: 255
                        description: Source of the document
                        example: text
                      - type: 'null'
                  taskType:
                    description: >-
                      Task type: "memory" (default) for full context layer with
                      SuperRAG built in, "superrag" for managed RAG as a
                      service.
                    example: memory
                    type: string
                    enum:
                      - memory
                      - superrag
                  status:
                    type: string
                    enum:
                      - unknown
                      - queued
                      - extracting
                      - chunking
                      - embedding
                      - indexing
                      - done
                      - failed
                    description: Status of the document
                    example: done
                  dreamingStatus:
                    type: string
                    enum:
                      - dreaming
                      - done
                  summary:
                    anyOf:
                      - type: string
                        description: Summary of the document content
                        example: >-
                          API rate limit policy: 100 req/min free, 1000 req/min
                          pro.
                      - type: 'null'
                  title:
                    anyOf:
                      - type: string
                        description: Title of the document
                        example: API Rate Limiting Policy
                      - type: 'null'
                  type:
                    type: string
                    enum:
                      - text
                      - pdf
                      - tweet
                      - google_doc
                      - google_slide
                      - google_sheet
                      - image
                      - video
                      - audio
                      - notion_doc
                      - webpage
                      - onedrive
                      - github_markdown
                      - granola
                    description: Type of the document
                    example: text
                  updatedAt:
                    type: string
                    description: Last update timestamp
                    example: '1970-01-01T00:00:00.000Z'
                    format: datetime
                  url:
                    anyOf:
                      - anyOf:
                          - type: string
                          - type: 'null'
                        description: URL of the document
                        example: https://docs.example.com/guides/rate-limits
                      - type: 'null'
                  filepath:
                    anyOf:
                      - type: string
                      - type: 'null'
                required:
                  - connectionId
                  - content
                  - createdAt
                  - customId
                  - id
                  - metadata
                  - ogImage
                  - raw
                  - source
                  - taskType
                  - status
                  - dreamingStatus
                  - summary
                  - title
                  - type
                  - updatedAt
                  - filepath
                description: Document object
                example:
                  id: acxV5LHMEsG2hMSNb4umbn
                  content: Our API rate limits are 100 req/min on free and 1000 on pro.
                  title: API Rate Limiting Policy
                  summary: 'API rate limit policy: 100 req/min free, 1000 req/min pro.'
                  status: done
                  type: text
                  metadata:
                    source: upload
                    language: en
                  createdAt: '2025-04-15T09:30:00.000Z'
                  updatedAt: '2025-04-15T09:31:00.000Z'
          description: Successfully retrieved document
        '401':
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
                    description: Error message
                  details:
                    type: string
                    description: Additional error details
                additionalProperties: false
          description: Unauthorized
        '404':
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
                    description: Error message
                  details:
                    type: string
                    description: Additional error details
                additionalProperties: false
          description: Document not found
        '500':
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
                    description: Error message
                  details:
                    type: string
                    description: Additional error details
                additionalProperties: false
          description: Internal server error
components:
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````