---
title: Notary API
framework: Notary API
role: collection
role_heading: Web Service
platforms: [notary api 2.0.0+]
path: notaryapi
---

# Notary API

Submit your macOS software for notarization through a web interface.

## Overview

Overview Notarization gives people confidence that your Developer ID-signed macOS software has been checked by Apple for malicious code. In addition to interacting with the notary service through Xcode or the notarytool command-line utility, you can bypass notarytool and interact directly with the service through its REST API. The Notary API is helpful for instances where you need to avoid a macOS dependency when uploading your app to the notary service, and provides endpoints that enable you to: Prepare the notary service to receive a new version of your software, and get credentials that you use to upload your software to an Amazon S3 endpoint. Check the status of a submission. Retrieve a log file that provides details about a submission. Get a list of your team’s previous submissions. To learn how notarization works, see Notarizing macOS software before distribution. For details about using the notary service REST API to upload your software, see Submitting software for notarization over the web.

## Topics

### Essentials

- [Submitting software for notarization over the web](notaryapi/submitting-software-for-notarization-over-the-web.md)

### Software submission

- [Submit Software](notaryapi/submit-software.md)
- [NewSubmissionRequest](notaryapi/newsubmissionrequest.md)
- [NewSubmissionResponse](notaryapi/newsubmissionresponse.md)

### Notarization results

- [Get Submission Status](notaryapi/get-submission-status.md)
- [SubmissionResponse](notaryapi/submissionresponse.md)
- [Get Submission Log](notaryapi/get-submission-log.md)
- [SubmissionLogURLResponse](notaryapi/submissionlogurlresponse.md)

### History

- [Get Previous Submissions](notaryapi/get-previous-submissions.md)
- [SubmissionListResponse](notaryapi/submissionlistresponse.md)

### Errors

- [ErrorResponse](notaryapi/errorresponse.md)