Notarization status

After you upload your file, the notarization process typically takes less than an hour. This command is used to check the notarization status on the Notary Server.

Command

Notarization status commands begin with:

smctl-mac-x64 notarization status --tool <notarytool or altool> --tool <notarytool or altool> <Software Trust Manager notarization ID or NotaryServer submission ID> <flags>

Note

The flags required for this command differs based on the notarization tool you are using.

Flags

Notarization status commands support these flags:

Table 1. Flags for notarization status commands

Shortcut	Flag	Description
	--input string	Path to file. Allowed file formats: .pkg .dmg .zip Compress .app binaries into a .zip
	--profile-name string	Provide a profile name for your credentials in Keychain.
	--tool string	Provide the notarization tool name that should be used to save your credentials to Keychain. Allowed tools: notarytool altool
-v	--verbose	Enable verbose logging for saving credentials.
-h	--help	Help for describing a scan.

Examples

The notarization status commands depend on the notarization tool that you are using.

Example 1. notarytool

To check thw notarization status on the Notary Server, using notarytool:

smctl-mac-x64 notarization status --tool notarytool <notarization ID or submission ID> --profile-name <Keychain credentials profile name> -v

Command sample:

smctl-mac-x64 notarization status --tool notarytool 5cb03d00-8ab1-4fdc-bb0a-f4167dc01f03 --profile-name notarytool_user -v

Command output:

 {"status":"Accepted","id":"5cb03d00-8ab1-4fdc-bb0a-f4167dc01f03","createdDate":"2023-04-17T06:34:17.574Z","message":"Successfully received submission info","name":"example.dylib.dmg"}
 
checkStatuCommand command was SUCCESSFUL
a1abfd5f-6367-223e-96a6-ab7dff754447
ID: a1abfd5f-6367-223e-96a6-ab7dff754447
SUBMISSION ID: 5af03d00-8af1-4fdc-bb0a-f4167dc01f03
SIGNATUREID:
CREATED ON:2023-04-17 06:34:20 +0000 UTC
CREATED BY:stm user
MODIFIED ON:2023-04-17 06:36:34 +0000 UTC
MODIFIED BY:stm user
ACCOUNT ID:f28bd2a7-0183-4311-b40b-826ea4b1b3e4
LOG:
Tool Used: notarytool
Timestamp:2023-04-17 06:36:34.874059 +0000 UTC
log: {"status":"Accepted","id":"5cb03d00-8ab1-4fdc-bb0a-f4167dc01f03","createdDate":"2023-04-17T06:34:17.574Z","message":"Successfully received submission info","name":"example.dylib.dmg"}

Tool Used: notarytool
Timestamp:2023-04-17 06:34:20.706515 +0000 UTC
log: {"path":"\/Users\/john.doe\/Documents\/testing\/example.dylib.dmg","id":"5cb03d00-8ab1-4fdc-bb0a-f4167dc01f03","message":"Successfully uploaded file"}

Example 2. altool

To check the Notarization status on the Notary Server using altool:

smctl-mac-x64 notarization status  --tool altool --profile-name <Keychain credentials profile ID> <notarization ID or submission ID> -v

Command sample:

smctl-mac-x64 notarization status 71daf9d8-403d-4884-9647-073c2c2d3de9 --tool altool --profile-name altool_user --apple-id john.doe@example.com -v

Command output:

 {"tool-version":"5.329.1309","tool-path":"\/Applications\/Xcode.app\/Contents\/SharedFrameworks\/ContentDeliveryServices.framework\/Versions\/A\/Frameworks\/AppStoreService.framework","success-message":"No errors getting notarization info.","notarization-info":{"Status":"success","Status Message":"Package Approved","LogFileURL":"https:\/\/osxapps-ssl.itunes.apple.com\/itunes-assets\/Enigma126\/v4\/03\/57\/1e\/03571ea5-b1e2-ac95-7744-95fc0df63a19\/developer_log.json?accessKey=1681907270_8538933538709918640_z%2FvxxYYW5zpXvu0K8lIxFicrw7onNnjSiIXSXpD3u7CQFiEWdOEjgElXNEhKkVNfp507SwWsWSi1%2BUTZKelbY1bzFW5oVCxu9Izb6SVG1%2Bqe0WGepu0nBHHv3t%2BsANFwXLVQExKOiprz%2BbPnTUWbm5Wg0ISweyppkqWwWgy%2BuxQ%3D","Date":"2023-04-17T06:26:53.000Z","RequestUUID":"71daf9d8-403d-4884-9647-073c2c2d3de9","Status Code":0,"Hash":"8d295752610a82a9086e393731dcc07f906e1953868e5a115a0dcc73a06a45bd"},"os-version":"12.6.3","warnings":[{"message":"altool has been deprecated for notarization and starting in late 2023 will no longer be supported by the Apple notary service. You should start using notarytool to notarize your software.","userInfo":{"NSLocalizedDescription":"altool has been deprecated for notarization and starting in late 2023 will no longer be supported by the Apple notary service. You should start using notarytool to notarize your software."},"code":-1030}]}

 
