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[]

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

GET/api/company/{companyId}/millcertification

curl https://api.gosmarter.ai/api/company/:companyId/millcertification \
  --header 'GoSmarter-Api-Key: <string>' \
  --header 'Authorization: Bearer <token>'

Example Responses

[
  {
    "newFileName": "newFileName",
    "defenderResultId": "00000000-0000-0000-0000-000000000000",
    "dateInserted": "2024-08-25T15:00:00Z",
    "dateModified": "2024-08-25T15:00:00Z",
    "heatCodes": "heatCodes",
    "millCertificationId": "00000000-0000-0000-0000-000000000000",
    "companyId": "00000000-0000-0000-0000-000000000000",
    "originalFileName": "originalFileName",
    "storageFileName": "storageFileName",
    "status": 0,
    "millCertificationStatusLabel": "millCertificationStatusLabel",
    "millCertificationStatusNotes": "millCertificationStatusNotes",
    "millCertificationStatusType": "millCertificationStatusType"
  }
]

json

application/json

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, standard, quality, production process, CARES QR, certificate date, customer), 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

detailedMillCertificationPageDto[]

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

GET/api/company/{companyId}/millcertification/{millCertificationId}

curl https://api.gosmarter.ai/api/company/:companyId/millcertification/:millCertificationId \
  --header 'GoSmarter-Api-Key: <string>' \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "pages": [
    {
      "heats": [
        {
          "mechanicalProperties": [
            {
              "testNumber": 0,
              "massPerMeter": 0,
              "createdAt": "2024-08-25T15:00:00Z",
              "updatedAt": "2024-08-25T15:00:00Z",
              "millCertificationMechanicalPropertyId": "00000000-0000-0000-0000-000000000000",
              "companyId": "00000000-0000-0000-0000-000000000000",
              "millCertificationHeatId": "00000000-0000-0000-0000-000000000000"
            }
          ],
          "heatNumber": "heatNumber",
          "diameter": 0,
          "length": 0,
          "carbonEquivalent": 0,
          "createdAt": "2024-08-25T15:00:00Z",
          "updatedAt": "2024-08-25T15:00:00Z",
          "millCertificationHeatId": "00000000-0000-0000-0000-000000000000",
          "companyId": "00000000-0000-0000-0000-000000000000",
          "millCertificationPageId": "00000000-0000-0000-0000-000000000000"
        }
      ],
      "newFileName": "newFileName",
      "classificationModelResult": "classificationModelResult",
      "extractionModel": "extractionModel",
      "extractionModelResult": "extractionModelResult",
      "createdAt": "2024-08-25T15:00:00Z",
      "updatedAt": "2024-08-25T15:00:00Z",
      "millCertificationStatusLabel": "millCertificationStatusLabel",
      "millCertificationStatusNotes": "millCertificationStatusNotes",
      "millCertificationStatusType": "millCertificationStatusType",
      "millCertificationPageId": "00000000-0000-0000-0000-000000000000",
      "companyId": "00000000-0000-0000-0000-000000000000",
      "millCertificationId": "00000000-0000-0000-0000-000000000000",
      "blobUri": "blobUri",
      "originalFileName": "originalFileName",
      "status": 0
    }
  ],
  "defenderResult": {
    "defenderResultId": 0,
    "subject": "subject",
    "correlationId": "00000000-0000-0000-0000-000000000000",
    "blobUri": "blobUri",
    "eTag": "eTag",
    "scanFinishedTimeUtc": "2024-08-25T15:00:00Z",
    "scanResultType": "scanResultType",
    "malwareNamesFound": "malwareNamesFound",
    "malwareSha256": "malwareSha256",
    "eventType": "eventType",
    "dataVersion": "dataVersion",
    "metadataVersion": "metadataVersion",
    "eventTime": "2024-08-25T15:00:00Z",
    "topic": "topic",
    "createdAt": "2024-08-25T15:00:00Z",
    "updatedAt": "2024-08-25T15:00:00Z"
  },
  "newFileName": "newFileName",
  "defenderResultId": "00000000-0000-0000-0000-000000000000",
  "dateInserted": "2024-08-25T15:00:00Z",
  "dateModified": "2024-08-25T15:00:00Z",
  "heatCodes": "heatCodes",
  "millCertificationId": "00000000-0000-0000-0000-000000000000",
  "companyId": "00000000-0000-0000-0000-000000000000",
  "originalFileName": "originalFileName",
  "storageFileName": "storageFileName",
  "status": 0,
  "millCertificationStatusLabel": "millCertificationStatusLabel",
  "millCertificationStatusNotes": "millCertificationStatusNotes",
  "millCertificationStatusType": "millCertificationStatusType"
}

