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

# Get the parsed content

> Returns the parsed content of a received message for one of its envelope recipients, with new download links for the attachments and the original message. Requires the permission "Read received messages". Limited to 60 requests per minute and API key.



## OpenAPI

````yaml /api-reference/openapi.yaml get /receiving/messages/{id}/content
openapi: 3.1.0
info:
  title: Talario API
  version: '1.0'
  description: REST API for received messages and webhook deliveries.
servers:
  - url: https://talario.eu/api/v1
security:
  - apiKey: []
tags:
  - name: Received messages
  - name: Webhook deliveries
paths:
  /receiving/messages/{id}/content:
    get:
      tags:
        - Received messages
      summary: Get the parsed content
      description: >-
        Returns the parsed content of a received message for one of its envelope
        recipients, with new download links for the attachments and the original
        message. Requires the permission "Read received messages". Limited to 60
        requests per minute and API key.
      operationId: getReceivedMessageContent
      parameters:
        - $ref: '#/components/parameters/MessageId'
        - name: recipient
          in: query
          description: >-
            Envelope recipient to show the content for, compared without regard
            to ASCII case. Required if the message has several recipients.
          schema:
            type: string
            maxLength: 255
      responses:
        '200':
          description: The parsed content.
          headers:
            Cache-Control:
              schema:
                type: string
                example: no-store, private
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ParsedContent'
        '401':
          $ref: '#/components/responses/Unauthenticated'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          description: >-
            `not_found`: unknown message, or the address is not a recipient of
            the message.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '409':
          description: >-
            `content_not_ready`: the message is still being parsed.
            `content_failed`: there is no parsed content and there will be none.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '410':
          $ref: '#/components/responses/MessageExpired'
        '422':
          description: >-
            `invalid_payload`: the message has several recipients and none is
            named.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '503':
          description: >-
            `content_unavailable`: the content cannot be read right now. Retry
            later.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  parameters:
    MessageId:
      name: id
      in: path
      required: true
      description: Talario's ID of the received message.
      schema:
        type: string
        format: uuid
  schemas:
    ParsedContent:
      type: object
      required:
        - schema_version
        - id
        - domain
        - received_at
        - expires_at
        - sender
        - from
        - recipient
        - to
        - cc
        - reply-to
        - subject
        - message-id
        - in-reply-to
        - references
        - body-plain
        - body-html
        - message-headers
        - attachment-count
        - attachments
        - content-id-map
        - parse_status
        - parse_warnings
        - content_omitted
        - download
      properties:
        schema_version:
          type: integer
          enum:
            - 2
        id:
          type: string
          format: uuid
        domain:
          type: string
        received_at:
          type: string
          format: date-time
        expires_at:
          type: string
          format: date-time
        sender:
          type: string
          description: SMTP envelope sender; empty for a null sender.
        from:
          type: string
        recipient:
          type: string
        to:
          type: string
        cc:
          type: string
        reply-to:
          type: string
        subject:
          type: string
        message-id:
          type: string
        in-reply-to:
          type: string
        references:
          type: array
          items:
            type: string
        body-plain:
          type: string
        body-html:
          type: string
          description: Not sanitized. Sanitize before display.
        message-headers:
          type: array
          items:
            type: array
            prefixItems:
              - type: string
              - type: string
            minItems: 2
            maxItems: 2
        attachment-count:
          type: integer
        attachments:
          type: array
          items:
            $ref: '#/components/schemas/Attachment'
        content-id-map:
          type: object
          additionalProperties:
            type: string
        parse_status:
          type: string
          enum:
            - parsed
            - failed
        parse_warnings:
          type: array
          items:
            type: string
            enum:
              - unknown_charset
              - decoding_replaced
              - duplicate_content_id
              - mime_invalid
              - mime_depth_exceeded
              - mime_parts_exceeded
              - attachments_exceeded
              - parsed_content_too_large
              - parser_timeout
        content_omitted:
          type: boolean
          enum:
            - false
        download:
          type: object
          required:
            - url
            - expires_at
            - size_bytes
            - sha256
          properties:
            url:
              type: string
              format: uri
            expires_at:
              type: string
              format: date-time
            size_bytes:
              type: integer
            sha256:
              type: string
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              example: message_expired
            message:
              type: string
            fields:
              type: object
              description: Invalid fields with their messages; only for `invalid_payload`.
              additionalProperties:
                type: array
                items:
                  type: string
    Attachment:
      type: object
      required:
        - id
        - name
        - content-type
        - size
        - sha256
        - disposition
        - content-id
        - url
        - expires_at
      properties:
        id:
          type: string
          example: part-2
        name:
          type: string
          example: booking.pdf
        content-type:
          type: string
          description: Declared by the sender; do not trust it.
        size:
          type: integer
        sha256:
          type: string
        disposition:
          type: string
          enum:
            - attachment
            - inline
        content-id:
          type:
            - string
            - 'null'
        url:
          type: string
          format: uri
        expires_at:
          type: string
          format: date-time
  responses:
    Unauthenticated:
      description: '`unauthenticated`: the API key is missing, invalid or revoked.'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: >-
        `forbidden`: the API key lacks the permission, or the project is
        suspended.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    MessageExpired:
      description: '`message_expired`: the retention period of the message ended.'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    TooManyRequests:
      description: '`too_many_requests`: a rate limit was exceeded.'
      headers:
        Retry-After:
          description: Seconds to wait before the next request.
          schema:
            type: integer
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: API key of your project, starting with `tlr_api_`.

````

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