GoSmarter Logo
GoSmarter API Gateway
GoSmarter API Gateway

MillCertifications

Archive mill certifications

POST
https://api.gosmarter.ai
/api/company/{companyId}/millcertification/archive

Archives one or more mill certifications by setting IsArchived = 1. Archived certs stay fully functional (matching, downloads) and are only hidden from the default list view.

Archive mill certifications › path Parameters

companyId
​string · uuid · required

The unique identifier of the company

Archive mill certifications › Headers

GoSmarter-Api-Key
​string · required

The GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.

Archive mill certifications › Request Body

​string[]

Archive mill certifications › Responses

Mill certifications archived successfully

deleteResponse
deletedCount
​integer · int32

Number of items deleted

deletedIds
​string[]

List of IDs that were deleted

List mill certifications

GET
https://api.gosmarter.ai
/api/company/{companyId}/millcertification

Retrieves a list of all mill certifications for a company

List mill certifications › path Parameters

companyId
​string · uuid · required

The unique identifier of the company. Example: 11111111-2222-3333-4444-555555555555

List mill certifications › Headers

GoSmarter-Api-Key
​string · required

The 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

millCertificationDto
newFileName
​string
defenderResultId
​string · uuid
dateInserted
​string · date-time
dateModified
​string · date-time
heatCodes
​string
millCertificationId
​string · uuid
companyId
​string · uuid
originalFileName
​string
storageFileName
​string
status
​integer · int32
millCertificationStatusLabel
​string
millCertificationStatusNotes
​string
millCertificationStatusType
​string

Delete mill certifications

DELETE
https://api.gosmarter.ai
/api/company/{companyId}/millcertification

Soft deletes one or more mill certifications by setting Active = 0. Temporal tables preserve the previous row state automatically. Deleted certs are excluded from matching and downloads until restored.

Delete mill certifications › path Parameters

companyId
​string · uuid · required

The unique identifier of the company

Delete mill certifications › Headers

GoSmarter-Api-Key
​string · required

The GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.

Delete mill certifications › Request Body

​string[]

Delete mill certifications › Responses

Mill certifications deleted successfully

deleteResponse
deletedCount
​integer · int32

Number of items deleted

deletedIds
​string[]

List of IDs that were deleted

Download mill certification

GET
https://api.gosmarter.ai
/api/company/{companyId}/millcertification/{millCertificationId}/download

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'.

Download mill certification › path Parameters

companyId
​string · uuid · required

The unique identifier of the company. Example: 11111111-2222-3333-4444-555555555555

millCertificationId
​string · uuid · required

The unique identifier of the mill certification. Example: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee

Download mill certification › query Parameters

export
​string

Export format: 'scans' (default, returns application/zip with PDFs) or 'csv' (returns text/csv with details)

groupBy
​string

For scans export only: 'page' (default) or 'heat' to group files in the ZIP archive

heatCode
​string

For 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.

productReference
​string

For scans export with groupBy=heat only: restricts the ZIP to heats matching this product reference. AND'd with heatCode when both are supplied.

Download mill certification › Headers

GoSmarter-Api-Key
​string · required

The 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).

string · binary

Bulk export all mill certifications as CSV

GET
https://api.gosmarter.ai
/api/company/{companyId}/millcertification/download

Downloads a single combined CSV (text/csv) containing detail rows for every mill certification belonging to the company. Currently only export=csv is supported.

Bulk export all mill certifications as CSV › path Parameters

companyId
​string · uuid · required

The unique identifier of the company. Example: 11111111-2222-3333-4444-555555555555

Bulk export all mill certifications as CSV › query Parameters

includeArchived
​integer · int32 · required

When 1, includes archived mill certifications in the export. The underlying SQL parameter is a BIT — callers must pass 1 or 0.

includeDeleted
​integer · int32 · required

When 1, includes deleted mill certifications in the export. The underlying SQL parameter is a BIT — callers must pass 1 or 0.

export
​string

Export format: 'csv' (default and only supported value)

Bulk export all mill certifications as CSV › Headers

GoSmarter-Api-Key
​string · required

The 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

string · binary

Generate branded Material Test Certificate PDF

POST
https://api.gosmarter.ai
/api/company/{companyId}/millcertification/{millCertificationId}/branded-report

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.

Generate branded Material Test Certificate PDF › path Parameters

