ID #3019

How to use API to get JSON export/sync of your SDS Library to external systems.

~ 0 min

n/a

2025-04-17 16:18

SDS Library API for Inventory Management

This API is designed for SDS Manager customers who manage their SDS library through inventory.sdsmanager.com. It allows seamless access to the same data available when exporting your SDS library as a CSV file.

Overview of API Functionality

Retrieve All Active SDSs:
When the API endpoint is called without specifying a date parameter, it will return information about all active Safety Data Sheets (SDS) in your library.
Fetch Updates Since a Specific Date:
To retrieve only the SDSs added after a particular date, include a date parameter in your request. This is especially useful for syncing with your ERP system.
ERP Integration with external_system_id:
To streamline synchronization between your SDS Manager library and your ERP system, you can use the external_system_id field:
- On initial setup, import your ERP IDs using our Chemical List Import Tool.
- When exporting your SDS library, the external_system_id is included for each SDS.

Availability

This API is available to customers on the Pro Plan and Enterprise Plan.

1. Authenticate & Get Token

To access secured endpoints, you must authenticate using your registered credentials to obtain a JWT access token.

URL: https://inventory.sdsmanager.com/api/auth/login/

HTTP Method: POST

Headers:

Content-Type: application/json—Indicates that the body of the request is in JSON format.

Accept: application/json—Specifies that the client expects a JSON response.

Example cURL:

curl --location --request POST 'https://inventory.sdsmanager.com/api/auth/login/' \

--form 'email="your-email"' \

--form 'password="your-password"'

Response:

{

"access_token": "your-jwt-token",

"refresh_token": "your-refresh-token"

}

Note: Keep your JWT token secure and include it in the Authorization header for all subsequent requests.

2. Export Customer SDS Library

Use this endpoint to export SDS data associated with your account.

URL: https://inventory.sdsmanager.com/api/v2/substances/export_customer_sds_library/

HTTP Method: POST

Headers:

Accept: application/json—Specifies that the client expects a JSON response.

Authorization: JWT <your-jwt-token>

Replace <your-jwt-token> with the actual token value. Make sure there is a space between JWT and the token.

Example: JWT eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9eyJ1c2VyX2lkIjoxNTMwOCwidXNlcm5hbWUiOiJtaW5oLmh1eW5oKzZAbmV0cG93ZXIubm8iLCJleHAiOjE3NDU0Njc5NwMsImVtYWlsIjoibWluaC5odswwXluaCs2QG5ldHBvd2VyLm5vIiwib3JpZ19pYXQiOjE3NDQ4NjMxNjN9.qg2Qz2ucPTmBc7v-Ey4_mOS-LVwJpG1tVj3Iy6545NE

Optional Query Parameters:

- added_after=YYYY-MM-DD: Filter results to only include SDS added after a given date. Example: ?added_after=2025-01-01

Example cURL:

curl --location --request POST 'https://inventory.sdsmanager.com/api/v2/substances/export_customer_sds_library/' \

--header 'Authorization: JWT <your-jwt-token>' \

Example cURL with date filter:

curl --location --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. Overview of data returned by the API

"datas": [
{
"LOCATION_PATH": [],
"LOCATION": "",
"SUPPLIER OF SDS": "",
"LANGUAGE": "",
"PRODUCT_NAME": "",
"Product code": null,
"Revision date": "",
"Prevention sentences": "",
"Hazard category abbreviations": "",
"Hazard sentences": "",
"EUH sentences": "",
"Signal word": "",
"Signal word code": "",
"Pictograms": "",
"Icons in SDS": "",
"Substance components CAS#": "",
"Health Risk rating": ,
"Safety Risk rating": ,
"Environment Risk rating": ,
"SDS Path": "",
"SDS Manager internal ID": ,
"Date added to library": "",
"Approved date": "",
"Approved by": "",
"Risk assessment approved date": ,
"Risk assessment approved by": ,
"external_system_id": ,
"external_system_url":
}
]
}

Tags: API, ERP Sync, Export