SafetyDataSheetAPI Account API
Prepaid balance and usage for per-customer API keys.
Prepaid balance and usage for per-customer API keys.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/safetydatasheetapi:safetydatasheetapi-account-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: SafetyDataSheet Account API
version: 1.0.0
summary: Extract Safety Data Sheet (SDS/MSDS) PDFs into structured JSON, XML, and CSV.
description: 'SafetyDataSheetAPI converts Safety Data Sheet PDFs into normalized, 16-section compliance records
in JSON, XML, and CSV.
**Authentication.** Production extraction endpoints require an API key, sent as
`Authorization: Bearer ` or as an `X-API-Key` header. Request a key through the
self-serve signup on https://safetydatasheetapi.com/#self-serve-signup.
**Rate limits.** Extraction responses include `X-RateLimit-Remaining` and, when a limit applies,
`X-RateLimit-Reset` (Unix epoch seconds). When the limit is exceeded the API returns `429` with
error code `rate_limited`, a standard `Retry-After` header (seconds to wait), and
`retry_after_epoch_seconds` in the body.
**Errors.** Every error uses one envelope: `{"ok": false, "error": {"code": "...", "message": "..."}}`,
optionally with extra detail fields. Branch on `error.code`, which is stable; `message` is for humans.
**Async bulk jobs.** `POST /extract-sds/bulk` returns `202` with a `job_id`. Poll
`GET /extract-sds/bulk/{jobId}` or pass `callback_url` to receive a signed webhook
(`X-Webhook-Signature`). Send an `Idempotency-Key` header to make job submission safe to retry.'
termsOfService: https://safetydatasheetapi.com/terms/
license:
name: Proprietary (see Terms of Service)
url: https://safetydatasheetapi.com/terms/
contact:
name: SafetyDataSheetAPI Support
url: https://safetydatasheetapi.com/contact/
email: sales@safetydatasheetapi.com
servers:
- url: https://safetydatasheetapi.com
description: Hosted API (free sample upload, and self-serve API keys). Enterprise customers use the dedicated base URL provided at onboarding.
security:
- bearerAuth: []
- apiKeyAuth: []
tags:
- name: Account
description: Prepaid balance and usage for per-customer API keys.
paths:
/api/account:
get:
operationId: getAccount
summary: Get the account balance and recent usage
description: Returns the prepaid credit balance, the price per document, and the last 30 days of usage for the account that owns the per-customer API key used for the request. Not available with the shared enterprise key.
tags:
- Account
security:
- bearerAuth: []
- apiKeyAuth: []
responses:
'200':
description: Account summary.
content:
application/json:
example:
ok: true
balance_usd: 12.5
pricing:
price_per_document_usd: 0.25
pages_per_document: 40
max_pages_per_request: 400
usage:
period_days: 30
requests: 42
succeeded: 41
documents_billed: 44
pages: 610
spend_usd: 11
daily:
- date: '2026-10-24'
documents: 3
pages: 41
spend_usd: 0.75
schema:
type: object
properties:
ok:
type: boolean
balance_usd:
type: number
pricing:
type: object
properties:
price_per_document_usd:
type: number
pages_per_document:
type: integer
max_pages_per_request:
type: integer
usage:
type: object
properties:
period_days:
type: integer
requests:
type: integer
succeeded:
type: integer
documents_billed:
type: integer
pages:
type: integer
spend_usd:
type: number
daily:
type: array
items:
type: object
properties:
date:
type: string
documents:
type: integer
pages:
type: integer
spend_usd:
type: number
'401':
$ref: '#/components/responses/Unauthorized'
components:
schemas:
Error:
type: object
description: Standard error envelope returned by every endpoint. Additional detail fields may be present alongside `error`.
required:
- ok
- error
properties:
ok:
type: boolean
const: false
error:
type: object
required:
- code
- message
properties:
code:
type: string
description: Stable machine-readable error code. Branch on this value.
examples:
- rate_limited
message:
type: string
description: Human-readable explanation. May change; do not parse.
request_id:
type: string
description: Present on server-side failures (5xx). Quote it when contacting support; internal detail is logged against this id and is never returned in the response.
additionalProperties: true
responses:
Unauthorized:
description: The API key is missing or invalid (`unauthorized`), or has been revoked (`api_key_revoked`). A suspended account returns 403 `account_suspended`.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
ok: false
error:
code: unauthorized
message: Invalid or missing API key.
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: API Key
description: 'API key sent as `Authorization: Bearer <api_key>`. Never send keys in the query string.'
apiKeyAuth:
type: apiKey
in: header
name: X-API-Key
description: Alternative to the Bearer header. Send the same API key as `X-API-Key`.
externalDocs:
description: API documentation and quickstart
url: https://safetydatasheetapi.com/api-docs/
x-agentic-access:
version: '1.0'
summary: How autonomous agents and AI assistants can use this API safely.
authentication:
type: api_key
schemes:
- bearerAuth
- apiKeyAuth
interactive_login_required: false
obtain_key: https://safetydatasheetapi.com/#self-serve-signup
note: Agents must be given a key by a human; they cannot self-register. Self-serve accounts receive their own key; enterprise customers receive a dedicated deployment and base URL.
interfaces:
rest: https://safetydatasheetapi.com/openapi.yaml
mcp:
url: https://safetydatasheetapi.com/mcp
transport: streamable-http
authentication: bearer
manifest: https://safetydatasheetapi.com/mcp-manifest.yml
skill: https://safetydatasheetapi.com/.well-known/agent-skills/safetydatasheetapi/SKILL.md
clients: https://safetydatasheetapi.com/sdks/
side_effects:
extractSds: Consumes API quota. Creates no durable customer-visible resource.
extractSdsBulk: Consumes API quota. Creates a job record retrievable through getBulkJobStatus.
getBulkJobStatus: None. Read-only and safe to repeat.
idempotency:
operations:
- extractSdsBulk
header: Idempotency-Key
behavior: A repeat with the same key returns the existing job with idempotent_replay true.
retry_guidance:
retry_after_header: Retry-After
retry_on_status:
- 429
- 500
- 502
do_not_retry_on_status:
- 400
- 401
- 403
- 404
- 413
stable_error_field: error.code
human_review:
recommended_when: The response has non-empty warnings or a low confidence_score.
note: Extracted data is machine-generated. Do not treat it as verified compliance data without review against the source document.
rate_limits: https://safetydatasheetapi.com/api-docs/#rate-limits
data_handling: https://safetydatasheetapi.com/data-residency/