json

application/json

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:

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[]

auditEventDto

changedAt

string · date-time

changedById

string · uuid

changedByName

string

changeType

string

auditFieldChange[]

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

organisationMatchCandidateDto[]

millCertSupplierDto

GET/api/company/{companyId}/millcertification/{millCertificationId}/organisation-matches

curl https://api.gosmarter.ai/api/company/:companyId/millcertification/:millCertificationId/organisation-matches \
  --header 'GoSmarter-Api-Key: <string>' \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "supplierMatches": [
    {
      "organisationId": "00000000-0000-0000-0000-000000000000",
      "name": "name",
      "score": 0
    }
  ],
  "millMatches": [
    {
      "organisationId": "00000000-0000-0000-0000-000000000000",
      "name": "name",
      "score": 0
    }
  ],
  "supplierReferenceSuggestion": {
    "millCertSupplierId": 0,
    "name": "name",
    "website": "website",
    "countryId": 0,
    "countryName": "countryName",
    "aliases": [
      "string"
    ],
    "mills": [
      {
        "millCertSupplierMillId": 0,
        "name": "name",
        "addressLine1": "addressLine1",
        "addressLine2": "addressLine2",
        "city": "city",
        "region": "region",
        "postalCode": "postalCode",
        "countryId": 0,
        "countryName": "countryName",
        "latitude": 0,
        "longitude": 0,
        "geocodeConfidence": 0,
        "geocodedAt": "2024-08-25T15:00:00Z"
      }
    ]
  },
  "millReferenceSuggestion": {
    "millCertSupplierId": 0,
    "name": "name",
    "website": "website",
    "countryId": 0,
    "countryName": "countryName",
    "aliases": [
      "string"
    ],
    "mills": [
      {
        "millCertSupplierMillId": 0,
        "name": "name",
        "addressLine1": "addressLine1",
        "addressLine2": "addressLine2",
        "city": "city",
        "region": "region",
        "postalCode": "postalCode",
        "countryId": 0,
        "countryName": "countryName",
        "latitude": 0,
        "longitude": 0,
        "geocodeConfidence": 0,
        "geocodedAt": "2024-08-25T15:00:00Z"
      }
    ]
  }
}

json

application/json

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[]

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[]

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

GET/api/company/{companyId}/millcertification/archived

curl https://api.gosmarter.ai/api/company/:companyId/millcertification/archived \
  --header 'GoSmarter-Api-Key: <string>' \
  --header 'Authorization: Bearer <token>'

Example Responses

[
  {
    "newFileName": "newFileName",
    "defenderResultId": "00000000-0000-0000-0000-000000000000",
    "dateInserted": "2024-08-25T15:00:00Z",
    "dateModified": "2024-08-25T15:00:00Z",
    "heatCodes": "heatCodes",
    "millCertificationId": "00000000-0000-0000-0000-000000000000",
    "companyId": "00000000-0000-0000-0000-000000000000",
    "originalFileName": "originalFileName",
    "storageFileName": "storageFileName",
    "status": 0,
    "millCertificationStatusLabel": "millCertificationStatusLabel",
    "millCertificationStatusNotes": "millCertificationStatusNotes",
    "millCertificationStatusType": "millCertificationStatusType"
  }
]

json

application/json

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[]

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

GET/api/company/{companyId}/millcertification/deleted

curl https://api.gosmarter.ai/api/company/:companyId/millcertification/deleted \
  --header 'GoSmarter-Api-Key: <string>' \
  --header 'Authorization: Bearer <token>'

Example Responses

[
  {
    "newFileName": "newFileName",
    "defenderResultId": "00000000-0000-0000-0000-000000000000",
    "dateInserted": "2024-08-25T15:00:00Z",
    "dateModified": "2024-08-25T15:00:00Z",
    "heatCodes": "heatCodes",
    "millCertificationId": "00000000-0000-0000-0000-000000000000",
    "companyId": "00000000-0000-0000-0000-000000000000",
    "originalFileName": "originalFileName",
    "storageFileName": "storageFileName",
    "status": 0,
    "millCertificationStatusLabel": "millCertificationStatusLabel",
    "millCertificationStatusNotes": "millCertificationStatusNotes",
    "millCertificationStatusType": "millCertificationStatusType"
  }
]

