GoSmarter Logo
GoSmarter API Gateway

checkAccessResponse

featureKey
​string
hasAccess
​boolean
message
​string

companyDto

createdAt
​string · date-time
updatedAt
​string · date-time
companyId
​string · uuid
companyName
​string
address
​string

companyInventoryMaterialDto

companyInventoryMaterialId
​integer · int32
companyId
​string · uuid
inventoryMaterialId
​integer · int32
category
​string
value
​string
active
​boolean

companyInventoryTypeDto

companyInventoryTypeId
​integer · int32
companyId
​string · uuid
inventoryTypeId
​integer · int32
category
​string
value
​string
active
​boolean

companyStockLocationDto

companyStockLocationId
​integer · int32
companyId
​string · uuid
stockLocationId
​integer · int32
category
​string
value
​string
active
​boolean

coreCompanyDto

companyId
​string · uuid
companyName
​string
address
​string

coreOptimisationRequestTriggerDto

optimisationRequestTriggerId
​string · uuid
companyId
​string · uuid

coreUserDto

userId
​string · uuid
firstName
​string
lastName
​string
tutorialMode
​boolean

userUpdateRequest

userId
​string · uuid
firstName
​string
lastName
​string
tutorialMode
​boolean

createInventoryTagDto

name
​string

Tag name (must be unique within company)

color
​string

