Skip to main content
You can use the API to:

​
Base URL

Målbar’s API is built on REST principles and is served over HTTPS. To ensure data privacy, unencrypted HTTP is not supported. The Base URL for all API endpoints is: 
https://api.maalbar.dk

​
Authentication

Authentication to Målbars’s API is performed via the header “X-Api-Key” with the key generated when logged in to Målbar LCA. To authenticate, you need to include the header “X-Api-Key” followed by your API key in your requests like so:
Terminal
X-Api-Key: mb_[test|live]_xxxxxxxxxxxxxxxx
Here are examples of how to authenticate with Målbar’s API:
cURL
curl --request GET \
--url https://api.maalbar.dk/v1/customer \
--header 'X-Api-Key: mb_live_xxxxxxxxxxxxxxxx'
Learn more about how to get your API key.

​
Error handling

Målbar API returns machine readable error codes and human readable error messages. Here is how an error response looks like: 
{
  "error": {
    "code": "not_found",
    "message": "The requested resource was not found."
  }
}
Here is a list of all error codes Målbar API returns:
  • Status: 400
  • Problem: The request is malformed, either missing required fields, using wrong datatypes, or being syntactically incorrect.
  • Solution: Check the request and make sure it is properly formatted.
  • Status: 401
  • Problem: The request has not been applied because it lacks valid authentication credentials for the target resource.
  • Solution: Make sure you are using the correct API key.
  • Status: 403
  • Problem: The server understood the request, but is refusing to fulfill it because the client lacks proper permission.
  • Solution: Make sure you have the necessary permissions to access the resource.
  • Status: 404
  • Problem: The server has not found anything matching the request URI.
  • Solution: Check the request and make sure the resource exists.
  • Status: 429
  • Problem: The request has been rate limited.
  • Solution: Wait for a while and try again.
  • Status: 500
  • Problem: The server encountered an unexpected condition that prevented it from fulfilling the request.
  • Solution: Try again later. If the problem persists, contact Målbar support.

​
Pagination

Målbar’s API supports pagination. This is useful when you have a large number of resources and you want to retrieve them in smaller chunks.

​
Parameters

​
page
string
default:"1"
The page number to retrieve. By default, the first page is returned.
​
pageSize
string
The number of items to retrieve per page. The default value varies by endpoint. Maximum value is 100.

​
Example

The following example demonstrates how to retrieve the first page of 10 links:
cURL
curl --request GET \
--url https://api.maalbar.dk/v1/products?page=1&pageSize=10 \
--header 'X-Api-Key: mb_live_xxxxxxxxxxxxxxxx'