json

application/json

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:

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:

Default: 0

uploadedBy

string · uuid

POST/api/company/{companyId}/millcertification/{millCertificationId}/manual

curl https://api.gosmarter.ai/api/company/:companyId/millcertification/:millCertificationId/manual \
  --request POST \
  --header 'Content-Type: multipart/form-data' \
  --header 'GoSmarter-Api-Key: <string>' \
  --header 'Authorization: Bearer <token>'

Example Request Body

{}

text

Example Responses

{
  "millCertificationId": "00000000-0000-0000-0000-000000000000",
  "companyId": "00000000-0000-0000-0000-000000000000",
  "originalFileName": "originalFileName",
  "storageFileName": "storageFileName",
  "status": 0,
  "isTestRun": true,
  "supplier": "supplier",
  "mill": "mill",
  "supplierOrganisationId": "00000000-0000-0000-0000-000000000000",
  "millOrganisationId": "00000000-0000-0000-0000-000000000000",
  "standard": "standard",
  "quality": "quality",
  "grade": "grade",
  "productionProcess": "productionProcess",
  "countryOfMeltAndPour": "countryOfMeltAndPour",
  "caresQR": "caresQR",
  "certificateDate": "certificateDate",
  "customerName": "customerName",
  "customerAddress": "customerAddress",
  "descriptionOfGoods": "descriptionOfGoods",
  "rollingMark": "rollingMark",
  "caresDispensationReference": "caresDispensationReference",
  "radioactivityStatement": "radioactivityStatement",
  "conformityStatement": "conformityStatement",
  "caresApproval": "caresApproval",
  "invoiceNumber": "invoiceNumber",
  "productForm": "productForm",
  "complianceStatement": "complianceStatement",
  "dateOfIssueAndValidation": "dateOfIssueAndValidation",
  "inspectionOriginator": "inspectionOriginator",
  "signatoryName": "signatoryName",
  "signatoryRole": "signatoryRole",
  "signaturePresent": true,
  "signatureDate": "signatureDate",
  "issueLocation": "issueLocation",
  "ceMarkPresent": true,
  "ceMarkingCertificateNo": "ceMarkingCertificateNo",
  "ukcaMarkPresent": true,
  "ukcaMarkingCertificateNo": "ukcaMarkingCertificateNo",
  "contentType": "contentType",
  "fileSizeBytes": 0,
  "entrySource": 0,
  "uploadedBy": "00000000-0000-0000-0000-000000000000"
}

json

application/json

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:

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

POST/api/company/{companyId}/millcertification/{millCertificationId}/review

curl https://api.gosmarter.ai/api/company/:companyId/millcertification/:millCertificationId/review \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'GoSmarter-Api-Key: <string>' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "reviewStatus": 1,
  "comment": "comment",
  "overriddenTagIds": [
    "00000000-0000-0000-0000-000000000000"
  ]
}'

Example Request Body

{
  "reviewStatus": 1,
  "comment": "comment",
  "overriddenTagIds": [
    "00000000-0000-0000-0000-000000000000"
  ]
}

json

Example Responses

{
  "millCertificationId": "00000000-0000-0000-0000-000000000000",
  "reviewStatus": 0,
  "reviewStatusLabel": "reviewStatusLabel",
  "reviewComment": "reviewComment",
  "reviewedByName": "reviewedByName",
  "reviewedAt": "2024-08-25T15:00:00Z",
  "message": "message"
}

json

application/json

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

millCertificationDocumentFieldUpdateDto

millCertificationHeatUpdateDto[]

millCertificationMechanicalPropertyUpdateDto[]

deletedHeatIds

string[]

deletedMechanicalPropertyIds

string[]

millCertificationPageUpdateDto[]

heatPageNumbersDto[]

Update mill certification data › Responses

All changes persisted successfully

updateMillCertificationRequest

millCertificationDocumentFieldUpdateDto

millCertificationHeatUpdateDto[]

millCertificationMechanicalPropertyUpdateDto[]

deletedHeatIds

string[]

deletedMechanicalPropertyIds

string[]

millCertificationPageUpdateDto[]

heatPageNumbersDto[]

PUT/api/company/{companyId}/millcertification/{millCertificationId}/update

