Gelato

Gelato operates a global, distributed print-on-demand production network that lets ecommerce sellers produce and ship products locally in 30+ countries. The Gelato API exposes REST endpoints across dedicated subdomains for orders, the product catalog, pricing and stock, shipment methods, ecommerce store products and templates, plus webhooks - all authenticated with an X-API-KEY header.

6 APIs 0 Features

Print on DemandEcommerceFulfillmentDistributed ProductionOrders

APIs

Gelato Orders API

Create, retrieve, search, patch (draft to order), quote, and cancel print-on-demand orders for fulfillment through Gelato's global production network, using the v4 Orders endpoi...

Gelato Product Catalog API

List and retrieve product catalogs, search products within a catalog, and fetch individual product and cover-dimension details from the v3 Product Catalog endpoints under produc...

Gelato Prices and Stock API

Retrieve quantity-based prices for a product and check regional stock availability for stock-able products via the v3 prices and stock endpoints under product.gelatoapis.com.

Gelato Shipment API

List the shipment methods Gelato provides - with type, tracking support, and supported countries - optionally filtered by destination country, via the v1 shipment endpoint under...

Gelato Ecommerce API

Manage connected store products and templates - list and get store products, create products from a template, and retrieve template details - via the v1 ecommerce endpoints unde...

Gelato Webhooks API

Subscribe to JSON event callbacks for order and store-product lifecycle changes - including order_status_updated, order_item_status_updated, and store_product_template_created/u...

Collections

Gelato API

OPEN

Pricing Plans

Gelato Plans Pricing

4 plans

PLANS

Rate Limits

Gelato Rate Limits

4 limits

RATE LIMITS

FinOps

Gelato Finops

FINOPS

Resources

Sources

opencollection: 1.0.0
info:
  name: Gelato API
  version: '1.0'
request:
  auth:
    type: apikey
    key: X-API-KEY
    value: '{{apiKey}}'
    in: header
items:
- info:
    name: Orders
    type: folder
  items:
  - info:
      name: Create order
      type: http
    http:
      method: POST
      url: https://order.gelatoapis.com/v4/orders
      body:
        type: json
        data: '{}'
    docs: Creates a new order for fulfillment.
  - info:
      name: Search orders
      type: http
    http:
      method: POST
      url: https://order.gelatoapis.com/v4/orders:search
      body:
        type: json
        data: '{}'
    docs: Searches orders by channel, country, status, type, and date range.
  - info:
      name: Quote order
      type: http
    http:
      method: POST
      url: https://order.gelatoapis.com/v4/orders:quote
      body:
        type: json
        data: '{}'
    docs: Returns quotes including shipment methods and prices before ordering.
  - info:
      name: Get order
      type: http
    http:
      method: GET
      url: https://order.gelatoapis.com/v4/orders/{{orderId}}
    docs: Retrieves a single order by its Gelato order id.
  - info:
      name: Patch draft order
      type: http
    http:
      method: PATCH
      url: https://order.gelatoapis.com/v4/orders/{{orderId}}
      body:
        type: json
        data: '{}'
    docs: Converts a draft order into a regular order.
  - info:
      name: Cancel order
      type: http
    http:
      method: POST
      url: https://order.gelatoapis.com/v4/orders/{{orderId}}:cancel
    docs: Cancels an order before it moves into production.
- info:
    name: Product Catalog
    type: folder
  items:
  - info:
      name: List catalogs
      type: http
    http:
      method: GET
      url: https://product.gelatoapis.com/v3/catalogs
    docs: Returns the list of available product catalogs.
  - info:
      name: Get catalog
      type: http
    http:
      method: GET
      url: https://product.gelatoapis.com/v3/catalogs/{{catalogUid}}
    docs: Returns a single catalog with product attributes and values.
  - info:
      name: Search products
      type: http
    http:
      method: POST
      url: https://product.gelatoapis.com/v3/catalogs/{{catalogUid}}/products:search
      body:
        type: json
        data: '{}'
    docs: Searches products within a catalog by attribute filters.
  - info:
      name: Get product
      type: http
    http:
      method: GET
      url: https://product.gelatoapis.com/v3/products/{{productUid}}
    docs: Returns the details of a single product.
  - info:
      name: Cover dimensions
      type: http
    http:
      method: GET
      url: https://product.gelatoapis.com/v3/products/{{productUid}}/cover-dimensions
    docs: Returns the cover dimensions for a multi-page product.
- info:
    name: Prices and Stock
    type: folder
  items:
  - info:
      name: Price
      type: http
    http:
      method: GET
      url: https://product.gelatoapis.com/v3/products/{{productUid}}/prices
    docs: Returns prices for all quantities of a product.
  - info:
      name: Stock availability
      type: http
    http:
      method: POST
      url: https://product.gelatoapis.com/v3/stock/region-availability
      body:
        type: json
        data: '{}'
    docs: Returns regional stock availability for stock-able products.
- info:
    name: Shipment
    type: folder
  items:
  - info:
      name: Shipment methods
      type: http
    http:
      method: GET
      url: https://shipment.gelatoapis.com/v1/shipment-methods
    docs: Returns shipment methods, optionally filtered by destination country.
- info:
    name: Ecommerce
    type: folder
  items:
  - info:
      name: List products
      type: http
    http:
      method: GET
      url: https://ecommerce.gelatoapis.com/v1/stores/{{storeId}}/products
    docs: Returns a paginated list of products in a connected store.
  - info:
      name: Get product
      type: http
    http:
      method: GET
      url: https://ecommerce.gelatoapis.com/v1/stores/{{storeId}}/products/{{productId}}
    docs: Returns a single product from a connected store.
  - info:
      name: Create product from template
      type: http
    http:
      method: POST
      url: https://ecommerce.gelatoapis.com/v1/stores/{{storeId}}/products:create-from-template
      body:
        type: json
        data: '{}'
    docs: Creates a store product from an existing template.
  - info:
      name: Get template
      type: http
    http:
      method: GET
      url: https://ecommerce.gelatoapis.com/v1/templates/{{templateId}}
    docs: Returns the details of a product template.