SpecMake API

curl "https://www.specmake.com/api/v1/documents?scope=all&limit=50" \
  -H "Authorization: Bearer sk_live_••••"

# the next page: pass next_cursor back as cursor, with the same scope
curl "https://www.specmake.com/api/v1/documents?scope=all&limit=50&cursor=eyJjIjoiMjAyNi0wNS0x..." \
  -H "Authorization: Bearer sk_live_••••"

Query params

• limit: 1 to 100. Default 25.
• scope: mine (default, the documents uploaded by the key’s user) | team (every document of your team, a teammate’s included) | all (both). team answers not_on_team for an account without a team.
• cursor: the next_cursor of the previous page. Treat it as an opaque string: pass it back unchanged, URL-encoded, with the same scope.
• before: kept for existing clients. Takes a next_cursor value, or an ISO 8601 timestamp or date (documents created strictly before it; a date means midnight UTC, a time without a zone is read as UTC). Pass either cursor or before, not both.

Response

{
  "documents": [
    { "id": "...", "filename": "spec.pdf", "file_type": "pdf",
      "file_size": 230423, "source_language": "de",
      "detected_domain": "hydraulics_pneumatics",
      "status": "completed", "created_at": "2026-05-16T...",
      "owned_by_caller": true },   // false for a teammate's document
    ...
  ],
  "has_more": true,
  "next_cursor": "eyJjIjoiMjAyNi0wNS0x..."  // opaque; null on the last page
}

Pages follow upload time, then document id, so walking next_cursor until has_more is false returns each document once, including documents uploaded in the same instant. Each version of a product is its own document, so the list counts documents, not products under management. Deleted documents are not listed; to mirror deletions, compare the ids you hold with a full walk.

curl https://www.specmake.com/api/v1/documents/abc-123 \
  -H "Authorization: Bearer sk_live_••••"

# with the compliance cross-check and the DPP readiness score
curl "https://www.specmake.com/api/v1/documents/abc-123?include=compliance,dpp" \
  -H "Authorization: Bearer sk_live_••••"

Query parameters

• include: comma list of compliance and/or dpp. Adds the same regulatory cross-check and Digital Product Passport score the product shows, computed for your plan’s compliance modules (a regulation in a module your plan does not include is listed under compliance.locked, never scored). Omitted keys are absent, so existing clients see an unchanged payload.

Response

{
  "id": "abc-123",
  "filename": "spec.pdf",
  "file_type": "pdf",              // snake_case at top level
  "file_size": 230423,
  "source_language": "de",
  "detected_domain": "hydraulics_pneumatics",
  "status": "completed",
  "created_at": "2026-05-16T12:00:00Z",
  "document": {                    // camelCase inside
    "title": "...",
    "sourceLanguage": "de",
    "metadata": { ... },
    "sections": [ ... ],
    "diagrams": [
      { "type": "application_photo",
        "width": 2000, "height": 2000,
        "description": "Figure 1",
        "storagePath": "uuid/0.jpg",
        "imageUrl": "https://...signed...?expires=..." }  // 1h TTL
    ]
  },
  "audit": {
    "coverage_score": 87,
    "data_points_extracted": 47,
    "total_data_points_in_source": 54,
    "severity_counts": { "low": 8, "medium": 6 },
    "findings": [ ... ]
  } | null,
  "compliance": {                  // only with include=compliance
    "ruleset_version": "2026.09.1",
    "overall_score": 79,
    "applicable": [
      { "id": "ce", "short_name": "CE", "name": "CE Marking", "score": 83,
        "counts": { "pass": 5, "fail": 1, "warning": 0, "not_checked": 0 },
        "requirements": [
          { "id": "ce_standards", "label": "...", "status": "fail",
            "severity": "mandatory", "detail": "...", "matched_field": "..." }
        ] }
    ],
    "not_applicable": [ "machinery", "voc_paints", "cpr" ],
    "locked": [ { "id": "atex", "short_name": "ATEX", "module": "atex" } ],
    "disclaimer": "Documentation readiness ... Not a legal assessment."
  },
  "dpp": {                         // only with include=dpp; null when no DPP category applies;
                                   // { "locked": "dpp", "note": "..." } when the plan lacks the DPP module
    "category": "batteries", "display_name": "Batteries (EU Battery Regulation)",
    "regulation": "Regulation (EU) 2023/1542", "mandatory_from": "18 February 2027",
    "coverage_percent": 31, "found_required": 10, "total_required": 32,
    "missing_required": [ { "id": "...", "label": "...", "description": "...", "cluster": "..." } ],
    "found": [ { "id": "...", "label": "...", "matched_key": "..." } ],
    "category_source": "auto",     // or "override" when set on the product
    "requirement_note": "..."      // only when a caveat applies: a field list not yet fixed by an
                                   // adopted act, a battery whose passport scope the sheet does
                                   // not settle, or a battery category chosen by hand for a
                                   // sheet that reads as out of scope
  }
}

curl https://www.specmake.com/api/v1/documents/abc-123/translations \
  -H "Authorization: Bearer sk_live_••••"

curl -X DELETE https://www.specmake.com/api/v1/documents/abc-123 \
  -H "Authorization: Bearer sk_live_••••"