REST API

Overview of Shoporama

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

Documentation

The full API documentation with all endpoints, parameters and examples can be found in our interactive Swagger documentation:

Open the Swagger documentation

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

Get started

1. Go to Settings → API in your Shoporama administration
2. Create a new API key
3. Select rights 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 in 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 accessed under https://dinshop.dk/REST/:

Products and Catalog

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

Stock

• /stock - Inventory and postings
• /batch - Stock batches

Orders and customers

• /order - Orders
• /order/{id}/create-label - Create shipping label on 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

• /page - Static pages
• /blog-post - Blog posts
• /landing-page and /landing-page-item - Landing pages and elements
• /menu - Menus and navigation

/newsletter-list - Newsletters

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

Setup - 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 "Access to theme files" to be enabled on the API key

HTTP methods

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

Examples include

Get 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 returned fields
• ?last_modified=2026-01-01 - only resources modified since date

Webhooks

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

Response codes

• 200 - Success
• 201 - Resource created
• 204 - Update/deletion successful
• 400 - Invalid request
• 401 - Not authorized (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.