{"info":{"_postman_id":"776ef806-51e0-40e3-92d1-ddb22bbd1677","name":"Sitecheck Calibrations","description":"

Sitecheck Calibration API
The MOT Club Sitecheck API to receive equipment calibration updates.
Calibration certificates can be uploaded to the MOT Club system.
A confirmation email will be sent to the testing station upon the receipt of a calibration.

\n

Equipment Types
The following equipment types are used:

\n\n

API Key
An API key must be obtained from The MOT Club to use the calibration API, by sending a request to info@themotclub.com.
The API key is passed in the 'x-api-key' header field.

\n

Certificates
Certificates may be uploaded to the MOT Club system. When 'upload_certificate' is true and a certificate file name is supplied a signed URL will be generated for the certificate filename given in the request body.The URL is valid for a maximum of 10 minutes from time of the request,
Alternatively a URL may be supplied where the testing site can view or download the certificate.

\n

Errors
A missing or incorrect API key will give HTTP status 403 and the error message 'Forbidden'.
Post authentication errors will have 400 range status codes and return an error object of the form shown below.

\n
{ \"error\": \"Error name\", \"details\": \"Details of error\"}\n\n
\n

In the case of input validation errors the details field will be an array of strings giving the validation error(s), as below.

\n
{ \"error\": \"Validation error\", \"details\": [\"\\\"calibration_date\\\" must be a valid date\", \"\\\"offsite\\\" must be a boolean\"]}\n\n
\n

Error List

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Error MessageStatusInformation
Error parsing JSON data400JSON payload is not valid JSON details field will give basic troubleshooting help.
Validation error400There was a problem with on or more fields of the payload or there were missing fields.
Certificate filename missing400'upload_certificate' was set to true but no filename was given in the request body.
Account not found404The testing station account was not found from the VTS number supplied, check VTS number is correct.
\n

If you receive any other error message please report it to the MOT Club by emailing info@themotclub.com.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"6495082","collectionId":"776ef806-51e0-40e3-92d1-ddb22bbd1677","publishedId":"UVyvuZpT","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"publishDate":"2022-04-06T15:00:30.000Z"},"item":[{"name":"POST Calibration","id":"1e79b2d9-5cc2-495a-8c7e-76b6af78fcb8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"calibration_reference\": \"CAL123456\",\n \"vts_number\": \"S003477\",\n \"equipment_type\": \"Decelerometer\",\n \"serial_number\": \"DEC123499\",\n \"make\": \"Mtt Garage Tech\",\n \"model\": \"DEC-100\",\n \"calibration_date\": \"2025-06-09\",\n \"next_calibration_date\": \"2026-06-09\",\n \"supplier_equipment_id\": \"148267890\",\n \"offsite\": false,\n \"upload_certificate\": true,\n \"certificate_file_name\": \"park.jpg\",\n \"certificate_url\": \"https://download.example.com/bt147147.pdf\",\n \"connected\": true,\n \"calibration_months\": 6\n}","options":{"raw":{"language":"json"}}},"url":"https://api-pub.themotclub.com/v1/calibrations","description":"

Items will be searched by matching vts_number, equipment_type and supplier_equipment_id.If that search fails then a second search on vts_number, equipment_type and serial_number will be made for items that don't have a supplier_equipment_id.
If neither search finds a match then a new equipment record will be created in the Sitecheck system for the testing station.

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"776ef806-51e0-40e3-92d1-ddb22bbd1677","id":"776ef806-51e0-40e3-92d1-ddb22bbd1677","name":"Sitecheck Calibrations","type":"collection"}},"urlObject":{"protocol":"https","path":["v1","calibrations"],"host":["api-pub","themotclub","com"],"query":[],"variable":[]}},"response":[{"id":"ce978aa8-10f1-43fd-b6e0-9b78228ec6a4","name":"POST Calibration","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"calibration_reference\": \"CAL123456\",\n \"vts_number\": \"S003477\",\n \"equipment_type\": \"Decelerometer\",\n \"serial_number\": \"DEC123499\",\n \"make\": \"Mtt Garage Tech\",\n \"model\": \"DEC-100\",\n \"calibration_date\": \"2025-06-09\",\n \"next_calibration_date\": \"2026-06-09\",\n \"supplier_equipment_id\": \"148267890\",\n \"offsite\": false,\n \"upload_certificate\": true,\n \"certificate_file_name\": \"park.jpg\",\n \"certificate_url\": \"https://download.example.com/bt147147.pdf\",\n \"connected\": true,\n \"calibration_months\": 6\n}","options":{"raw":{"language":"json"}}},"url":"https://api-pub.themotclub.com/v1/calibrations"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 09 Jun 2025 15:06:23 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"2163"},{"key":"Connection","value":"keep-alive"},{"key":"x-amzn-RequestId","value":"eb248fcd-482f-49ec-ba8a-690966d01c7e"},{"key":"x-amz-apigw-id","value":"L5vArELZrPEEfPA="},{"key":"X-Amzn-Trace-Id","value":"Root=1-6846f86a-01ec11ac54d7b9961e0cc55f;Parent=62fe89bd66a583d5;Sampled=0;Lineage=1:b8bec1b7:0"}],"cookie":[],"responseTime":null,"body":"{\n \"calibration_reference\": \"CAL123456\",\n \"vts_number\": \"S003477\",\n \"equipment_type\": \"Decelerometer\",\n \"serial_number\": \"DEC123499\",\n \"make\": \"Mtt Garage Tech\",\n \"model\": \"DEC-100\",\n \"calibration_date\": \"2025-06-09T00:00:00.000Z\",\n \"next_calibration_date\": \"2026-06-09T00:00:00.000Z\",\n \"supplier_equipment_id\": \"148267890\",\n \"offsite\": false,\n \"upload_certificate\": true,\n \"certificate_file_name\": \"park.jpg\",\n \"certificate_url\": \"https://download.example.com/bt147147.pdf\",\n \"connected\": true,\n \"calibration_months\": 6,\n \"upload_url\": \"https://s3.eu-west-2.amazonaws.com/archive.themotclub.com/09TEST/attachments/equipment/23097/calibrations/66877/park.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=ASIATW7SC4WZQBQLGMRL%2F20250609%2Feu-west-2%2Fs3%2Faws4_request&X-Amz-Date=20250609T150622Z&X-Amz-Expires=600&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEM%2F%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCWV1LXdlc3QtMiJIMEYCIQCaR4nGBwo3hzEZJgQmQdKzH5HEDm4v7NOakjHflANl7gIhAOkRiAgZwbT33P8ESPBIfIyRGaQE%2BGyq9zFu3msHeexaKtwDCKj%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEQAxoMMjU1NTIxMzgzODU5Igymcsf3yXDWyb7wLsEqsAOw%2Fpi1JIg4VSE7KJXk4OtbCqJ%2BUzhQ7koKt%2FYBQjVIKc25nqNNAifXMlmt1A7doQROVi%2BVHPRabUA11aFl0Xyz3YoTwvZv8O2P4PwfgFpdRMREFGt%2FTbFsxow1tXdIU%2BRe3o3fZ%2FBokn4tlWYKavEtcdCziDk9OEdhkNMZttV1xmKvr%2FlXDlzm1flnsWcfYET%2FwAg0ECP2%2FsvjxUDlLJzNVMm9COJBMwhGtkkXEES22dQjcNoIXii1Pz53c%2Bb6j5PN5wqRrRZt51qpXjsEnJtL6eVsYO2MoIZKlFQjiZO3Z4V5LWUa7hNH2uByXyjpZBbsPoj%2BTqgsWH0r4wPD3qUtFzZJxzW1iPoPn247ai8JBmBBvBhaDfscRJp2yqW3qplDZPInM9eFUlCybDTZGAPVco8%2FpMaQlfz%2Bz9bbFWLhmO%2F1B%2Fwarps9Ur%2B%2Faae0J0FFWJo9auqybIo7pKgdGdb80smwlKyK9Y53GLMFHE3OXkrHk0xUl0kd0V11gvu962poVVZV5p9FCpJY2VH5e4VX4Z%2B40jQmSfx%2BujaK2NTkPwGzhyz3WqZTgyAN9oRGQoww6vCbwgY6nQHgX875VQDJjV9A0gYRZr6nvRiLEUz6MHvQeF%2Fw1sgvZvcAnsxlxI4SorzHTSR9j2hibxU5ph9za1nq2%2BR5Aec7WRKjA7YZpcmLRK6G1ZvRVCU2rcmlH0EoFVDxb1kh6LVQYdpJ1kgJMBiVwlJu3cTU013G0%2BGpteEQ7yRjDOzwDqyG2Y2xvJRALWPVcYj0RLxjcvuLJoc9nSWPQuZa&X-Amz-Signature=e5256451a8cdd6d47cd4888669b6d073f04fb4efdd0001c6670e84a5f85d8fa8&X-Amz-SignedHeaders=host&x-amz-checksum-crc32=AAAAAA%3D%3D&x-amz-sdk-checksum-algorithm=CRC32&x-id=PutObject\",\n \"supplier_id\": 1312,\n \"request_ip\": \"92.40.63.103\"\n}"}],"_postman_id":"1e79b2d9-5cc2-495a-8c7e-76b6af78fcb8"}],"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":""}]}},"event":[{"listen":"prerequest","script":{"id":"409972f7-5c31-48c9-9e47-c2d52f0d29fa","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"2953d93b-e963-4a66-8f4c-8bc0e018fc1b","type":"text/javascript","exec":[""]}}]}