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

# Fetch Designs

> Retrieve saved customer designs from a PitchPrint project with the runtime fetch-designs endpoint.



## OpenAPI

````yaml POST /runtime/fetch-designs
openapi: 3.1.0
info:
  title: PitchPrint Runtime API
  description: >-
    Server-side endpoints for fetching designs, projects and rendered files from
    your PitchPrint domain. Every /runtime/ call is authenticated with a
    signature computed as MD5(apiKey + secretKey + timestamp), sent as JSON in
    the request body. The timestamp is valid for a one-hour window.
  version: 9.0.0
servers:
  - url: https://api.pitchprint.io
security: []
paths:
  /runtime/fetch-designs:
    post:
      summary: Fetch Designs
      description: >-
        Fetch all the designs under a given category. Pass the `categoryId` of
        the category whose designs you want, along with the signature
        parameters. The response returns the category ID and an `items` array
        where each design includes its `designId`, `title`, `version`, `unit`,
        last-modified time and preview image URLs. Use a `designId` with [Fetch
        Design](/api-reference/fetch-design) to retrieve a single design's full
        source data.
      operationId: fetchDesigns
      requestBody:
        required: true
        content:
          application/json:
            schema:
              allOf:
                - $ref: '#/components/schemas/SignatureParams'
                - type: object
                  required:
                    - categoryId
                  properties:
                    categoryId:
                      type: string
                      description: ID of a design category.
                      example: cat-id
      responses:
        '200':
          description: The designs under the requested category.
          content:
            application/json:
              schema:
                type: object
              example:
                data:
                  categoryId: cat-id
                  items:
                    - designId: '******K83RU7R'
                      version: 9
                      unit: cm
                      lastModified: 1485934721
                      title: design title
                      previews:
                        - https://pitchprint.io/previews/design_id_1.jpg
                        - https://pitchprint.io/previews/design_id_2.jpg
components:
  schemas:
    SignatureParams:
      type: object
      required:
        - apiKey
        - timestamp
        - signature
      properties:
        apiKey:
          type: string
          description: Your domain's API key.
          example: your-api-key
        timestamp:
          type: integer
          description: >-
            UNIX timestamp (seconds since epoch) generated at request time.
            Valid for one hour.
          example: 1485934721
        signature:
          type: string
          description: MD5(apiKey + secretKey + timestamp).
          example: e2fc714c4727ee9395f324cd2e7f331f

````

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