curl https://api.gosmarter.ai/api/company/:companyId/millcertification/:millCertificationId/update \
  --request PUT \
  --header 'Content-Type: application/json' \
  --header 'GoSmarter-Api-Key: <string>' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "documentFields": {
    "millCertificationId": "00000000-0000-0000-0000-000000000000",
    "supplier": "supplier",
    "mill": "mill",
    "supplierOrganisationId": "00000000-0000-0000-0000-000000000000",
    "millOrganisationId": "00000000-0000-0000-0000-000000000000",
    "standard": "standard",
    "quality": "quality",
    "grade": "grade",
    "productionProcess": "productionProcess",
    "countryOfMeltAndPour": "countryOfMeltAndPour",
    "caresQR": "caresQR",
    "certificateDate": "certificateDate",
    "customerName": "customerName",
    "customerAddress": "customerAddress",
    "descriptionOfGoods": "descriptionOfGoods",
    "rollingMark": "rollingMark",
    "caresDispensationReference": "caresDispensationReference",
    "radioactivityStatement": "radioactivityStatement",
    "conformityStatement": "conformityStatement",
    "caresApproval": "caresApproval",
    "invoiceNumber": "invoiceNumber",
    "productForm": "productForm",
    "complianceStatement": "complianceStatement",
    "dateOfIssueAndValidation": "dateOfIssueAndValidation",
    "inspectionOriginator": "inspectionOriginator",
    "signatoryName": "signatoryName",
    "signatoryRole": "signatoryRole",
    "signaturePresent": true,
    "signatureDate": "signatureDate",
    "issueLocation": "issueLocation",
    "ceMarkPresent": true,
    "ceMarkingCertificateNo": "ceMarkingCertificateNo",
    "ukcaMarkPresent": true,
    "ukcaMarkingCertificateNo": "ukcaMarkingCertificateNo",
    "lastModifiedBy": "00000000-0000-0000-0000-000000000000",
    "dateModified": "2024-08-25T15:00:00Z"
  },
  "heats": [
    {
      "millCertificationHeatId": "00000000-0000-0000-0000-000000000000",
      "companyId": "00000000-0000-0000-0000-000000000000",
      "millCertificationPageId": "00000000-0000-0000-0000-000000000000",
      "heatNumber": "heatNumber",
      "productReference": "productReference",
      "productForm": "productForm",
      "quality": "quality",
      "grade": "grade",
      "countryOfMeltAndPour": "countryOfMeltAndPour",
      "diameter": 0,
      "length": 0,
      "carbonEquivalent": 0,
      "carbon": 0,
      "manganese": 0,
      "silicon": 0,
      "phosphorus": 0,
      "sulphur": 0,
      "chromium": 0,
      "nickel": 0,
      "copper": 0,
      "molybdenum": 0,
      "vanadium": 0,
      "nitrogen": 0,
      "boron": 0,
      "aluminium": 0,
      "niobium": 0,
      "titanium": 0,
      "width": 0,
      "relativeRibArea": 0,
      "modifiedBy": "00000000-0000-0000-0000-000000000000",
      "active": true
    }
  ],
  "mechanicalProperties": [
    {
      "millCertificationMechanicalPropertyId": "00000000-0000-0000-0000-000000000000",
      "companyId": "00000000-0000-0000-0000-000000000000",
      "millCertificationHeatId": "00000000-0000-0000-0000-000000000000",
      "testNumber": 0,
      "massPerMeter": 0,
      "yieldStrength": 0,
      "tensileStrength": 0,
      "rmReRatio": 0,
      "elongationA5": 0,
      "elongationAgt": 0,
      "bendTest": "bendTest",
      "rebendTest": "rebendTest",
      "impactEnergyJ": 0,
      "impactTemperatureDegC": 0,
      "hardnessValue": 0,
      "hardnessScale": "hardnessScale",
      "productionNumber": "productionNumber",
      "quantity": 0,
      "numberOfBundles": 0,
      "modifiedBy": "00000000-0000-0000-0000-000000000000",
      "active": true
    }
  ],
  "deletedHeatIds": [
    "00000000-0000-0000-0000-000000000000"
  ],
  "deletedMechanicalPropertyIds": [
    "00000000-0000-0000-0000-000000000000"
  ],
  "pages": [
    {
      "millCertificationPageId": "00000000-0000-0000-0000-000000000000",
      "companyId": "00000000-0000-0000-0000-000000000000",
      "pageNumber": 0
    }
  ],
  "heatPages": [
    {
      "millCertificationHeatId": "00000000-0000-0000-0000-000000000000",
      "pageNumbers": [
        0
      ]
    }
  ]
}'

Example Request Body