Hex color code for the tag (e.g., #FF5733)

description
​string

Optional description of the tag's purpose

createInventoryTagRuleDto

tagId
​string · uuid

Tag to assign when rule matches

name
​string

Rule name (must be unique within company)

description
​string

Optional description of the rule's purpose

ruleJson
​string

JSON representation of the rule logic

isActive
​boolean

Whether the rule is active and should be evaluated

defenderResultDto

defenderResultId
​integer · int32
subject
​string
correlationId
​string · uuid
blobUri
​string
eTag
​string
scanFinishedTimeUtc
​string · date-time
scanResultType
​string
malwareNamesFound
​string
malwareSha256
​string
eventType
​string
dataVersion
​string
metadataVersion
​string
eventTime
​string · date-time
topic
​string
createdAt
​string · date-time
updatedAt
​string · date-time

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

detailedMillCertificationHeatDto

heatNumber
​string
diameter
​integer · int32
length
​integer · int32
carbonEquivalent
​number · double
createdAt
​string · date-time
updatedAt
​string · date-time
millCertificationHeatId
​string · uuid
companyId
​string · uuid
millCertificationPageId
​string · uuid

detailedMillCertificationPageDto

newFileName
​string
classificationModelResult
​string
extractionModel
​string
extractionModelResult
​string
createdAt
​string · date-time
updatedAt
​string · date-time
millCertificationStatusLabel
​string
millCertificationStatusNotes
​string
millCertificationStatusType
​string
millCertificationPageId
​string · uuid
companyId
​string · uuid
millCertificationId
​string · uuid
blobUri
​string
originalFileName
​string
status
​integer · int32

entitlementDto

featureId
​integer · int32
featureKey
​string
featureName
​string
description
​string
category
​string
requiresUnlock
​boolean
displayOrder
​integer · int32
isEnabled
​boolean
unlockedAt
​string · date-time
expiresAt
​string · date-time
notes
​string
hasAccess
​boolean

errorResponse

statusCode
​integer · int32

HTTP status code e.g. 404, 403, 500

message
​string

Human-readable error message explaining the failure

details
​string

Detailed error information

timestamp
​string · date-time

ISO 8601 timestamp when the error occurred (UTC)

traceId
​string

Correlation / trace identifier for diagnostics

extendedInventoryDto

typeLabel
​string

Resolved label for Type

materialLabel
​string

Resolved label for Material

supplierName
​string

Resolved name for Supplier (from Organisations)

stockLocationLabel
​string

Resolved label for Stock Location (from CompanyStockLocations)

quantity
​integer · int32

Number of pieces available

weight
​number · double

Total weight in kilograms

heatCode
​string

Heat code for traceability

diameter
​integer · int32

Diameter in millimetres

length
​integer · int32

Length dimension (mm)

width
​integer · int32

Width dimension (mm)

depth
​integer · int32

Depth dimension (mm)

type
​integer · int32

Type reference (FK to InventoryTypes)

material
​integer · int32

Material reference (FK to InventoryMaterials)

supplierId
​string · uuid

Supplier reference (FK to Organisations)

stockLocationId
​integer · int32

Stock location reference (FK to CompanyStockLocations)

inventoryId
​string · uuid

Unique identifier for the inventory record

companyId
​string · uuid

Identifier of the owning company

productName
​string

Human readable product name

unitPrice
​number · double

Unit price in company currency

extendedScrapLogDto

loggedByName
​string

Display name of the user who logged this entry

scrapLogId
​string · uuid

Unique identifier for the scrap log entry

companyId
​string · uuid

Identifier of the owning company

logDate
​string · date-time

Date when the scrap was logged

binSkipReference
​string

Bin or skip reference identifier

startingWeight
​number · double

Starting weight in kilograms

closingWeight
​number · double

Closing weight in kilograms

netWeight
​number · double

Net weight (calculated as ClosingWeight - StartingWeight) in kilograms

loggedBy
​string · uuid

User ID of the person who logged this entry

createdAt
​string · date-time

Timestamp when the record was created (UTC)

updatedAt
​string · date-time

Timestamp when the record was last updated (UTC)

active
​boolean

Soft delete flag (true = active, false = deleted)

featureDto

featureId
​integer · int32
featureName
​string
featureKey
​string
description
​string
category
​string
requiresUnlock
​boolean
displayOrder
​integer · int32

grantEntitlementRequest

featureId
​integer · int32
expiresAt
​string · date-time
notes
​string

inventoryDto

quantity
​integer · int32

Number of pieces available

weight
​number · double

Total weight in kilograms

heatCode
​string

Heat code for traceability

diameter
​integer · int32

Diameter in millimetres

length
​integer · int32

Length dimension (mm)

width
​integer · int32

Width dimension (mm)

depth
​integer · int32

Depth dimension (mm)

type
​integer · int32

Type reference (FK to InventoryTypes)

material
​integer · int32

Material reference (FK to InventoryMaterials)

supplierId
​string · uuid

Supplier reference (FK to Organisations)

stockLocationId
​integer · int32

Stock location reference (FK to CompanyStockLocations)

inventoryId
​string · uuid

Unique identifier for the inventory record

companyId
​string · uuid

Identifier of the owning company

productName
​string

Human readable product name

unitPrice
​number · double

Unit price in company currency

inventoryMaterialDto

inventoryMaterialId
​integer · int32
category
​string
value
​string

inventoryTagAssignmentDto

assignmentId
​string · uuid

Unique identifier for the assignment

inventoryId
​string · uuid

Inventory item identifier

tagId
​string · uuid

Tag identifier

assignedByRuleId
​string · uuid

Rule that assigned this tag (null if manual)

assignedAt
​string · date-time

Timestamp when the tag was assigned (UTC)

inventoryTagAssignmentTagDto

inventoryId
​string · uuid

The inventory item identifier

tagId
​string · uuid

Unique identifier for the tag

companyId
​string · uuid

Identifier of the owning company

name
​string

Tag name

color
​string

Hex color code for the tag

description
​string

Optional description of the tag

inventoryTagDto

tagId
​string · uuid

Unique identifier for the tag

companyId
​string · uuid

Identifier of the owning company

name
​string

Tag name (must be unique within company)

color
​string

Hex color code for the tag (e.g., #FF5733)

description
​string

Optional description of the tag's purpose

inventoryTagEvaluationResultDto

inventoryId
​string · uuid
companyId
​string · uuid
assignedTagCount
​integer · int32

inventoryTagRuleDto

ruleId
​string · uuid

Unique identifier for the rule

companyId
​string · uuid

Identifier of the owning company

tagId
​string · uuid

Tag to assign when rule matches

name
​string

Rule name (must be unique within company)

description
​string

Optional description of the rule's purpose

ruleJson
​string

JSON representation of the rule logic

isActive
​boolean

Whether the rule is active and should be evaluated

inventoryTypeDto

inventoryTypeId
​integer · int32
category
​string
value
​string

linkedInventoryItemDto

inventoryId
​string · uuid
companyId
​string · uuid
productName
​string
quantity
​integer · int32
weight
​number · double
unitPrice
​number · double
heatCode
​string
diameter
​integer · int32
length
​integer · int32
width
​integer · int32
depth
​integer · int32
type
​integer · int32
material
​integer · int32
typeLabel
​string
materialLabel
​string
supplierId
​string · uuid
supplierName
​string
stockLocationId
​integer · int32
stockLocationLabel
​string
createdAt
​string · date-time
updatedAt
​string · date-time
orderLineItemId
​string · uuid

metaInventoryDto

createdAt
​string · date-time

Timestamp when the record was created (UTC)

updatedAt
​string · date-time

Timestamp when the record was last updated (UTC)

millCertificationId
​string · uuid

Mill certification ID if inventory is linked to a mill cert via heat code

linkedOrders
​string

JSON array string of linked orders in format '[{"orderId":"...","orderReference":"..."},...]'. '[]' when no orders are linked.

typeLabel
​string

Resolved label for Type

materialLabel
​string

Resolved label for Material

supplierName
​string

Resolved name for Supplier (from Organisations)

stockLocationLabel
​string

Resolved label for Stock Location (from CompanyStockLocations)

quantity
​integer · int32

Number of pieces available

weight
​number · double

Total weight in kilograms

heatCode
​string

Heat code for traceability

diameter
​integer · int32

Diameter in millimetres

length
​integer · int32

Length dimension (mm)

width
​integer · int32

Width dimension (mm)

depth
​integer · int32

Depth dimension (mm)

type
​integer · int32

Type reference (FK to InventoryTypes)

material
​integer · int32

Material reference (FK to InventoryMaterials)

supplierId
​string · uuid

Supplier reference (FK to Organisations)

stockLocationId
​integer · int32

Stock location reference (FK to CompanyStockLocations)

inventoryId
​string · uuid

Unique identifier for the inventory record

companyId
​string · uuid

Identifier of the owning company

productName
​string

Human readable product name

unitPrice
​number · double

Unit price in company currency

metaInventoryTagDto

createdAt
​string · date-time

Timestamp when the tag was created (UTC)

updatedAt
​string · date-time

Timestamp when the tag was last updated (UTC)

usageCount
​integer · int32

Number of inventory items currently assigned this tag

tagId
​string · uuid

Unique identifier for the tag

companyId
​string · uuid

Identifier of the owning company

name
​string

Tag name (must be unique within company)

color
​string

Hex color code for the tag (e.g., #FF5733)

description
​string

Optional description of the tag's purpose

metaInventoryTagRuleDto

createdAt
​string · date-time

Timestamp when the rule was created (UTC)

updatedAt
​string · date-time

Timestamp when the rule was last updated (UTC)

tagName
​string

Name of the linked tag

tagColor
​string

Color of the linked tag

ruleId
​string · uuid

Unique identifier for the rule

companyId
​string · uuid

Identifier of the owning company

tagId
​string · uuid

Tag to assign when rule matches

name
​string

Rule name (must be unique within company)

description
​string

Optional description of the rule's purpose

ruleJson
​string

JSON representation of the rule logic

isActive
​boolean

Whether the rule is active and should be evaluated

metaOrderDto

createdAt
​string · date-time
updatedAt
​string · date-time
orderReference
​string
quantity
​integer · int32
orderDate
​string · date-time
deliveryDate
​string · date-time
site
​string
status
​string
active
​boolean
relatedOrganisationId
​string · uuid
customerName
​string
​orderLineItemDto[]
orderId
​string · uuid
companyId
​string · uuid

metaOrganisationDto

createdAt
​string · date-time

Timestamp when the record was created (UTC)

updatedAt
​string · date-time

Timestamp when the record was last updated (UTC)

address
​string

Organisation address

contactInfo
​string

Contact information (email, phone, etc.)

taxId
​string

Tax identification number

roleIds
​integer[]

List of role IDs assigned to this organisation

roles
​string[]

List of role names assigned to this organisation

organisationId
​string · uuid

Unique identifier for the organisation

companyId
​string · uuid

Identifier of the owning company

name
​string

Organisation name

metaResultDto

dateCreated
​string · date-time
dateUpdated
​string · date-time
result
​string
resultComparison
​string
description
​string
resultId
​string · uuid
companyId
​string · uuid

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

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

millCertificationMechanicalPropertyDto

testNumber
​integer · int32
massPerMeter
​number · double
createdAt
​string · date-time
updatedAt
​string · date-time
millCertificationMechanicalPropertyId
​string · uuid
companyId
​string · uuid
millCertificationHeatId
​string · uuid

millCertificationStatusDto

millCertificationStatusId
​integer · int32
type
​string
label
​string
notes
​string

optimisationRequestTriggerWithResultDto

optimisationRequestTriggerId
​string · uuid
companyId
​string · uuid
status
​integer · int32
triggerCreatedAt
​string · date-time
triggerUpdatedAt
​string · date-time
resultId
​string · uuid
description
​string
resultCreatedAt
​string · date-time
resultUpdatedAt
​string · date-time
resultCount
​integer · int32

orderDetailsResponse

orderId
​string · uuid
companyId
​string · uuid
orderReference
​string
quantity
​integer · int32
orderDate
​string · date-time
deliveryDate
​string · date-time
site
​string
status
​string
active
​boolean
relatedOrganisationId
​string · uuid
customerName
​string
createdAt
​string · date-time
updatedAt
​string · date-time
​orderLineItemDto[]
​orderLineItemDto[]

orderDto

orderReference
​string
quantity
​integer · int32
orderDate
​string · date-time
deliveryDate
​string · date-time
site
​string
status
​string
active
​boolean
relatedOrganisationId
​string · uuid
customerName
​string
​orderLineItemDto[]
orderId
​string · uuid
companyId
​string · uuid

orderLineItemDto

orderLineItemId
​string · uuid
orderId
​string · uuid
companyId
​string · uuid
orderLineItemReference
​string
shapeCode
​string
heatCode
​string
length
​integer · int32
diameter
​integer · int32
height
​integer · int32
width
​integer · int32
quantity
​integer · int32
price
​number · double
status
​string
attachmentUrl
​string
attachmentName
​string
active
​boolean
createdAt
​string · date-time
updatedAt
​string · date-time
​linkedInventoryItemDto[]

ordersEditHistoryDto

ordersEditHistoryId
​integer · int32
orderId
​string · uuid
orderLineItemId
​string · uuid
editor
​string · uuid
editorName
​string
fieldChanged
​string
oldValue
​string
newValue
​string
editedAt
​string · date-time

organisationCreateUpdateDto

name
​string

Organisation name

address
​string

Organisation address

contactInfo
​string

Contact information (email, phone, etc.)

taxId
​string

Tax identification number

roleIds
​integer[]

List of role IDs to assign to this organisation

organisationDeleteResponse

deletedCount
​integer · int32

Number of organisations deleted

deletedIds
​string[]

List of organisation IDs that were deleted

organisationDto

address
​string

Organisation address

contactInfo
​string

Contact information (email, phone, etc.)

taxId
​string

Tax identification number

roleIds
​integer[]

List of role IDs assigned to this organisation

roles
​string[]

List of role names assigned to this organisation

organisationId
​string · uuid

Unique identifier for the organisation

companyId
​string · uuid

Identifier of the owning company

name
​string

Organisation name

organisationRoleDto

organisationRoleId
​integer · int32

Unique identifier for the role

value
​string

Role name

reserveInventoryResultDto

linkedInventoryId
​string · uuid
originalInventoryId
​string · uuid
wasSplit
​boolean
orderLineItemId
​string · uuid

scrapLogCreateRequest

logDate
​string · date-time
binSkipReference
​string
startingWeight
​number · double
closingWeight
​number · double
loggedBy
​string · uuid

scrapLogDeleteResponse

deletedItems
​string[]

List of deleted scrap log entry IDs

scrapLogDto

scrapLogId
​string · uuid

Unique identifier for the scrap log entry

companyId
​string · uuid

Identifier of the owning company

logDate
​string · date-time

Date when the scrap was logged

binSkipReference
​string

Bin or skip reference identifier

startingWeight
​number · double

Starting weight in kilograms

closingWeight
​number · double

Closing weight in kilograms

netWeight
​number · double

Net weight (calculated as ClosingWeight - StartingWeight) in kilograms

loggedBy
​string · uuid

User ID of the person who logged this entry

createdAt
​string · date-time

Timestamp when the record was created (UTC)

updatedAt
​string · date-time

Timestamp when the record was last updated (UTC)

active
​boolean

Soft delete flag (true = active, false = deleted)

scrapLogEditHistoryDto

scrapLogEditHistoryId
​integer · int32

Unique identifier for the edit history entry

scrapLogId
​string · uuid

The scrap log entry that was edited

editor
​string · uuid

User ID of the editor

editorName
​string

Display name of the editor

fieldChanged
​string

Name of the field that was changed

oldValue
​string

Previous value before the edit

newValue
​string

New value after the edit

editedAt
​string · date-time

Timestamp when the edit occurred (UTC)

scrapLogUpdateRequest

scrapLogId
​string · uuid
logDate
​string · date-time
binSkipReference
​string
startingWeight
​number · double
closingWeight
​number · double

stockLocationDto

stockLocationId
​integer · int32
category
​string
value
​string

unreserveInventoryResultDto

linkId
​string · uuid
companyId
​string · uuid
orderLineItemId
​string · uuid
inventoryId
​string · uuid

userSyncResponse

userId
​string · uuid
firstName
​string
lastName
​string
tutorialMode
​boolean
isSynced
​boolean

activeInventoryMillCertLinkDto

inventoryMillCertificationHeatLinkId
​string · uuid
companyId
​string · uuid
inventoryId
​string · uuid
millCertificationHeatId
​string · uuid
matchKeyType
​string
matchedValue
​string
source
​string
createdAt
​string · date-time

addTopUpRequest

packId
​integer · int32

Top-up pack ID (1=500cr 2=1500cr 3=5000cr 4=15000cr)

addTopUpResponse

balanceAfter
​integer · int32

Total available credits after the top-up is applied

creditsAdded
​integer · int32

Number of credits added by the top-up pack

approveProductionPlanResult

planId
​string · uuid
planStatus
​integer · int32
barsApproved
​integer · int32
barsConflict
​integer · int32

assignPlanRequest

planId
​integer · int32

Plan ID to assign

notes
​string

Optional admin note recorded with the assignment

auditEventDto

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

auditFieldChange

field
​string
oldValue
​string
newValue
​string

billingPortalSessionResponse

portalUrl
​string

Stripe Billing Portal Session URL to redirect the customer to

changeCommitmentRequest

commitmentType
​string

Desired ongoing commitment type: 'monthly' or 'annual'

changeTierPlanRequest

planId
​integer · int32

Target plan ID

forceCancelPending
​boolean

Set to true to cancel a pending downgrade and proceed with this assignment

chartFilterDto

field
​string
op
​string
value
​object

chartMeasureDto

field
​string
agg
​string

chartSortDto

field
​string
direction
​string

chartSpecDto

pageContext
​string
title
​string
chartType
​string
datasets
​string[]
joinField
​string
groupBy
​string[]
​chartMeasureDto
limit
​integer · int32

checkoutSessionResponse

checkoutUrl
​string

Stripe Checkout Session URL to redirect the customer to

companyCertificateSettingsDto

companyId
​string · uuid
logoStorageFileName
​string
stampStorageFileName
​string
stampText
​string
certificateContactName
​string
certificateContactEmail
​string
certificateContactPhone
​string
certificateFooterText
​string
companyRegistrationNumber
​string
createdAt
​string · date-time
updatedAt
​string · date-time

companyEmailDomainDto

companyEmailDomainId
​string · uuid
companyId
​string · uuid
emailDomain
​string
active
​boolean
lastModifiedBy
​string · uuid
updatedAt
​string · date-time

companyOrderStatusDto

companyOrderStatusId
​integer · int32
companyId
​string · uuid
orderStatusId
​integer · int32
category
​string
value
​string
active
​boolean
lastModifiedBy
​string · uuid
updatedAt
​string · date-time

companySettingsDto

companyId
​string · uuid
kerfMm
​number · double

Saw-blade width lost per cut, in mm (0 to 20, at most 2 decimal places).

companySubscriptionDto

planId
​integer · int32

Plan ID

planName
​string

Plan display name

planKey
​string

Plan key

planMonthlyCredits
​integer · int32

Monthly credits in plan

monthlyCreditsRemaining
​integer · int32

Monthly credits remaining this period

topUpCreditsRemaining
​integer · int32

Top-up credits remaining (never expire)

totalCredits
​integer · int32

Total available credits

hardStopEnabled
​boolean

Block uploads when credits reach zero

softAlertThreshold
​integer · int32

Warn when credits fall below this threshold; null = no alert

nextMonthlyResetAt
​string · date-time

Next monthly credit reset UTC

cancelledAt
​string · date-time

When the subscription was cancelled UTC; null if active

cancelAtPeriodEnd
​boolean

True when a cancellation is scheduled (Stripe cancel_at_period_end) but hasn't taken effect yet — still fully active/entitled until CancelEffectiveAt

cancelEffectiveAt
​string · date-time

When a scheduled cancellation takes effect UTC; null if none scheduled

commitmentType
​string

monthly or annual

commitmentPeriodStart
​string · date-time

Start of current annual commitment period; null if monthly

commitmentPeriodEnd
​string · date-time

End of current annual commitment period (CommitmentPeriodStart + 12 months); null if monthly

pendingCommitmentType
​string

Commitment type pending at the current commitment period's end (only ever 'monthly'); null if none pending

pendingPlanId
​integer · int32

Plan to apply at next rollover; null if none pending

pendingPlanName
​string

Display name of pending plan

pendingPlanEffectiveAt
​string · date-time

When the pending plan takes effect UTC

changeType
​string

Result of the last tier or commitment change: upgrade | downgrade_scheduled | lateral | commitment_upgrade | commitment_downgrade_scheduled | pending_cancelled | no_change

stripeCustomerId
​string

Stripe customer ID, set once the company has completed at least one subscription checkout; null if never subscribed via Stripe

isTrial
​boolean

True when this subscription is the 7-day no-card signup trial

trialEndsAt
​string · date-time

When the trial ends UTC (AssignedAt + 7 days); null unless IsTrial

subscriptionStatus
​string

Mirror of the Stripe subscription status: active | trialing | past_due | unpaid | paused | incomplete | incomplete_expired | canceled. past_due, unpaid and incomplete are the dunning states (payment failed, entitlement continues until DunningGraceEndsAt); incomplete_expired and canceled are terminal.

pastDueSince
​string · date-time

When the subscription first entered a dunning status UTC; null when in good standing

dunningGraceEndsAt
​string · date-time

When the dunning grace window ends and entitlement lapses UTC (PastDueSince + BillingSettings.DunningGraceDays); null unless in a dunning status with a PastDueSince anchor

consumeRequestBody

quantityUsed
​integer · int32
weightUsed
​number · double

consumeResultDto

inventoryId
​string · uuid
newQuantity
​integer · int32
newWeight
​number · double
newStatus
​integer · int32

countryDto

countryId
​integer · int32

Unique identifier for the country

iso2Code
​string

ISO-3166 alpha-2 country code (e.g. GB, US)

iso3Code
​string

ISO-3166 alpha-3 country code (e.g. GBR, USA)

name
​string

Country name

createBillingPortalSessionRequest

returnOrigin
​string

The frontend's own window.location.origin, used to build the post-portal-session return URL. Validated against a known-origins allow-list; falls back to the production URL if missing or untrusted.

createCheckoutRequest

planId
​integer · int32

Plan ID to subscribe to

commitmentType
​string

monthly or annual

returnOrigin
​string

The frontend's own window.location.origin, used to build the post-checkout redirect URL. Validated against a known-origins allow-list; falls back to the production URL if missing or untrusted.

createCompanyEmailDomainRequest

emailDomain
​string

createMillCertTagDto

name
​string

Tag name (must be unique within company)

color
​string

Hex color code for the tag

description
​string

Optional description

severity
​string

Severity: null, 'Block', 'Flag', or 'Audit'. Not exclusive to system tags.

createMillCertTagRuleDto

tagId
​string · uuid

Tag to assign when rule matches

name
​string

Rule name (must be unique within company)

description
​string

Optional description

ruleJson
​string

JSON representation of the rule logic

isActive
​boolean

Whether the rule is active and should be evaluated

createOptimisationFilterProfileRequest

name
​string
​priorityWeights
​optimisationSettings

createOptimisationRunRequest

name
​string
filterProfileId
​string · uuid
​optimisationSettings
excludedGroupKeys
​string[]
previewId
​string · uuid

createOptimisationRunResponse

runId
​string · uuid
groupCount
​integer · int32
unmatchedDemandCount
​integer · int32
excludedGroupCount
​integer · int32

createOrderLineItemTagDto

name
​string

Tag name (must be unique within company)

color
​string

Hex color code for the tag

description
​string

Optional description

createOrderLineItemTagRuleDto

tagId
​string · uuid

Tag to assign when rule matches

name
​string

Rule name (must be unique within company)

description
​string

Optional description

ruleJson
​string

JSON representation of the rule logic

isActive
​boolean

Whether the rule is active and should be evaluated

createOrderTagDto

name
​string

Tag name (must be unique within company)

color
​string

Hex color code for the tag

description
​string

Optional description

severity
​string

Severity: null, 'Block', 'Flag', or 'Audit'. Not exclusive to system tags.

createOrderTagRuleDto

tagId
​string · uuid

Tag to assign when rule matches

name
​string

Rule name (must be unique within company)

description
​string

Optional description

ruleJson
​string

JSON representation of the rule logic

isActive
​boolean

Whether the rule is active and should be evaluated

createTopUpCheckoutRequest

packId
​integer · int32

Top-up pack ID

returnOrigin
​string

The frontend's own window.location.origin, used to build the post-checkout redirect URL. Validated against a known-origins allow-list; falls back to the production URL if missing or untrusted.

creditLedgerEntryDto

ledgerId
​integer · int64

Ledger row ID

transactionType
​string

monthly_grant | topup | consumed | monthly_expired | tier_upgrade_adjustment

credits
​integer · int32

Credits changed (positive = added, negative = consumed/expired)

balanceAfter
​integer · int32

Total balance after this transaction

referenceId
​string

Mill certification ID for consumed rows

createdAt
​string · date-time

When the transaction occurred UTC

creditTopUpPackDto

packId
​integer · int32

Top-up pack ID (1=500cr 2=1500cr 3=5000cr 4=15000cr)

credits
​integer · int32

Credits granted by this pack

priceGbp
​number · double

Price in GBP

customerTrendDto

relatedOrganisationId
​string · uuid
customerName
​string
currentPeriodValue
​number · double
currentPeriodOrderCount
​integer · int32
priorPeriodValue
​number · double
priorPeriodOrderCount
​integer · int32
percentChange
​number · double

cutRequestBody

shapeFamily
​string
lengthRemoved
​number · double
widthRemoved
​number · double

cutResultDto

originalInventoryId
​string · uuid
remainderInventoryId
​string · uuid
newInventoryId
​string · uuid
autoSplitPerformed
​boolean

deleteResponse

deletedCount
​integer · int32

Number of items deleted

deletedIds
​string[]

List of IDs that were deleted

geocodeCandidateDto

formattedAddress
​string

Full formatted address as returned by Azure Maps

addressLine1
​string

Address line 1 (street number + street name)

city
​string

City / municipality

region
​string

Region/state/county

postalCode
​string

Postal/ZIP code

countryIso2
​string

ISO-3166 alpha-2 country code

latitude
​number · double

Latitude of the matched location

longitude
​number · double

Longitude of the matched location

confidence
​number · double

Azure Maps match confidence score (0-1, higher is better)

groupAttributes

productType
​string
material
​string
diameterMm
​number · double
wallThicknessMm
​number · double
widthMm
​number · double
depthMm
​number · double
sectionDesignation
​string
nominalSize
​string
grade
​string

gs1Element

ai
​string
value
​string

gs1SettingsDto

companyId
​string · uuid
gs1CompanyPrefix
​string
identifierNamespace
​string

heatPageNumbersDto

millCertificationHeatId
​string · uuid
pageNumbers
​integer[]

industrySectorDto

industrySectorId
​integer · int32

Unique identifier for the industry sector

name
​string

Industry sector name

inventoryDeleteResponse

alreadyDeletedIds
​string[]

Subset of DeletedIds that were already deleted before this request (no change was made to them)

deletedCount
​integer · int32

Number of items deleted

deletedIds
​string[]

List of IDs that were deleted

inventoryFilter

typeIds
​integer[]
materialIds
​integer[]
stockLocationIds
​integer[]
supplierIds
​string[]
minDiameterMm
​number · double
maxDiameterMm
​number · double

inventoryMillCertAggregates

Aggregated mill certificate chemical and mechanical properties across all linked heats. Null when inventory has no heat codes or no linked mill certs.
carbonEquivalentMin
​number · double
carbonEquivalentMax
​number · double
carbonEquivalentAvg
​number · double
carbonMin
​number · double
carbonMax
​number · double
carbonAvg
​number · double
manganeseMin
​number · double
manganeseMax
​number · double
manganeseAvg
​number · double
siliconMin
​number · double
siliconMax
​number · double
siliconAvg
​number · double
phosphorusMin
​number · double
phosphorusMax
​number · double
phosphorusAvg
​number · double
sulphurMin
​number · double
sulphurMax
​number · double
sulphurAvg
​number · double
chromiumMin
​number · double
chromiumMax
​number · double
chromiumAvg
​number · double
nickelMin
​number · double
nickelMax
​number · double
nickelAvg
​number · double
copperMin
​number · double
copperMax
​number · double
copperAvg
​number · double
molybdenumMin
​number · double
molybdenumMax
​number · double
molybdenumAvg
​number · double
vanadiumMin
​number · double
vanadiumMax
​number · double
vanadiumAvg
​number · double
nitrogenMin
​number · double
nitrogenMax
​number · double
nitrogenAvg
​number · double
boronMin
​number · double
boronMax
​number · double
boronAvg
​number · double
titaniumMin
​number · double
titaniumMax
​number · double
titaniumAvg
​number · double
relativeRibAreaMin
​number · double
relativeRibAreaMax
​number · double
relativeRibAreaAvg
​number · double
massPerMeterMin
​number · double
massPerMeterMax
​number · double
massPerMeterAvg
​number · double
yieldStrengthMin
​number · double
yieldStrengthMax
​number · double
yieldStrengthAvg
​number · double
tensileStrengthMin
​number · double
tensileStrengthMax
​number · double
tensileStrengthAvg
​number · double
rmReRatioMin
​number · double
rmReRatioMax
​number · double
rmReRatioAvg
​number · double
elongationA5Min
​number · double
elongationA5Max
​number · double
elongationA5Avg
​number · double
elongationAgtMin
​number · double
elongationAgtMax
​number · double
elongationAgtAvg
​number · double
hardnessValueMin
​number · double
hardnessValueMax
​number · double
hardnessValueAvg
​number · double
numberOfBundlesMin
​number · double
numberOfBundlesMax
​number · double
numberOfBundlesAvg
​number · double

inventoryStatusDto

inventoryStatusId
​integer · int32
label
​string

issuePhysicalIdentifierRequest

identifierType
​string
gtin
​string
reissue
​boolean

issuePhysicalIdentifierResponse

created
​boolean
supersededPhysicalIdentifierId
​string · uuid
warnings
​string[]

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

materialProposalRow

referenceMaterialId
​integer · int32
category
​string
value
​string
shapeFamily
​string
isCustom
​boolean
confidence
​number · double
sourceExcerpt
​string
issue
​string

metalGradeDto

metalGradeId
​integer · int32

Unique identifier for the metal grade

metalStandardId
​integer · int32

The standard this grade is defined under

metalStandardCode
​string

Standard code this grade belongs to (e.g. ASTM_A615)

code
​string

Grade code (e.g. B500B, Grade 60, 316L, 6061-T6)

name
​string

Grade display name

compositionNotes
​string

Composition/property notes

metalStandardDto

metalStandardId
​integer · int32

Unique identifier for the metal standard

standardsBodyId
​integer · int32

Publishing standards body identifier (see StandardsBodies)

standardsBodyCode
​string

Publishing standards body code (e.g. ASTM, BSI, CEN)

materialFamilyId
​integer · int32

Material family identifier this standard belongs to

materialFamilyName
​string

Material family name (e.g. Rebar, Titanium, Non-Ferrous Metals)

regionId
​integer · int32

Region identifier this standard belongs to (see Regions)

regionCode
​string

Region code (e.g. EU_UK, USA, IN, GLOBAL)

regionName
​string

Region display name (e.g. Europe/UK, USA, India, Global)

usesExecutionClass
​boolean

True if this standard carries the EN 1090-2/EN 1990 Execution Class (EXC1-EXC4) and Consequence Class (CC1-CC3) scheme

code
​string

Standard code (e.g. ASTM_A615, BS4449)

name
​string

Standard display name (e.g. ASTM A615, BS 4449:2005+A3:2016)

scope
​string

Brief plain-English scope summary

version
​string

Standard version/revision

metaMillCertTagDto

usageCount
​integer · int32

Number of mill certs currently assigned this tag

createdAt
​string · date-time
updatedAt
​string · date-time
tagId
​string · uuid

Unique identifier for the tag

companyId
​string · uuid

Identifier of the owning company

name
​string

Tag name (must be unique within company)

color
​string

Hex color code for the tag

description
​string

Optional description

active
​boolean

Whether the tag is active (false = soft-deleted)

lastModifiedBy
​string · uuid

ID of the user who last modified this tag

isSystemTag
​boolean

True for tags provisioned by a subscribed Rule Pack — read-only, managed via subscribe/unsubscribe

severity
​string

Rule Pack severity (Block/Flag/Audit) this tag represents; null for company-authored tags

metaMillCertTagRuleDto

createdAt
​string · date-time

Timestamp when the rule was created (UTC)

updatedAt
​string · date-time

Timestamp when the rule was last updated (UTC)

tagName
​string

Name of the linked tag

tagColor
​string

Color of the linked tag

ruleId
​string · uuid

Unique identifier for the rule

companyId
​string · uuid

Identifier of the owning company

tagId
​string · uuid

Tag to assign when rule matches

name
​string

Rule name (must be unique within company)

description
​string

Optional description

ruleJson
​string

JSON representation of the rule logic

isActive
​boolean

Whether the rule is active and should be evaluated

active
​boolean

Whether the rule exists (false = soft-deleted)

lastModifiedBy
​string · uuid

ID of the user who last modified this rule

isSystemRule
​boolean

True for rules provisioned by a subscribed Rule Pack — read-only (cannot be edited), but can be deleted

metaOrderLineItemTagDto

usageCount
​integer · int32

Number of line items currently assigned this tag

createdAt
​string · date-time
updatedAt
​string · date-time
tagId
​string · uuid

Unique identifier for the tag

companyId
​string · uuid

Identifier of the owning company

name
​string

Tag name (must be unique within company)

color
​string

Hex color code for the tag

description
​string

Optional description

active
​boolean

Whether the tag is active (false = soft-deleted)

lastModifiedBy
​string · uuid

ID of the user who last modified this tag

isSystemTag
​boolean

True for tags provisioned by a subscribed Rule Pack — read-only, managed via subscribe/unsubscribe

severity
​string

Rule Pack severity (Block/Flag/Audit) this tag represents; null for company-authored tags

metaOrderLineItemTagRuleDto

createdAt
​string · date-time

Timestamp when the rule was created (UTC)

updatedAt
​string · date-time

Timestamp when the rule was last updated (UTC)

tagName
​string

Name of the linked tag

tagColor
​string

Color of the linked tag

ruleId
​string · uuid

Unique identifier for the rule

companyId
​string · uuid

Identifier of the owning company

tagId
​string · uuid

Tag to assign when rule matches

name
​string

Rule name (must be unique within company)

description
​string

Optional description

ruleJson
​string

JSON representation of the rule logic

isActive
​boolean

Whether the rule is active and should be evaluated

active
​boolean

Whether the rule exists (false = soft-deleted)

lastModifiedBy
​string · uuid

ID of the user who last modified this rule

isSystemRule
​boolean

True for rules provisioned by a subscribed Rule Pack — read-only (cannot be edited), but can be deleted

metaOrderTagDto

usageCount
​integer · int32

Number of orders currently assigned this tag

createdAt
​string · date-time
updatedAt
​string · date-time
tagId
​string · uuid

Unique identifier for the tag

companyId
​string · uuid

Identifier of the owning company

name
​string

Tag name (must be unique within company)

color
​string

Hex color code for the tag

description
​string

Optional description

active
​boolean

Whether the tag is active (false = soft-deleted)

lastModifiedBy
​string · uuid

ID of the user who last modified this tag

isSystemTag
​boolean

True for tags provisioned by a subscribed Rule Pack — read-only, managed via subscribe/unsubscribe

severity
​string

Rule Pack severity (Block/Flag/Audit) this tag represents; null for company-authored tags

metaOrderTagRuleDto

createdAt
​string · date-time

Timestamp when the rule was created (UTC)

updatedAt
​string · date-time

Timestamp when the rule was last updated (UTC)

tagName
​string

Name of the linked tag

tagColor
​string

Color of the linked tag

ruleId
​string · uuid

Unique identifier for the rule

companyId
​string · uuid

Identifier of the owning company

tagId
​string · uuid

Tag to assign when rule matches

name
​string

Rule name (must be unique within company)

description
​string

Optional description

ruleJson
​string

JSON representation of the rule logic

isActive
​boolean

Whether the rule is active and should be evaluated

active
​boolean

Whether the rule exists (false = soft-deleted)

lastModifiedBy
​string · uuid

ID of the user who last modified this rule

isSystemRule
​boolean

True for rules provisioned by a subscribed Rule Pack — read-only (cannot be edited), but can be deleted

millCertificationDocumentFieldUpdateDto

millCertificationId
​string · uuid
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
lastModifiedBy
​string · uuid
dateModified
​string · date-time

millCertificationHeatUpdateDto

millCertificationHeatId
​string · uuid
companyId
​string · uuid
millCertificationPageId
​string · uuid
heatNumber
​string
productReference
​string
productForm
​string
quality
​string
grade
​string
countryOfMeltAndPour
​string
diameter
​number · double
length
​number · double
wallThickness
​number · double
carbonEquivalent
​number · double
carbon
​number · double
manganese
​number · double
silicon
​number · double
phosphorus
​number · double
sulphur
​number · double
chromium
​number · double
nickel
​number · double
copper
​number · double
molybdenum
​number · double
vanadium
​number · double
nitrogen
​number · double
boron
​number · double
aluminium
​number · double
niobium
​number · double
titanium
​number · double
arsenic
​number · double
calcium
​number · double
tin
​number · double
lead
​number · double
antimony
​number · double
bismuth
​number · double
width
​number · double
relativeRibArea
​number · double
modifiedBy
​string · uuid
lastModifiedBy
​string · uuid
active
​boolean

millCertificationMechanicalPropertyUpdateDto

millCertificationMechanicalPropertyId
​string · uuid
companyId
​string · uuid
millCertificationHeatId
​string · uuid
testNumber
​integer · int32
testReference
​string
massPerMeter
​number · double
yieldStrength
​number · double
tensileStrength
​number · double
rmReRatio
​number · double
elongationA5
​number · double
elongationAgt
​number · double
bendTest
​string
rebendTest
​string
impactEnergyJ
​number · double
impactTemperatureDegC
​number · double
hardnessValue
​number · double
hardnessScale
​string
productionNumber
​string
quantity
​integer · int32
numberOfBundles
​integer · int32
modifiedBy
​string · uuid
lastModifiedBy
​string · uuid
active
​boolean

millCertificationPageUpdateDto

millCertificationPageId
​string · uuid
companyId
​string · uuid
pageNumber
​integer · int32

millCertMatchCandidateDto

matchKeyType
​string
matchedValue
​string
millCertificationHeatId
​string · uuid
heatNumber
​string
productReference
​string
heatProductForm
​string
heatQuality
​string
heatGrade
​string
heatCountryOfMeltAndPour
​string
diameter
​number · double
length
​number · double
carbonEquivalent
​number · double
carbon
​number · double
manganese
​number · double
silicon
​number · double
phosphorus
​number · double
sulphur
​number · double
chromium
​number · double
nickel
​number · double
copper
​number · double
molybdenum
​number · double
vanadium
​number · double
nitrogen
​number · double
boron
​number · double
aluminium
​number · double
niobium
​number · double
titanium
​number · double
width
​number · double
relativeRibArea
​number · double
millCertificationId
​string · uuid
certificateDate
​string · date-time
supplierName
​string
linkSource
​string
isActiveLink
​boolean

millCertMatchCountDto

inventoryId
​string · uuid
matchKeyType
​string
matchedValue
​string
matchCount
​integer · int32

millCertMatchGroupDto

matchKeyType
​string
matchedValue
​string
activeMillCertificationHeatId
​string · uuid
activeSource
​string

millCertMatchResultsDto

inventoryId
​string · uuid

millCertPageUrlDto

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

millCertSupplierDto

millCertSupplierId
​integer · int32
name
​string
website
​string
countryId
​integer · int32
countryName
​string
aliases
​string[]

millCertSupplierMillDto

millCertSupplierMillId
​integer · int32
name
​string
addressLine1
​string
addressLine2
​string
city
​string
region
​string
postalCode
​string
countryId
​integer · int32
countryName
​string
latitude
​number · double
longitude
​number · double
geocodeConfidence
​number · double
geocodedAt
​string · date-time

millCertTagAssignmentDto

assignmentId
​string · uuid

Unique identifier for the assignment

millCertificationId
​string · uuid

Mill certification identifier

tagId
​string · uuid

Tag identifier

assignedByRuleId
​string · uuid

Rule that assigned this tag (null if manual)

assignedAt
​string · date-time

Timestamp when the tag was assigned (UTC)

millCertTagAssignmentTagDto

millCertificationId
​string · uuid

The mill certification identifier

tagId
​string · uuid

Unique identifier for the tag

companyId
​string · uuid

Identifier of the owning company

name
​string

Tag name

color
​string

Hex color code for the tag

description
​string

Optional description of the tag

assignedByRuleId
​string · uuid

Rule that assigned this tag (null if manually assigned)

isSystemTag
​boolean

True for tags provisioned by a subscribed Rule Pack

severity
​string

Rule Pack severity (Block/Flag/Audit) this tag represents; null for company-authored tags

millCertTagDto

tagId
​string · uuid

Unique identifier for the tag

companyId
​string · uuid

Identifier of the owning company

name
​string

Tag name (must be unique within company)

color
​string

Hex color code for the tag

description
​string

Optional description

active
​boolean

Whether the tag is active (false = soft-deleted)

lastModifiedBy
​string · uuid

ID of the user who last modified this tag

isSystemTag
​boolean

True for tags provisioned by a subscribed Rule Pack — read-only, managed via subscribe/unsubscribe

severity
​string

Rule Pack severity (Block/Flag/Audit) this tag represents; null for company-authored tags

millCertTagRuleDto

ruleId
​string · uuid

Unique identifier for the rule

companyId
​string · uuid

Identifier of the owning company

tagId
​string · uuid

Tag to assign when rule matches

name
​string

Rule name (must be unique within company)

description
​string

Optional description

ruleJson
​string

JSON representation of the rule logic

isActive
​boolean

Whether the rule is active and should be evaluated

active
​boolean

Whether the rule exists (false = soft-deleted)

lastModifiedBy
​string · uuid

ID of the user who last modified this rule

isSystemRule
​boolean

True for rules provisioned by a subscribed Rule Pack — read-only (cannot be edited), but can be deleted

offcutThreshold

default
​number · double
​offcutThresholdOverride[]

offcutThresholdOverride

maxDiameterMm
​number · double
thresholdMm
​number · double

onboardingProgressDto

millCertUploaded
​boolean

True when the company has at least one active mill certificate.

inventoryCreated
​boolean

True when the company has at least one active inventory item.

orderWithLineItemCreated
​boolean

True when the company has an active order with at least one active line item.

stockReserved
​boolean

True when any inventory is linked (reserved) to an order line item.

certificatePackGenerated
​boolean

True when the company has generated at least one certificate pack.

hexUsed
​boolean

True when an onboarding (Hex) session has a completed step or a Completed/Dismissed status.

companyCreatedAt
​string · date-time

When the company was created (UTC).

firstPackAt
​string · date-time

When the company generated its first certificate pack (UTC); null until one exists.

timeToFirstPackSeconds
​integer · int64

Seconds from company creation to the first certificate pack (never negative); null until a pack exists.

onboardingProposalDto

onboardingProposalId
​integer · int32
onboardingSessionId
​integer · int32
companyId
​string · uuid
surface
​string
sourceType
​string
payloadJson
​string
modelDeployment
​string
promptVersion
​string
status
​string
sourceBlobUri
​string
originalFileName
​string
layoutTextBlobUri
​string
failureReason
​string
createdBy
​string · uuid
createdAt
​string · date-time
updatedAt
​string · date-time

onboardingSessionDto

onboardingSessionId
​integer · int32
companyId
​string · uuid
status
​string
stepsCompleted
​string
createdBy
​string · uuid
createdAt
​string · date-time
updatedAt
​string · date-time

onboardingSessionResponse

optimisationFilterProfileDto

profileId
​string · uuid
companyId
​string · uuid
name
​string
​priorityWeights
​optimisationSettings
createdBy
​string · uuid
lastModifiedBy
​string · uuid
createdAt
​string · date-time
updatedAt
​string · date-time

optimisationRunDto

runId
​string · uuid
companyId
​string · uuid
status
​integer · int32
filterProfileId
​string · uuid
problemBlobUri
​string
resultBlobUri
​string
errorMessage
​string
groupCount
​integer · int32
requestedBy
​string · uuid
planId
​string · uuid
runName
​string
createdAt
​string · date-time
updatedAt
​string · date-time

optimisationRunFilters

​inventoryFilter
​orderFilter

optimisationRunPreview

previewId
​string · uuid
composedAt
​string · date-time
totalGroups
​integer · int32
totalStockBarCount
​integer · int32
totalDemandPieceCount
​integer · int32
​previewExclusionSummary

optimisationRunPreviewGroup

groupKey
​string
​groupAttributes
stockLineCount
​integer · int32
stockBarCount
​integer · int32
stockLengthM
​number · double
demandLineCount
​integer · int32
demandPieceCount
​integer · int32
demandLengthM
​number · double
orderCount
​integer · int32
ungradedLineCount
​integer · int32

optimisationSettings

algorithm
​string
populationSize
​integer · int32
maxIterations
​integer · int32
timeLimitSeconds
​integer · int32
​offcutThreshold
kerfMm
​number · double
​priorityWeights
randomSeed
​integer · int32

orderFilter

statuses
​string[]
deliveryFrom
​string · date-time
deliveryTo
​string · date-time
orderReferences
​string[]
tagIds
​string[]

orderLineItemSpecificationDto

orderLineItemId
​string · uuid
companyId
​string · uuid
metalStandardId
​integer · int32
metalStandardCode
​string
metalStandardName
​string
metalGradeId
​integer · int32
metalGradeCode
​string
metalGradeName
​string
executionClass
​string
consequenceClass
​string
notes
​string
coatingCode
​string
bendTypeCode
​string
barSizeCode
​string
surfaceType
​string
carbonEquivalent
​number · double
bendRadius
​integer · int32
hookAngle
​integer · int32
legLength1
​integer · int32
legLength2
​integer · int32
toleranceClass
​string
surfaceFinish
​string
certificationType
​string
heatTreatment
​string
edgeCondition
​string
conductivityIACS
​number · double
nonFerrousSurfaceFinish
​string
countryOfOrigin
​string
createdAt
​string · date-time
updatedAt
​string · date-time

orderLineItemTagAssignmentTagDto

orderLineItemId
​string · uuid

The order line item identifier

tagId
​string · uuid

Unique identifier for the tag

companyId
​string · uuid

Identifier of the owning company

name
​string

Tag name

color
​string

Hex color code for the tag

description
​string

Optional description of the tag

assignedByRuleId
​string · uuid

Rule that assigned this tag (null if manually assigned)

isSystemTag
​boolean

True for tags provisioned by a subscribed Rule Pack

severity
​string

Rule Pack severity (Block/Flag/Audit) this tag represents; null for company-authored tags

orderLineItemTagDto

tagId
​string · uuid

Unique identifier for the tag

companyId
​string · uuid

Identifier of the owning company

name
​string

Tag name (must be unique within company)

color
​string

Hex color code for the tag

description
​string

Optional description

active
​boolean

Whether the tag is active (false = soft-deleted)

lastModifiedBy
​string · uuid

ID of the user who last modified this tag

isSystemTag
​boolean

True for tags provisioned by a subscribed Rule Pack — read-only, managed via subscribe/unsubscribe

severity
​string

Rule Pack severity (Block/Flag/Audit) this tag represents; null for company-authored tags

orderLineItemTagRequirementItemDto

orderLineItemId
​string · uuid

The order line item the requirement belongs to

tagId
​string · uuid

The inventory tag required or preferred of the supplying stock

requirement
​string

'Required' (hard constraint) or 'Preferred' (soft preference)

orderLineItemTagRuleDto

ruleId
​string · uuid

Unique identifier for the rule

companyId
​string · uuid

Identifier of the owning company

tagId
​string · uuid

Tag to assign when rule matches

name
​string

Rule name (must be unique within company)

description
​string

Optional description

ruleJson
​string

JSON representation of the rule logic

isActive
​boolean

Whether the rule is active and should be evaluated

active
​boolean

Whether the rule exists (false = soft-deleted)

lastModifiedBy
​string · uuid

ID of the user who last modified this rule

isSystemRule
​boolean

True for rules provisioned by a subscribed Rule Pack — read-only (cannot be edited), but can be deleted

orderTagAssignmentDto

assignmentId
​string · uuid

Unique identifier for the assignment

orderId
​string · uuid

Order identifier

tagId
​string · uuid

Tag identifier

assignedByRuleId
​string · uuid

Rule that assigned this tag (null if manual)

assignedAt
​string · date-time

Timestamp when the tag was assigned (UTC)

orderTagAssignmentTagDto

orderId
​string · uuid

The order identifier

tagId
​string · uuid

Unique identifier for the tag

companyId
​string · uuid

Identifier of the owning company

name
​string

Tag name

color
​string

Hex color code for the tag

description
​string

Optional description of the tag

assignedByRuleId
​string · uuid

Rule that assigned this tag (null if manually assigned)

isSystemTag
​boolean

True for tags provisioned by a subscribed Rule Pack

severity
​string

Rule Pack severity (Block/Flag/Audit) this tag represents; null for company-authored tags

orderTagDto

tagId
​string · uuid

Unique identifier for the tag

companyId
​string · uuid

Identifier of the owning company

name
​string

Tag name (must be unique within company)

color
​string

Hex color code for the tag

description
​string

Optional description

active
​boolean

Whether the tag is active (false = soft-deleted)

lastModifiedBy
​string · uuid

ID of the user who last modified this tag

isSystemTag
​boolean

True for tags provisioned by a subscribed Rule Pack — read-only, managed via subscribe/unsubscribe

severity
​string

Rule Pack severity (Block/Flag/Audit) this tag represents; null for company-authored tags

orderTagRuleDto

ruleId
​string · uuid

Unique identifier for the rule

companyId
​string · uuid

Identifier of the owning company

tagId
​string · uuid

Tag to assign when rule matches

name
​string

Rule name (must be unique within company)

description
​string

Optional description

ruleJson
​string

JSON representation of the rule logic

isActive
​boolean

Whether the rule is active and should be evaluated

active
​boolean

Whether the rule exists (false = soft-deleted)

lastModifiedBy
​string · uuid

ID of the user who last modified this rule

isSystemRule
​boolean

True for rules provisioned by a subscribed Rule Pack — read-only (cannot be edited), but can be deleted

organisationInsightsSummaryDto

relatedOrganisationId
​string · uuid
customerName
​string
​productMixItemDto[]

organisationMatchCandidateDto

organisationId
​string · uuid
name
​string
score
​integer · int32

organisationMatchResultsDto

​millCertSupplierDto
​millCertSupplierDto

pendingConflictResponse

message
​string

Human-readable conflict message

pendingPlanName
​string

Name of the pending plan

pendingPlanEffectiveAt
​string · date-time

When the pending plan takes effect UTC

physicalIdentifierDto

physicalIdentifierId
​string · uuid
companyId
​string · uuid
inventoryId
​string · uuid
identifierType
​string
identifierNamespace
​string
gtin
​string
identifierValue
​string
batchLot
​string
payload
​string
​gs1Element[]
issuedAt
​string · date-time
supersededAt
​string · date-time
reissuedFromPhysicalIdentifierId
​string · uuid
active
​boolean
lastModifiedBy
​string · uuid
inventoryActive
​boolean
isCurrent
​boolean

previewExclusionSummary

total
​integer · int32
​object

previewGroupLineItem

orderLineItemId
​string · uuid
lengthMm
​number · double
quantity
​integer · int32
totalLengthM
​number · double
gradeAllocation
​string
gradeAllocationRank
​integer · int32

previewGroupOrder

orderId
​string · uuid
orderReference
​string
customerName
​string
customerPurchaseOrderReference
​string
deliveryDate
​string · date-time
priority
​integer · int32
status
​string

priorityWeights

orderUrgency
​string
stockConsumption
​string
wasteVsSimplicity
​number · double
certQuality
​number · double
tagPreference
​number · double
ungradedDemandAllocation
​string

productionPlanBarDto

planBarId
​string · uuid
planId
​string · uuid
companyId
​string · uuid
inventoryId
​string · uuid
barIndex
​integer · int32
groupKey
​string
barLengthMm
​number · double
attributesJson
​string
isPinned
​boolean
pinnedLinkId
​string · uuid
reservedInventoryId
​string · uuid
status
​integer · int32
offcutMm
​number · double
scrapMm
​number · double
startedBy
​string · uuid
startedAt
​string · date-time
completedBy
​string · uuid
completedAt
​string · date-time
startedByName
​string
completedByName
​string
productName
​string
stockLocation
​string
supplier
​string

productionPlanConflictDto

conflictId
​string · uuid
planBarId
​string · uuid
cutId
​string · uuid
conflictType
​string
details
​string
detectedAt
​string · date-time

productionPlanCutDto

cutId
​string · uuid
planBarId
​string · uuid
companyId
​string · uuid
orderLineItemId
​string · uuid
orderId
​string · uuid
cutLengthMm
​number · double
quantity
​integer · int32
reviewStatus
​integer · int32
linkId
​string · uuid
orderReference
​string
orderLineItemReference
​string

productionPlanDetailsResponse

productionPlanDto

planId
​string · uuid
companyId
​string · uuid
runId
​string · uuid
name
​string
status
​integer · int32
totalBars
​integer · int32
totalCuts
​integer · int32
totalWastePct
​number · double
totalOffcutMm
​number · double
approvedBy
​string · uuid
approvedByName
​string
approvedAt
​string · date-time
createdAt
​string · date-time
updatedAt
​string · date-time

productMixItemDto

relatedOrganisationId
​string · uuid
customerName
​string
materialId
​integer · int32
materialName
​string
typeId
​integer · int32
typeName
​string
metalGradeId
​integer · int32
gradeName
​string
totalQuantity
​integer · int32
totalValue
​number · double
orderCount
​integer · int32

proposeChartSpecRequest

prompt
​string

proposeChartSpecResponse

​chartSpecDto
promptVersion
​string
modelDeployment
​string

proposeOnboardingRequest

surface
​string
sourceType
​string
input
​string
onboardingSessionId
​integer · int32

proposeOnboardingResponse

onboardingProposalId
​integer · int32
truncated
​boolean
promptVersion
​string

putMillCertLinkRequest

matchKeyType
​string
matchedValue
​string
millCertificationHeatId
​string · uuid

reconcileCheckoutSessionRequest

sessionId
​string

Stripe Checkout Session ID (the {CHECKOUT_SESSION_ID} query param Stripe appends to the success_url)

regionDto

regionId
​integer · int32

Unique identifier for the region

code
​string

Region code (e.g. EU_UK, USA, IN, GLOBAL)

name
​string

Region display name (e.g. Europe/UK, USA, India, Global)

releaseProductionPlanResult

planId
​string · uuid
planStatus
​integer · int32
releasedLinkCount
​integer · int32

reuseOnboardingDocumentRequest

sourceProposalId
​integer · int32

reviewCutRequest

cutId
​string · uuid
reviewStatus
​integer · int32

reviewCutsResponse

updatedCount
​integer · int32

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)

reviewMillCertificationResponse

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

ruleFieldDefinition

name
​string
label
​string
valueType
​string
operators
​string[]

ruleFieldsResponse

rulePackDetailDto

Rules belonging to this pack

rulePackId
​string · uuid

Unique identifier for the rule pack

categoryName
​string

Category name (Rebar, Stainless Steel, Non-Ferrous Metals, Structural & Alloy Steel, Nickel Alloys)

name
​string

Rule pack name

description
​string

Rule pack description

isSubscribed
​boolean

Whether the requesting company is currently subscribed to this pack

objectTypes
​string

Semicolon-joined distinct object types this pack has rules for (Inventory;MillCert;Order)

standards
​string

Semicolon-joined standard codes this pack covers

grades
​string

Semicolon-joined grade codes this pack covers

rulePackDto

rulePackId
​string · uuid

Unique identifier for the rule pack

categoryName
​string

Category name (Rebar, Stainless Steel, Non-Ferrous Metals, Structural & Alloy Steel, Nickel Alloys)

name
​string

Rule pack name

description
​string

Rule pack description

isSubscribed
​boolean

Whether the requesting company is currently subscribed to this pack

objectTypes
​string

Semicolon-joined distinct object types this pack has rules for (Inventory;MillCert;Order)

standards
​string

Semicolon-joined standard codes this pack covers

grades
​string

Semicolon-joined grade codes this pack covers

rulePackRuleDto

rulePackRuleId
​string · uuid

Unique identifier for the rule

objectType
​string

Object type this rule evaluates (Inventory, MillCert, or Order)

name
​string

Technical rule name

description
​string

Human-readable description of what the rule checks

ruleJson
​string

JSON representation of the rule logic (Microsoft.RulesEngine format)

severity
​string

Severity: Block, Flag, or Audit

saveChartRequest

name
​string
​chartSpecDto
promptText
​string
modelDeployment
​string
promptVersion
​string

savedDashboardChartDto

savedDashboardChartId
​integer · int32
companyId
​string · uuid
pageContext
​string
createdBy
​string · uuid
name
​string
chartSpecJson
​string
promptText
​string
modelDeployment
​string
promptVersion
​string
createdAt
​string · date-time
updatedAt
​string · date-time

setManualTagsRequest

tagIds
​string[]

setTagRequirementsRequest

requiredTagIds
​string[]
preferredTagIds
​string[]

shapeFamilyDto

shapeFamily
​string
description
​string
supportsCut
​boolean
sortOrder
​integer · int32

slowMovingStockItemDto

inventoryId
​string · uuid
companyId
​string · uuid
productName
​string
productReference
​string
quantity
​integer · int32
weight
​number · double
unitPrice
​number · double
heatCode
​string
supplierId
​string · uuid
supplierName
​string
receivedAt
​string · date-time
daysSinceReceived
​integer · int32
lastOrderDate
​string · date-time
daysSinceLastMovement
​integer · int32

submitQualityReviewRequest

reviewStatus
​integer · int32
comment
​string
overriddenTagIds
​string[]

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

submitQualityReviewResponse

orderLineItemId
​string · uuid
inventoryId
​string · uuid
reviewStatus
​integer · int32
reviewStatusLabel
​string
reviewComment
​string
reviewedByName
​string
reviewedAt
​string · date-time
message
​string

subscriptionPlanDto

planId
​integer · int32

Plan ID (1=Starter 2=Workshop 3=Production 4=Scale)

planName
​string

Display name

planKey
​string

Programmatic key

monthlyCredits
​integer · int32

Monthly AI credits included

monthlyCostGbp
​number · double

Monthly cost in GBP; null = not yet set

annualCostGbp
​number · double

Annual cost in GBP; null = not yet set

sortOrder
​integer · int32

Display order

transferRequestBody

stockLocationId
​integer · int32

transferResultDto

inventoryId
​string · uuid
newStockLocationId
​integer · int32

updateCompanyCertificateSettingsRequest

stampText
​string
certificateContactName
​string
certificateContactEmail
​string
certificateContactPhone
​string
certificateFooterText
​string
companyRegistrationNumber
​string

updateCompanySettingsRequest

kerfMm
​number · double

Saw-blade width lost per cut, in mm. Required; 0 to 20 inclusive. Values with more than 2 decimal places are rounded to 2.

updateGs1SettingsRequest

gs1CompanyPrefix
​string

updateMillCertificationRequest

deletedHeatIds
​string[]
deletedMechanicalPropertyIds
​string[]

updateOnboardingProposalRequest

status
​string

updateOnboardingSessionRequest

status
​string
completedStep
​string

updateSubscriptionRequest

hardStopEnabled
​boolean

Block uploads at zero credits

softAlertThreshold
​integer · int32

Soft alert threshold; null disables

commitmentType
​string

monthly or annual; omit to leave unchanged