Let’s start by looking at how to manually export your data from Claimlane.
This is a great way to preview the data structure and see exactly what data will be included in the response. It also allows you to generate the API URL you’ll need if you want to automate the export later.
If you are not interested in this step you can skip to Export Raw Data via API
📍How to Export Data via Claimlane
Log into Claimlane and go to your Inbox.
Click the four-square icon in the top-right corner to access your Company Dashboard.
In the left-hand menu, click “Data Export”.
Choose Organisation type, Data type, Retailers and the time range :
Examples:
This month,Last 3 months,All time
Click the “Export Data” button.
What happens next?
You’ll receive an email (or multiple emails if the export is large) with your raw data attached.
We recommend trying this manually at least once to understand the format and content of the data before using the API.
🔗 Accessing the API URL
Once you’ve set up and exported your data:
In the Data Export section, click “Show API URL”.
You’ll get a custom API URL based on your selection and timeframe.
You can use this URL to automate exports using the Claimlane API.
Export Raw Data via API
Endpoint: /v2/company/raw-data
Authentication: Include the API key provided by [email protected] in the api-key request header.
⚙️ Query Parameters
fromDateUnix(number):
The start of the date range in Unix timestamp (seconds since 1st January,1970).
Example:fromDateUnix=1748728800
toDateUnix(number):
The end of the date range in Unix timestamp (seconds since 1st January,1970).
Example:toDateUnix=1751320799
organizationIds(string):
You can find your organisation ID in Claimlane's inbox URL:app.claimlane.com/home/supplier or retailer/yourOrganizationId/
One or more organization IDs (comma-separated if multiple).
Example:organizationIds=6156c67d45b7d67ffc34ec45
companyId(string):
Your company’s Claimlane ID, you can find it in the URL in your company view:
app.claimlane.com/company/yourCompanyId
Example:companyId=5f7eb30eee60d30d43f79c06
dataType(string):
The type of data to export.
Examples:b2cProductData,b2bProductData,b2cWorkloadData,b2cWorkloadData
organizationType(string):
Filter by type of organization.
Example:organizationType=retailer,organizationType=supplier
page(number):
Page number for paginated results (default: 1).
Example:page=2,page=3,page=4
format=map:You can add
format=mapto your request to receive the data in a flattened, map-friendly format.
Instead of returning deeply nested arrays or objects, the response is structured in a more Power BI–friendly format that’s easier to parse and visualize.
Finding your organisation ID
You can find the organisation ID in your Claimlane Inbox URL:
app.claimlane.com/home/supplier-or-retailer/yourOrganizationId/
Multiple IDs must be separated by commas:
organizationIds=6156c67d45b7d67ffc34ec45,ANOTHER_ORGANIZATION_ID
Finding your company ID
You can find the company ID in the company-view URL:
app.claimlane.com/company/yourCompanyId
Supported data types
b2cProductDatab2bProductDatab2cWorkloadData
Flattened response format
format=map
This reduces deeply nested arrays and objects, making the response easier to parse and use in reporting tools such as Power BI.
Pagination
Results may be divided across multiple pages. Use the page parameter to request subsequent pages:
page=2
The default page is 1.
⚠️ Common Error Messages
401 Unauthorized
"Missing or invalid API key."
Make sure you're including your API key in the api-key header. Example:
api-key: sk_live_yourkeyhere
403 Forbidden
"You do not have access to this resource."
Your API key is valid but doesn’t have permission to access the requested data (e.g. wrong company or organization).
500 Internal Server Error
"Something went wrong on our end."
Unexpected issue on the server. Try again later. If the problem persists, contact Claimlane in the chat widget.