{
  "documentFields": {
    "millCertificationId": "00000000-0000-0000-0000-000000000000",
    "supplier": "supplier",
    "mill": "mill",
    "supplierOrganisationId": "00000000-0000-0000-0000-000000000000",
    "millOrganisationId": "00000000-0000-0000-0000-000000000000",
    "standard": "standard",
    "quality": "quality",
    "grade": "grade",
    "productionProcess": "productionProcess",
    "countryOfMeltAndPour": "countryOfMeltAndPour",
    "caresQR": "caresQR",
    "certificateDate": "certificateDate",
    "customerName": "customerName",
    "customerAddress": "customerAddress",
    "descriptionOfGoods": "descriptionOfGoods",
    "rollingMark": "rollingMark",
    "caresDispensationReference": "caresDispensationReference",
    "radioactivityStatement": "radioactivityStatement",
    "conformityStatement": "conformityStatement",
    "caresApproval": "caresApproval",
    "invoiceNumber": "invoiceNumber",
    "productForm": "productForm",
    "complianceStatement": "complianceStatement",
    "dateOfIssueAndValidation": "dateOfIssueAndValidation",
    "inspectionOriginator": "inspectionOriginator",
    "signatoryName": "signatoryName",
    "signatoryRole": "signatoryRole",
    "signaturePresent": true,
    "signatureDate": "signatureDate",
    "issueLocation": "issueLocation",
    "ceMarkPresent": true,
    "ceMarkingCertificateNo": "ceMarkingCertificateNo",
    "ukcaMarkPresent": true,
    "ukcaMarkingCertificateNo": "ukcaMarkingCertificateNo",
    "lastModifiedBy": "00000000-0000-0000-0000-000000000000",
    "dateModified": "2024-08-25T15:00:00Z"
  },
  "heats": [
    {
      "millCertificationHeatId": "00000000-0000-0000-0000-000000000000",
      "companyId": "00000000-0000-0000-0000-000000000000",
      "millCertificationPageId": "00000000-0000-0000-0000-000000000000",
      "heatNumber": "heatNumber",
      "productReference": "productReference",
      "productForm": "productForm",
      "quality": "quality",
      "grade": "grade",
      "countryOfMeltAndPour": "countryOfMeltAndPour",
      "diameter": 0,
      "length": 0,
      "carbonEquivalent": 0,
      "carbon": 0,
      "manganese": 0,
      "silicon": 0,
      "phosphorus": 0,
      "sulphur": 0,
      "chromium": 0,
      "nickel": 0,
      "copper": 0,
      "molybdenum": 0,
      "vanadium": 0,
      "nitrogen": 0,
      "boron": 0,
      "aluminium": 0,
      "niobium": 0,
      "titanium": 0,
      "width": 0,
      "relativeRibArea": 0,
      "modifiedBy": "00000000-0000-0000-0000-000000000000",
      "active": true
    }
  ],
  "mechanicalProperties": [
    {
      "millCertificationMechanicalPropertyId": "00000000-0000-0000-0000-000000000000",
      "companyId": "00000000-0000-0000-0000-000000000000",
      "millCertificationHeatId": "00000000-0000-0000-0000-000000000000",
      "testNumber": 0,
      "massPerMeter": 0,
      "yieldStrength": 0,
      "tensileStrength": 0,
      "rmReRatio": 0,
      "elongationA5": 0,
      "elongationAgt": 0,
      "bendTest": "bendTest",
      "rebendTest": "rebendTest",
      "impactEnergyJ": 0,
      "impactTemperatureDegC": 0,
      "hardnessValue": 0,
      "hardnessScale": "hardnessScale",
      "productionNumber": "productionNumber",
      "quantity": 0,
      "numberOfBundles": 0,
      "modifiedBy": "00000000-0000-0000-0000-000000000000",
      "active": true
    }
  ],
  "deletedHeatIds": [
    "00000000-0000-0000-0000-000000000000"
  ],
  "deletedMechanicalPropertyIds": [
    "00000000-0000-0000-0000-000000000000"
  ],
  "pages": [
    {
      "millCertificationPageId": "00000000-0000-0000-0000-000000000000",
      "companyId": "00000000-0000-0000-0000-000000000000",
      "pageNumber": 0
    }
  ],
  "heatPages": [
    {
      "millCertificationHeatId": "00000000-0000-0000-0000-000000000000",
      "pageNumbers": [
        0
      ]
    }
  ]
}

json

Example Responses

