REST API

Overview

Shoporama’s REST API lets you integrate your online store with external systems—ERP, inventory management, PIM, CRM, and other services. The API supports CRUD (create, read, update, delete) operations on most resources in your online store.

Documentation

You can find the full API documentation, including all endpoints, parameters, and examples, in our interactive Swagger documentation:

Open the Swagger documentation

Here you can test API calls directly in your browser and view all available fields and parameters for each resource.

Get Started

1. Go to Settings → API in your Shoporama admin panel
2. Create a new API key
3. Select permissions for the key—you can grant read and/or write access to each resource
4. Use the key in the Authorization header of your API calls

Authentication

Add your API key to the Authorization header. You can either send the key directly or use the Bearer format:

Authorization: YOUR-API-KEY

# Or with Bearer:
Authorization: Bearer YOUR-API-KEY

Available Resources

The API provides access to the following resources. All endpoints are accessible at https://dinshop.dk/REST/:

Products and Catalog

• /product — Products (with variants, images, prices, categories, custom fields)
• /category — Categories
• /brand — Brands
• /manufacturer — Manufacturers
• /supplier — Suppliers
• /product-label — Product labels
• /profile, /profile-attribute, /profile-attribute-value — Product profiles, attributes, and values

Inventory

• /stock — Inventory and entries
• /batch — Stock batches

Orders and Customers

• /order — Orders
• /order/{id}/create-label — Create a shipping label for an order
• /order/{id}/download-label — Download shipping label
• /order-queue — Order queue
• /order-label — Order labels
• /order-return — Returns
• /customer — Customers
• /customer-field — Customer fields
• /voucher — Discount codes and gift cards

Content

• /page — Static pages
• /blog-post — Blog posts
• /landing-page and /landing-page-item — Landing pages and items. GET /landing-page/{id} now returnsthe page’srules andmatch type directly in the response, so you don’t need to make a separate call to /landing-page-item
• /menu — Menus and navigation

Newsletter

• /newsletter-list — Newsletter lists
• /newsletter-subscriber — Subscribers
• /newsletter-campaign — Campaigns

Setup

• /shipping — Shipping Methods
• /payment_gateway — Payment methods
• /country — Countries
• /redirect — URL redirects
• /webhook — Webhooks

Theme Files

• /theme-file — Read, create, update, and delete files in your themes. Requires that "Access to theme files" be enabled on the API key

HTTP Methods

• GET — Retrieve a list or a single resource
• POST — Create a new resource
• PUT — Update an existing resource
• DELETE — Delete a resource

Examples

Retrieve products:

curl -H "Authorization: YOUR-API-KEY" \
  https://dinshop.dk/REST/product?limit=10

Create a product:

curl -X POST -H "Authorization: YOUR-API-KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "New product", "price": 199.00}' \
  https://dinshop.dk/REST/product

Update inventory:

curl -X PUT -H "Authorization: YOUR-API-KEY" \
  -H "Content-Type: application/json" \
  -d '{"stock": 50}' \
  https://dinshop.dk/REST/product/123

Filtering and paging

List endpoints support the following query parameters:

• ?limit=25 — number of results per page (max 100)
• ?offset=0 — skip results (for paging)
• ?search=text — free-text search
• ?fields=name,price — limit the fields returned
• ?last_modified=2026-01-01 — only resources modified since this date

Webhooks

You can create webhooks via the API so that your system is automatically notified when changes occur. Upon creation, you’ll receive a secret used to verify webhook calls via HMAC.

Response Codes

• 200 — Success
• 201 — Resource created
• 204 — Update/delete successful
• 400 — Invalid request
• 401 — Unauthorized (incorrect or missing API key)
• 404 — Resource not found
• 429 — Too many calls (rate limit)

Need help with API integration? Contact us at support@shoporama.dk.