companyId
​string · uuid · required

The unique identifier of the company

millCertificationId
​string · uuid · required

The unique identifier of the mill certification to derive the report from

Generate branded Material Test Certificate PDF › query Parameters

heatCode
​string

Optional heat number to restrict the report to. OR'd with productReference — when both are supplied, a heat/mech-property row qualifies if either matches.

productReference
​string

Optional product reference to restrict the report to. OR'd with heatCode — when both are supplied, a heat/mech-property row qualifies if either matches.

Generate branded Material Test Certificate PDF › Headers

GoSmarter-Api-Key
​string · required

The 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

string · binary

Get mill certification details

GET
https://api.gosmarter.ai
/api/company/{companyId}/millcertification/{millCertificationId}

Retrieves detailed information about a specific mill certification including document-level metadata (supplier, mill, linked supplier/mill organisations (reported as unlinked if the organisation has since been deleted), standard, quality, production process, CARES QR, certificate date, customer), archive state, pages, heats with chemical composition, and mechanical properties

Get mill certification details › path Parameters

companyId
​string · uuid · required

The unique identifier of the company. Example: 11111111-2222-3333-4444-555555555555

millCertificationId
​string · uuid · required

The unique identifier of the mill certification. Example: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee

Get mill certification details › Headers

GoSmarter-Api-Key
​string · required

The 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

detailedMillCertificationDto
​defenderResultDto
newFileName
​string
defenderResultId
​string · uuid
dateInserted
​string · date-time
dateModified
​string · date-time
heatCodes
​string
millCertificationId
​string · uuid
companyId
​string · uuid
originalFileName
​string
storageFileName
​string
status
​integer · int32
millCertificationStatusLabel
​string
millCertificationStatusNotes
​string
millCertificationStatusType
​string

Upload a mill certification

POST
https://api.gosmarter.ai
/api/company/{companyId}/millcertification/{millCertificationId}

Uploads a single mill certification file (PDF or image) with rate limiting and validation. The client supplies the mill certification GUID.

Upload a mill certification › path Parameters

companyId
​string · uuid · required

The unique identifier of the company. Example: 11111111-2222-3333-4444-555555555555

millCertificationId
​string · uuid · required

Client-generated GUID that identifies this mill certification. Used as the record ID and the blob storage file name.

Upload a mill certification › query Parameters

uploadBatchId
​string · uuid

Optional 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.

Upload a mill certification › Headers

GoSmarter-Api-Key
​string · required

The 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 › Request Body

Upload a mill certification › Responses

Mill certification uploaded successfully

millCertification
millCertificationId
​string · uuid
companyId
​string · uuid
defenderResultId
​string · uuid
originalFileName
​string
newFileName
​string
storageFileName
​string
status
​integer · enum · int32
Enum values:
0
10
15
19
20
25
30
40
Default: 0
isTestRun
​boolean

Get mill certification change history

GET
https://api.gosmarter.ai
/api/company/{companyId}/mill-certs/{millCertificationId}/history

Returns field-level audit history for a specific mill certification, its heats, and mechanical properties, derived from SQL Server temporal tables. All events are interleaved in a single chronological timeline. AI-written changes have no ChangedBy (shown as System).

Get mill certification change history › path Parameters

companyId
​string · uuid · required

The unique identifier of the company

millCertificationId
​string · uuid · required

The unique identifier of the mill certification

Get mill certification change history › Headers

GoSmarter-Api-Key
​string · required

The 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 change history › Responses

Interleaved audit events for the cert, heats, and mechanical properties

auditEventDto
changedAt
​string · date-time
changedById
​string · uuid
changedByName
​string
changeType
​string
entityType
​string
entityLabel
​string

Get fuzzy-matched Organisation suggestions for a mill certificate's Supplier/Mill text

GET
https://api.gosmarter.ai
/api/company/{companyId}/millcertification/{millCertificationId}/organisation-matches

