NextSDS Docs

List SDS documents

Returns a paginated list of SDS documents for the authenticated team. Supports filtering by status, search query, and CAS number.

GET
/sds

Authorization

bearerAuth
AuthorizationBearer <token>

Bearer token authentication. Use your API key as the token. Obtain from your NextSDS team settings.

In: header

Query Parameters

page?integer

Page number (1-based)

Default1
Range1 <= value
per_page?integer

Items per page (max 100)

Default25
Range1 <= value <= 100
status?string

Filter by document status

Value in"processing" | "completed" | "failed"
query?string

Search by product name, chemical name, or CAS number

cas_number?string

Filter by CAS number

Response Body

application/json

application/json

application/json

curl -X GET "https://api.nextsds.com/v1/sds"
{
  "meta": {
    "page": 0,
    "per_page": 0,
    "total": 0,
    "has_more": true
  },
  "data": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "product_name": "Acetone",
      "alternate_name": "string",
      "chemical_name": "string",
      "cas_number": "67-64-1",
      "ec_number": "200-662-2",
      "sku": "string",
      "ean": "string",
      "signal_word": "Danger",
      "hazard_statements": [
        "H225",
        "H319",
        "H336"
      ],
      "ghs_pictograms": [
        "GHS02",
        "GHS07"
      ],
      "status": "processing",
      "archived": false,
      "procurement_status": "Review",
      "language": "en",
      "revision_date": "2019-08-24",
      "file_name": "string",
      "created_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z"
    }
  ]
}
{
  "type": "https://api.nextsds.com/errors/unauthorized",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Invalid or missing X-API-Key header"
}
{
  "type": "https://api.nextsds.com/errors/internal-error",
  "title": "Internal Server Error",
  "status": 500,
  "detail": "An unexpected error occurred"
}