Mill Certification
List mill certifications
Retrieves a list of all mill certifications for a company
path Parameters
companyIdThe unique identifier of the company. Example: 11111111-2222-3333-4444-555555555555
Headers
GoSmarter-Api-KeyThe GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.
List mill certifications › Responses
List of mill certifications retrieved successfully
newFileNamedefenderResultIddateInserteddateModifiedheatCodesmillCertificationIdcompanyIdoriginalFileNamestorageFileNamestatusmillCertificationStatusLabelmillCertificationStatusNotesmillCertificationStatusTypeDownload mill certification
Downloads mill certification data. Returns ZIP archive of scanned PDFs (application/zip) when export=scans, or CSV with certification details (text/csv) when export=csv. Default export is scans. For scans export, use groupBy parameter to group files by 'page' (default) or 'heat'.
path Parameters
companyIdThe unique identifier of the company. Example: 11111111-2222-3333-4444-555555555555
millCertificationIdThe unique identifier of the mill certification. Example: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee
query Parameters
exportExport format: 'scans' (default, returns application/zip with PDFs) or 'csv' (returns text/csv with details)
groupByFor scans export only: 'page' (default) or 'heat' to group files in the ZIP archive
heatCodeFor scans export with groupBy=heat only: restricts the ZIP to heats matching this heat number. AND'd with productReference when both are supplied — a heat number alone can be shared by multiple distinct items (e.g. barcoded coils sharing one cast number), so supply productReference too to target one exact heat.
productReferenceFor scans export with groupBy=heat only: restricts the ZIP to heats matching this product reference. AND'd with heatCode when both are supplied.
Headers
GoSmarter-Api-KeyThe GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.
Download mill certification › Responses
Scans export, groupBy=page (default): ZIP archive of processed PDFs. groupBy=heat resolving to exactly one heat instead returns that heat's single merged certificate (application/pdf). csv export instead returns certification details (text/csv).
Bulk export all mill certifications as CSV
Downloads a single combined CSV (text/csv) containing detail rows for every mill certification belonging to the company. Currently only export=csv is supported.
path Parameters
companyIdThe unique identifier of the company. Example: 11111111-2222-3333-4444-555555555555
query Parameters
includeArchivedWhen 1, includes archived mill certifications in the export. The underlying SQL parameter is a BIT — callers must pass 1 or 0.
includeDeletedWhen 1, includes deleted mill certifications in the export. The underlying SQL parameter is a BIT — callers must pass 1 or 0.
exportExport format: 'csv' (default and only supported value)
Headers
GoSmarter-Api-KeyThe GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.
Bulk export all mill certifications as CSV › Responses
Success - combined CSV of all mill certification details for the company
Generate branded Material Test Certificate PDF
Generates a branded landscape A4 PDF derived from an ingested mill certification. Includes a DRAFT watermark when the certificate has not been approved. The generated PDF is stored in blob storage for audit purposes.
path Parameters
companyIdThe unique identifier of the company
millCertificationIdThe unique identifier of the mill certification to derive the report from
query Parameters
heatCodeOptional heat number to restrict the report to. OR'd with productReference — when both are supplied, a heat/mech-property row qualifies if either matches.
productReferenceOptional product reference to restrict the report to. OR'd with heatCode — when both are supplied, a heat/mech-property row qualifies if either matches.
Headers
GoSmarter-Api-KeyThe GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.
Generate branded Material Test Certificate PDF › Responses
Generated PDF returned as a file download
Get mill certification details
Retrieves detailed information about a specific mill certification including document-level metadata (supplier, mill, standard, quality, production process, CARES QR, certificate date, customer), pages, heats with chemical composition, and mechanical properties
path Parameters
companyIdThe unique identifier of the company. Example: 11111111-2222-3333-4444-555555555555
millCertificationIdThe unique identifier of the mill certification. Example: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee
Headers
GoSmarter-Api-KeyThe GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.
Get mill certification details › Responses
Mill certification details retrieved successfully
newFileNamedefenderResultIddateInserteddateModifiedheatCodesmillCertificationIdcompanyIdoriginalFileNamestorageFileNamestatusmillCertificationStatusLabelmillCertificationStatusNotesmillCertificationStatusTypeUpload a mill certification
Uploads a single mill certification file (PDF or image) with rate limiting and validation. The client supplies the mill certification GUID.
path Parameters
companyIdThe unique identifier of the company. Example: 11111111-2222-3333-4444-555555555555
millCertificationIdClient-generated GUID that identifies this mill certification. Used as the record ID and the blob storage file name.
query Parameters
uploadBatchIdOptional client-generated GUID shared across all files in one bulk upload action. When present, SourceType is set to BulkUpload (1); otherwise DirectUpload (0). Each file in a batch counts as 1 against upload limits regardless of SourceType — Phase 3 ZIP fan-out must follow the same per-child counting rule.
Headers
GoSmarter-Api-KeyThe GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.
Upload a mill certification › Responses
Mill certification uploaded successfully
millCertificationIdcompanyIddefenderResultIdoriginalFileNamenewFileNamestorageFileNamestatusisTestRunGet mill certification page content
Streams the content for a specific mill certification page (PDF or image). Use this endpoint to render files without cross-origin issues.
path Parameters
companyIdThe unique identifier of the company
millCertificationIdThe unique identifier of the mill certification
millCertificationPageIdThe unique identifier of the mill certification page
Headers
GoSmarter-Api-KeyThe GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.
Get mill certification page content › Responses
Page content streamed successfully
Get signed URLs for mill certification pages
Retrieves time-limited signed URLs for accessing mill certification page blobs (PDF or image)
path Parameters
companyIdThe unique identifier of the company
millCertificationIdThe unique identifier of the mill certification
Headers
GoSmarter-Api-KeyThe GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.
Get signed URLs for mill certification pages › Responses
Page URLs retrieved successfully
millCertificationPageIdpageFileNamepageNumbersignedUrlcontentTypeManually create a mill certification
Creates a mill certification with user-provided data. The file (PDF or supported image) is stored in a separate container and no AI pipeline is triggered.
path Parameters
companyIdThe unique identifier of the company.
millCertificationIdClient-generated GUID that identifies this mill certification.
Headers
GoSmarter-Api-KeyThe GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.
Manually create a mill certification › Responses
Mill certification created successfully
millCertificationIdcompanyIdoriginalFileNamestorageFileNamestatusisTestRunsuppliermillstandardqualityproductionProcesscaresQRcertificateDatecustomerNamecustomerAddressdescriptionOfGoodsrollingMarkcaresDispensationReferenceradioactivityStatementconformityStatementcaresApprovalinvoiceNumberproductFormcomplianceStatementdateOfIssueAndValidationinspectionOriginatorsignatoryNamesignatoryRolesignaturePresentsignatureDateceMarkPresentceMarkingCertificateNoukcaMarkPresentukcaMarkingCertificateNocontentTypefileSizeBytesentrySourceuploadedByReview a mill certification
Submits or updates a review decision (Approved or Issue) for a completed mill certification.
path Parameters
companyIdThe unique identifier of the company
millCertificationIdThe unique identifier of the mill certification
Headers
GoSmarter-Api-KeyThe GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.
Review a mill certification › Request Body
reviewStatuscommentReview a mill certification › Responses
Review submitted successfully
millCertificationIdreviewStatusreviewStatusLabelreviewCommentreviewedByNamereviewedAtmessageUpdate mill certification data
Persists the full mill certification state — document-level fields, heat records, and mechanical property records — in a single request. The frontend sends the complete object as it expects it to be after save. Each section is optional; omitted sections are not touched.
path Parameters
companyIdThe unique identifier of the company.
millCertificationIdThe unique identifier of the mill certification.
Headers
GoSmarter-Api-KeyThe GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.
Update mill certification data › Request Body
deletedHeatIdsdeletedMechanicalPropertyIdsUpdate mill certification data › Responses
All changes persisted successfully
deletedHeatIdsdeletedMechanicalPropertyIds