Fuzzy-matches the certificate's extracted Supplier and Mill free text against the company's Organisations, returning ranked suggestions for a human to confirm before linking (issue #1146).

Get fuzzy-matched Organisation suggestions for a mill certificate's Supplier/Mill text › path Parameters

companyId
​string · uuid · required

The unique identifier of the company

millCertificationId
​string · uuid · required

The unique identifier of the mill certification

Get fuzzy-matched Organisation suggestions for a mill certificate's Supplier/Mill text › Headers

GoSmarter-Api-Key
​string · required

The GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.

Get fuzzy-matched Organisation suggestions for a mill certificate's Supplier/Mill text › Responses

Ranked Organisation match suggestions for Supplier and Mill

organisationMatchResultsDto
​millCertSupplierDto
​millCertSupplierDto

Get mill certification page content

GET
https://api.gosmarter.ai
/api/company/{companyId}/millcertification/{millCertificationId}/page/{millCertificationPageId}

Streams the content for a specific mill certification page (PDF or image). Use this endpoint to render files without cross-origin issues.

Get mill certification page content › path Parameters

companyId
​string · uuid · required

The unique identifier of the company

millCertificationId
​string · uuid · required

The unique identifier of the mill certification

millCertificationPageId
​string · uuid · required

The unique identifier of the mill certification page

Get mill certification page content › Headers

GoSmarter-Api-Key
​string · required

The 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

string · binary

Get signed URLs for mill certification pages

GET
https://api.gosmarter.ai
/api/company/{companyId}/millcertification/{millCertificationId}/page-urls

Retrieves time-limited signed URLs for accessing mill certification page blobs (PDF or image)

Get signed URLs for mill certification pages › path Parameters

companyId
​string · uuid · required

The unique identifier of the company

millCertificationId
​string · uuid · required

The unique identifier of the mill certification

Get signed URLs for mill certification pages › Headers

GoSmarter-Api-Key
​string · required

The 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

millCertPageUrlDto
millCertificationPageId
​string · uuid
pageFileName
​string
pageNumber
​integer · int32
signedUrl
​string
contentType
​string

List archived mill certifications

GET
https://api.gosmarter.ai
/api/company/{companyId}/millcertification/archived

Retrieves a list of all archived mill certifications for a company (IsArchived = 1)

List archived mill certifications › path Parameters

companyId
​string · uuid · required

The unique identifier of the company

List archived mill certifications › Headers

GoSmarter-Api-Key
​string · required

The GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.

List archived mill certifications › Responses

Archived mill certifications list retrieved successfully

millCertificationDto
newFileName
​string
defenderResultId
​string · uuid
dateInserted
​string · date-time
dateModified
​string · date-time
heatCodes
​string
millCertificationId
​string · uuid
companyId
​string · uuid
originalFileName
​string
storageFileName
​string
status
​integer · int32
millCertificationStatusLabel
​string
millCertificationStatusNotes
​string
millCertificationStatusType
​string

List mill certifications suggested for archiving

GET
https://api.gosmarter.ai
/api/company/{companyId}/millcertification/archive-suggestions

Certs older than 30 days with no remaining linked inventory quantity/weight.

List mill certifications suggested for archiving › path Parameters

companyId
​string · uuid · required

The unique identifier of the company

List mill certifications suggested for archiving › Headers

GoSmarter-Api-Key
​string · required

The 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 suggested for archiving › Responses

Mill certification IDs eligible for archiving

​string[]

List deleted mill certifications

GET
https://api.gosmarter.ai
/api/company/{companyId}/millcertification/deleted

Retrieves a list of all soft-deleted mill certifications for a company (Active = 0)

List deleted mill certifications › path Parameters

companyId
​string · uuid · required

The unique identifier of the company

List deleted mill certifications › Headers

GoSmarter-Api-Key
​string · required

The GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.

List deleted mill certifications › Responses

Deleted mill certifications list retrieved successfully

millCertificationDto
newFileName
​string
defenderResultId
​string · uuid
dateInserted
​string · date-time
dateModified
​string · date-time
heatCodes
​string
millCertificationId
​string · uuid
companyId
​string · uuid
originalFileName
​string
storageFileName
​string
status
​integer · int32
millCertificationStatusLabel
​string
millCertificationStatusNotes
​string
millCertificationStatusType
​string

Manually create a mill certification

POST
https://api.gosmarter.ai
/api/company/{companyId}/millcertification/{millCertificationId}/manual

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.

Manually create a mill certification › path Parameters

companyId
​string · uuid · required

The unique identifier of the company.

millCertificationId
​string · uuid · required

Client-generated GUID that identifies this mill certification.

Manually create a mill certification › Headers

GoSmarter-Api-Key
​string · required

The 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 › Request Body

Manually create a mill certification › Responses

Mill certification created successfully

manualCreateMillCertificationRow
millCertificationId
​string · uuid
companyId
​string · uuid
originalFileName
​string
storageFileName
​string
status
​integer · enum · int32
Enum values:
0
10
15
19
20
25
30
40
Default: 0
isTestRun
​boolean
supplier
​string
mill
​string
supplierOrganisationId
​string · uuid
millOrganisationId
​string · uuid
standard
​string
quality
​string
grade
​string
productionProcess
​string
countryOfMeltAndPour
​string
caresQR
​string
certificateDate
​string
customerName
​string
customerAddress
​string
descriptionOfGoods
​string
rollingMark
​string
caresDispensationReference
​string
radioactivityStatement
​string
conformityStatement
​string
caresApproval
​string
invoiceNumber
​string
productForm
​string
complianceStatement
​string
dateOfIssueAndValidation
​string
inspectionOriginator
​string
signatoryName
​string
signatoryRole
​string
signaturePresent
​boolean
signatureDate
​string
issueLocation
​string
ceMarkPresent
​boolean
ceMarkingCertificateNo
​string
ukcaMarkPresent
​boolean
ukcaMarkingCertificateNo
​string
contentType
​string
fileSizeBytes
​integer · int64
entrySource
​integer · enum · int32
Enum values:
0
1
Default: 0
uploadedBy
​string · uuid

Restore deleted mill certifications

POST
https://api.gosmarter.ai
/api/company/{companyId}/millcertification/restore

Restores one or more soft-deleted mill certifications by setting Active = 1.

Restore deleted mill certifications › path Parameters

companyId
​string · uuid · required

The unique identifier of the company

Restore deleted mill certifications › Headers

GoSmarter-Api-Key
​string · required

The GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.

Restore deleted mill certifications › Request Body

​string[]

Restore deleted mill certifications › Responses

Mill certifications restored successfully

deleteResponse
deletedCount
​integer · int32

Number of items deleted

deletedIds
​string[]

List of IDs that were deleted

Review a mill certification

POST
https://api.gosmarter.ai
/api/company/{companyId}/millcertification/{millCertificationId}/review

Submits or updates a review decision (Approved or Issue) for a completed mill certification.

Review a mill certification › path Parameters

companyId
​string · uuid · required

The unique identifier of the company

millCertificationId
​string · uuid · required

The unique identifier of the mill certification

Review a mill certification › Headers

GoSmarter-Api-Key
​string · required

The 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

reviewMillCertificationRequest
reviewStatus
​integer · enum · int32
Enum values:
1
2
Default: 1
comment
​string
overriddenTagIds
​string[]

Tag IDs the reviewer is explicitly overriding (required if any Block-severity tag is present when approving)

Review a mill certification › Responses

Review submitted successfully

reviewMillCertificationResponse
millCertificationId
​string · uuid
reviewStatus
​integer · int32
reviewStatusLabel
​string
reviewComment
​string
reviewedByName
​string
reviewedAt
​string · date-time
message
​string

Unarchive mill certifications

POST
https://api.gosmarter.ai
/api/company/{companyId}/millcertification/unarchive

Unarchives one or more mill certifications by setting IsArchived = 0.

Unarchive mill certifications › path Parameters

companyId
​string · uuid · required

The unique identifier of the company

Unarchive mill certifications › Headers

GoSmarter-Api-Key
​string · required

The GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.

Unarchive mill certifications › Request Body

​string[]

Unarchive mill certifications › Responses

Mill certifications unarchived successfully

deleteResponse
deletedCount
​integer · int32

Number of items deleted

deletedIds
​string[]

List of IDs that were deleted

Update mill certification data

PUT
https://api.gosmarter.ai
/api/company/{companyId}/millcertification/{millCertificationId}/update

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.

Update mill certification data › path Parameters

companyId
​string · uuid · required

The unique identifier of the company.

millCertificationId
​string · uuid · required

The unique identifier of the mill certification.

Update mill certification data › Headers

GoSmarter-Api-Key
​string · required

The 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

updateMillCertificationRequest
deletedHeatIds
​string[]
deletedMechanicalPropertyIds
​string[]

Update mill certification data › Responses

All changes persisted successfully

updateMillCertificationRequest
deletedHeatIds
​string[]
deletedMechanicalPropertyIds
​string[]
OptimisationFilterProfilesMillCertTags