SafetyDataSheetAPI Account API

Prepaid balance and usage for per-customer API keys.

GitHub OpenAPI

Operations 1

GET /api/account Get the account balance and recent usage #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/safetydatasheetapi:safetydatasheetapi-account-api"
All apis
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.

Get an API 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 Specification

safetydatasheetapi-account-api-openapi.yml Raw ↑
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/