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

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_after parameter, 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_id and an external_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: email and password, 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: Explosive to GHS09: 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.

Rate this FAQ

★ 5 (2 Votes)