checkStatuCommand command was SUCCESSFUL
217f182c-6e08-4cc3-bb2f-8717dc0512a5
ID: 217f182c-6e08-4cc3-bb2f-8717dc0512a5
SUBMISSION ID: 71daf9d8-403d-4884-9647-073c2c2d3de9
SIGNATUREID:
CREATED ON:2023-04-17 06:26:53 +0000 UTC
CREATED BY:stm user
MODIFIED ON:2023-04-17 06:27:50 +0000 UTC
MODIFIED BY:stm user
ACCOUNT ID:f28bd2a7-0183-4311-b40b-826ea4b1b3e4
LOG:
Tool Used: altool
Timestamp:2023-04-17 06:27:50.954966 +0000 UTC
log: {"tool-version":"5.329.1309","tool-path":"\/Applications\/Xcode.app\/Contents\/SharedFrameworks\/ContentDeliveryServices.framework\/Versions\/A\/Frameworks\/AppStoreService.framework","success-message":"No errors getting notarization info.","notarization-info":{"Status":"success","Status Message":"Package Approved","LogFileURL":"https:\/\/osxapps-ssl.itunes.apple.com\/itunes-assets\/Enigma126\/v4\/03\/57\/1e\/03571ea5-b1e2-ac95-7744-95fc0df63a19\/developer_log.json?accessKey=1681907270_8538933538709918640_z%2FvxxYYW5zpXvu0K8lIxFicrw7onNnjSiIXSXpD3u7CQFiEWdOEjgElXNEhKkVNfp507SwWsWSi1%2BUTZKelbY1bzFW5oVCxu9Izb6SVG1%2Bqe0WGepu0nBHHv3t%2BsANFwXLVQExKOiprz%2BbPnTUWbm5Wg0ISweyppkqWwWgy%2BuxQ%3D","Date":"2023-04-17T06:26:53.000Z","RequestUUID":"71daf9d8-403d-4884-9647-073c2c2d3de9","Status Code":0,"Hash":"8d295752610a82a9086e393731dcc07f906e1953868e5a115a0dcc73a06a45bd"},"os-version":"12.6.3","warnings":[{"message":"altool has been deprecated for notarization and starting in late 2023 will no longer be supported by the Apple notary service. You should start using notarytool to notarize your software.","userInfo":{"NSLocalizedDescription":"altool has been deprecated for notarization and starting in late 2023 will no longer be supported by the Apple notary service. You should start using notarytool to notarize your software."},"code":-1030}]}


Tool Used: altool
Timestamp:2023-04-17 06:26:53.51834 +0000 UTC
log: {"tool-version":"5.329.1309","tool-path":"\/Applications\/Xcode.app\/Contents\/SharedFrameworks\/ContentDeliveryServices.framework\/Versions\/A\/Frameworks\/AppStoreService.framework","notarization-upload":{"RequestUUID":"71daf9d8-403d-4884-9647-073c2c2d3de9"},"success-message":"No errors uploading '\/Users\/john.doe\/Documents\/testing\/example.dylib.dmg'.","os-version":"12.6.3","warnings":[{"message":"altool has been deprecated for notarization and starting in late 2023 will no longer be supported by the Apple notary service. You should start using notarytool to notarize your software.","userInfo":{"NSLocalizedDescription":"altool has been deprecated for notarization and starting in late 2023 will no longer be supported by the Apple notary service. You should start using notarytool to notarize your software."},"code":-1030}]}

Troubleshooting

For help with the describe scan command, use:

smctl-mac-x64 notarization status --help

Alternatively, use the abbreviated version of the command:

smctl-mac-x64 notarization status -h

In this section: