SDS Library API for SDS Manager
This API is for SDS Manager customers who manage their SDS library at inventory.sdsmanager.com. It gives you the same data as the export of your SDS library to a file, as JSON, so that you can sync your SDS library with your ERP or another system.
What the API does
- All SDSs in your library: without a date, the API returns all the SDSs in your library. Archived SDSs are not included. An SDS that is on several locations is listed once for each location.
- SDSs added since a date: with the
added_afterparameter, the API returns only the SDSs that were added to your library on or after that date. The filter uses the date the SDS was added, so it is not a list of all changes. - Your ERP IDs: each SDS can have an
external_system_idand anexternal_system_url. Add your ERP IDs once, for example when you import your product list (More → Import product list), and the API returns them with each SDS.
Availability
This API is available on the Pro and Enterprise plans.
1. Log in and get a token
Log in with the e-mail address and password of an Owner, Admin, Admin Light or Admin with approval user to get a JWT access token. Staff and Read only users cannot export the library.
- URL:
https://inventory.sdsmanager.com/api/auth/login/ - Method: POST
- Body:
emailandpassword, as form data or as JSON
Example:
curl --request POST 'https://inventory.sdsmanager.com/api/auth/login/' \
--form 'email=your-email' \
--form 'password=your-password'
The response contains, among other things:
{
"access_token": "<your-jwt-token>",
"refresh_token": "<your-refresh-token>"
}
Keep the token secret, and send it in the Authorization header of the next requests. The access token is valid for a limited time. When it has expired, log in again.
If the user has two-factor authentication (2FA) switched on, the response contains a request_id instead of the tokens, and the login must first be confirmed with a code. For an automated sync, use a user without 2FA.
2. Export your SDS library
- URL:
https://inventory.sdsmanager.com/api/v2/substances/export_customer_sds_library/ - Method: POST
- Header:
Authorization: JWT <your-jwt-token>
Replace <your-jwt-token> with the access token. Put a space between JWT and the token, for example:
Authorization: JWT eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX2lkIjoxMjM0NX0.EXAMPLE-SIGNATURE
Optional query parameter: added_after=YYYY-MM-DD returns only the SDSs added on or after that date, for example ?added_after=2025-01-01.
Example:
curl --request POST 'https://inventory.sdsmanager.com/api/v2/substances/export_customer_sds_library/' \
--header 'Authorization: JWT <your-jwt-token>'
Example with the date filter:
curl --request POST 'https://inventory.sdsmanager.com/api/v2/substances/export_customer_sds_library/?added_after=2025-01-01' \
--header 'Authorization: JWT <your-jwt-token>'
3. The data returned by the API
The response is a JSON object with a list, datas, with one entry for each SDS on each location. The fields are the same as the columns of the SDS library export:
{
"datas": [
{
"SUPPLIER OF SDS": "Example Chemicals Inc.",
"PRODUCT_NAME": "Example Cleaner",
"Revision date": "2025-03-14",
"LOCATION": "Main Plant",
"SDS Manager internal ID": 123456,
"external_system_id": "ERP-555",
...
}
]
}
- Product:
SUPPLIER OF SDS,PRODUCT_NAME,Product code,CAS#,EC#,Substance components CAS#,LANGUAGE,Revision date - Hazards:
Hazard sentences,EUH sentences,Prevention sentences,Hazard category abbreviations,Signal word,Signal word code,Pictograms, one field for each GHS pictogram (GHS01: ExplosivetoGHS09: Environmentally Hazardous),Icons in SDS - Transport:
ADR,RID,ADN,IMDG,IATA - Location and use:
LOCATION_PATH,LOCATION,Amount store,Amount measure,Date added to library,Information message - Approval and risk:
Approved date,Approved by,Health Risk rating,Safety Risk rating,Environment Risk rating,Risk assessment approved date,Risk assessment approved by - Links and IDs:
SDS Path,Summary SDS Link,Webshop permanent url,SDS Manager internal ID,external_system_id,external_system_url,EAN,UPC,SKU - Your custom fields, if you have any.