API fundamentals

Errors

Use the HTTP status as the primary outcome and inspect the response schema documented for the operation.

Status	Meaning
400	Request syntax, header, or validation failure.
401	Missing, expired, or invalid bearer token.
403	Authenticated caller lacks access, or the subscription is invalid for the operation.
404	Requested resource was not found or is not visible to the caller.
409	Request conflicts with current resource state or uniqueness rules.
415	Request body uses an unsupported media type.
422	Request is syntactically valid but cannot be processed under a business rule.
429	Rate limit exceeded; follow Retry-After.
500	Unexpected Loady processing failure.
503	Service is temporarily unavailable or under maintenance.

Validation responses can contain an errors array with a Loady error code, affected JSON paths, details, and a description. Codes beginning with V identify validation rules; codes beginning with A identify application or business rules. Not every code applies to every public operation. The operation's response contract and the returned HTTP status remain authoritative. Do not branch only on human-readable text.

Application codes

Code	Description
A1000	Payload is null
A1001	Model is incorrect
A1002	Not found
A1003	Element does not exist
A1004	Company does not exist
A1005	Site does not exist
A1008	Company is missing in header
A1010	The provided language is not supported
A1013	Module or submodule does not belong to a product type
A1014	Product does not exist
A1015	Wrong product type
A1016	Preloading restriction does not belong to a product
A1017	Preloading restriction does not exist
A1018	The product is not assigned to any loading point in the site
A1019	User does not belong to a specific company
A1020	Unauthorized operation
A1021	Product does not belong to the company
A1022	Site does not belong to the company
A1023	Unloading/loading point does not exist
A1024	Unloading point does not belong to the site
A1026	Current user does not belong to company
A1030	The user is the last company admin
A1033	User is not a verifier in selected requirement profile
A1034	Operation is not allowed
A1036	File size exceeds the limit
A1037	Incorrect file type
A1038	File is null
A1041	User does not have proper role in selected companies
A1045	X button must be shown if link is empty
A1047	Cannot change the verifier role
A1049	User already exists
A1050	Incorrect type of enum
A1051	Requirement profile is not unique
A1052	Company to is not managed by company from in requirement profile
A1054	Incorrect company type
A1055	User already exists in parent company
A1056	Bookmark already exists
A1057	Wrong loading point type
A1058	Wrong opening hours configuration
A1059	Entity cannot be removed
A1060	Not authenticated
A1062	User does not exist
A1064	User is a technical user
A1065	Value cannot be changed
A1066	User invitation could not be completed
A1067	Pre Product does not exist
A1068	PRL restriction cannot be modified because a master product is assigned
A1069	Master product cannot be removed
A1070	Closed tender cannot be modified
A1071	Product is assigned to multiple unloading or loading points
A1072	Lane is not unique
A1073	Company type must be Carrier
A1074	Company type must be Industrial company
A1075	Company reference number does not belong to the parent company
A1076	At least one company must not be a business partner company
A1077	Company partner does not exist
A1078	Company must not be a business partner
A1079	Pre Product or PRL group must be empty
A1080	Loading point product does not exist
A1081	Unloading point product does not exist
A1082	Invalid connecting ID
A1083	Role cannot be changed to tender manager because this is the last company admin
A1085	Verification code is invalid
A1086	Verification codes cannot be sent while the user is not inactive
A1087	Request contains invalid modules
A1089	Subscription deletion failed
A1090	Application deletion failed
A1091	User deletion failed
A1092	Subscription update failed
A1093	Application update failed
A1094	User update failed
A1095	Application-secret creation failed
A1096	Subscription creation failed
A1097	User creation failed
A1098	API Management user creation failed
A1099	Application creation failed
A1100	Application user creation failed
A1101	API Management user deletion failed
A1102	Application user deletion failed
A1103	Pre-loading restrictions cannot be copied between products from different companies
A1105	User already has Loady administrator permissions
A1106	Entity is not connected
A1107	Product is not assigned to any unloading point in the site
A1108	Product is assigned to multiple unloading points
A1109	Loading point does not exist
A1110	Unloading point does not exist
A1111	Application already exists
A1112	Subscription already exists
A1113	Validation start date cannot be later than the end date
A1114	Lane does not belong to the specified company
A1115	Carrier ID is incorrect
A1116	Product master is not in the same unloading/loading point
A1117	Product master does not have the same type as the assigned product
A1118	Assigned product is not assigned to the product master
A1119	A connection cannot be created for an assigned product with an assigned-product master
A1120	An assigned product with an assigned-product master cannot be changed
A1121	Required and excluded vehicle types overlap
A1122	Product is not assigned to the loading point
A1123	Product is not assigned to the unloading point
A1124	At least one of site ID or site reference number must be provided
A1125	Requirement Profile must have a valid verification status
A1126	A default entity already exists
A1127	Webhook type is already in use
A1128	Webhook name is already in use
A1130	Accept-Language header is invalid
A1131	Accept-Language header is unsupported
A1132	Required parameter is missing
A1133	Product master does not exist
A1134	Search text is too long
A1135	Company feature must be enabled
A1136	An exception cannot be created for a PLR that is already an exception
A1137	An exception cannot be created for a customer-only PLR restriction
A1138	Customer is required when creating a PLR exception
A1139	A PLR exception cannot be allowed without cleaning
A1140	PLR exception must be not allowed
A1141	Exceptions cannot be created or retained for a not-allowed PLR restriction
A1142	Deletion dependencies changed
A1143	An active deletion request already exists
A1144	More than one default product of the same type cannot be assigned to the same entity

Validation codes

Code	Description
V1001	Field cannot be null
V1002	Field must be null
V1003	Field cannot be empty
V1004	Field must be empty
V1005	Minimum length error
V1006	Maximum length error
V1007	Email validation error
V1008	Enum validation error
V1009	List count error
V1010	Element already exists
V1011	Decimal precision error
V1012	Duplication error
V1013	Link validation error
V1014	Value must be greater than or equal to the limit
V1015	Value must be less than or equal to the limit
V1016	A disallowed character was used
V1017	Exact length error
V1018	Unacceptable value
V1019	Incorrect dictionary value
V1020	Dictionary does not exist
V1021	URI is invalid
V1022	Response has an invalid TLS certificate or a non-success status
V1023	Invalid month
V1024	Invalid day
V1025	English translation is missing from a multi-language field
V1026	Invalid time
V1027	Phone number validation error
V1028	Date cannot be in the past
V1029	Start date must be before the end date
V1030	Contact email or phone must be provided
V1031	Number of previous loads must match the selected product configuration
V1032	Group, PreProduct, or Customer must be provided

When contacting Loady, provide the UTC timestamp, HTTP method and path, status code, x-correlation-id, and Loady error code. Never provide tokens, subscription keys, secrets, or customer payloads unless an approved secure channel is agreed.