{
  "documentFields": {
    "millCertificationId": "00000000-0000-0000-0000-000000000000",
    "supplier": "supplier",
    "mill": "mill",
    "supplierOrganisationId": "00000000-0000-0000-0000-000000000000",
    "millOrganisationId": "00000000-0000-0000-0000-000000000000",
    "standard": "standard",
    "quality": "quality",
    "grade": "grade",
    "productionProcess": "productionProcess",
    "countryOfMeltAndPour": "countryOfMeltAndPour",
    "caresQR": "caresQR",
    "certificateDate": "certificateDate",
    "customerName": "customerName",
    "customerAddress": "customerAddress",
    "descriptionOfGoods": "descriptionOfGoods",
    "rollingMark": "rollingMark",
    "caresDispensationReference": "caresDispensationReference",
    "radioactivityStatement": "radioactivityStatement",
    "conformityStatement": "conformityStatement",
    "caresApproval": "caresApproval",
    "invoiceNumber": "invoiceNumber",
    "productForm": "productForm",
    "complianceStatement": "complianceStatement",
    "dateOfIssueAndValidation": "dateOfIssueAndValidation",
    "inspectionOriginator": "inspectionOriginator",
    "signatoryName": "signatoryName",
    "signatoryRole": "signatoryRole",
    "signaturePresent": true,
    "signatureDate": "signatureDate",
    "issueLocation": "issueLocation",
    "ceMarkPresent": true,
    "ceMarkingCertificateNo": "ceMarkingCertificateNo",
    "ukcaMarkPresent": true,
    "ukcaMarkingCertificateNo": "ukcaMarkingCertificateNo",
    "lastModifiedBy": "00000000-0000-0000-0000-000000000000",
    "dateModified": "2024-08-25T15:00:00Z"
  },
  "heats": [
    {
      "millCertificationHeatId": "00000000-0000-0000-0000-000000000000",
      "companyId": "00000000-0000-0000-0000-000000000000",
      "millCertificationPageId": "00000000-0000-0000-0000-000000000000",
      "heatNumber": "heatNumber",
      "productReference": "productReference",
      "productForm": "productForm",
      "quality": "quality",
      "grade": "grade",
      "countryOfMeltAndPour": "countryOfMeltAndPour",
      "diameter": 0,
      "length": 0,
      "carbonEquivalent": 0,
      "carbon": 0,
      "manganese": 0,
      "silicon": 0,
      "phosphorus": 0,
      "sulphur": 0,
      "chromium": 0,
      "nickel": 0,
      "copper": 0,
      "molybdenum": 0,
      "vanadium": 0,
      "nitrogen": 0,
      "boron": 0,
      "aluminium": 0,
      "niobium": 0,
      "titanium": 0,
      "width": 0,
      "relativeRibArea": 0,
      "modifiedBy": "00000000-0000-0000-0000-000000000000",
      "active": true
    }
  ],
  "mechanicalProperties": [
    {
      "millCertificationMechanicalPropertyId": "00000000-0000-0000-0000-000000000000",
      "companyId": "00000000-0000-0000-0000-000000000000",
      "millCertificationHeatId": "00000000-0000-0000-0000-000000000000",
      "testNumber": 0,
      "massPerMeter": 0,
      "yieldStrength": 0,
      "tensileStrength": 0,
      "rmReRatio": 0,
      "elongationA5": 0,
      "elongationAgt": 0,
      "bendTest": "bendTest",
      "rebendTest": "rebendTest",
      "impactEnergyJ": 0,
      "impactTemperatureDegC": 0,
      "hardnessValue": 0,
      "hardnessScale": "hardnessScale",
      "productionNumber": "productionNumber",
      "quantity": 0,
      "numberOfBundles": 0,
      "modifiedBy": "00000000-0000-0000-0000-000000000000",
      "active": true
    }
  ],
  "deletedHeatIds": [
    "00000000-0000-0000-0000-000000000000"
  ],
  "deletedMechanicalPropertyIds": [
    "00000000-0000-0000-0000-000000000000"
  ],
  "pages": [
    {
      "millCertificationPageId": "00000000-0000-0000-0000-000000000000",
      "companyId": "00000000-0000-0000-0000-000000000000",
      "pageNumber": 0
    }
  ],
  "heatPages": [
    {
      "millCertificationHeatId": "00000000-0000-0000-0000-000000000000",
      "pageNumbers": [
        0
      ]
    }
  ]
}

json

application/json

OptimisationFilterProfiles MillCertTags