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

# List uploaded images

> Lists uploaded images with account storage usage. Passing `page` or `limit` switches to a paginated response: an optional `q` name filter applies across the whole library and the response gains a `pagination` object.



## OpenAPI

````yaml /openapi.json get /marketing/assets
openapi: 3.0.0
info:
  title: JetEmail API
  version: 1.0.0
  description: API documentation for JetEmail's transactional email service.
servers:
  - url: https://api.jetemail.com
    description: Production
security:
  - apiKeyAuth: []
tags:
  - name: Email
    description: Send transactional email
  - name: Outbound
    description: 'Outbound sending: keys, SMTP users, domains, logs, suppression'
  - name: Inbound
    description: Inbound routing, domains and forward destinations
  - name: Marketing
    description: >-
      Marketing suite: templates, audiences, contacts, broadcasts, themes,
      assets
externalDocs:
  description: Download OpenAPI Specification
  url: /openapi.json
paths:
  /marketing/assets:
    get:
      tags:
        - Marketing
      summary: List uploaded images
      description: >-
        Lists uploaded images with account storage usage. Passing `page` or
        `limit` switches to a paginated response: an optional `q` name filter
        applies across the whole library and the response gains a `pagination`
        object.
      parameters:
        - name: page
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            default: 1
          description: Page number (enables pagination)
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 25
          description: Rows per page (enables pagination)
        - name: q
          in: query
          required: false
          schema:
            type: string
          description: Filter by file name substring (paginated mode only)
      responses:
        '200':
          description: Assets and account storage usage
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  assets:
                    type: array
                    items:
                      $ref: '#/components/schemas/MarketingAsset'
                  storage:
                    $ref: '#/components/schemas/MarketingAssetStorage'
                  pagination:
                    type: object
                    description: Present in paginated mode
                    properties:
                      page:
                        type: integer
                      limit:
                        type: integer
                      total_count:
                        type: integer
                      has_next_page:
                        type: boolean
                      showing_from:
                        type: integer
                      showing_to:
                        type: integer
components:
  schemas:
    MarketingAsset:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        url:
          type: string
          description: Public image URL
          example: https://jetemailassets.com/abc/2026/07/xyz.png
        content_type:
          type: string
          example: image/png
        size:
          type: integer
          description: Bytes
        created_at:
          type: integer
    MarketingAssetStorage:
      type: object
      properties:
        usedBytes:
          type: integer
          description: Bytes counted against the account storage quota
        limitBytes:
          type: integer
          description: Account storage quota in bytes
        remainingBytes:
          type: integer
          description: Bytes remaining before uploads are blocked
        paid:
          type: boolean
          description: Whether the paid marketing-plan quota applies
  securitySchemes:
    apiKeyAuth:
      type: http
      scheme: bearer
      description: API key for account management endpoints. Use your api_ prefixed token.

````