User Guide

Home / Music APIs / User Guide

Web API User Guide

Our Web API provides client applications with top-of-the-line audio and music analysis.

Note that by using DoReMIR developer tools, you accept our Developer Terms of Use.

About the Web API

Through the DoReMIR Web API your applications can use DoReMIR functionality. The DoReMIR Web API is functional in the sense that all requests have some input; Audio, MIDI, etc and all responses have some output; Audio, MIDI, MusicXML, etc. No data is saved for later retrieval.

The base address of the API is https://api.doremir.com. There are several endpoints at that address, each with its own unique path. To access the endpoints you first register an application to get the necessary credentials. Some endpoints are free of use and others need a subscription. To sign up for a subscription, contact DoReMIR API services.

Requests

API calls are sent using standard HTTPS POST requests in UTF-8 format to an API endpoint. The input (Audio, MIDI, etc) is passed in the request body. Additional data is passed URL parameters.

Responses

The response data (Audio, MIDI, MusicXML, etc) is received in the response body.

Response Status Codes

The API uses the following response status codes, as defined in the RFC 2616 and RFC 6585:

Status CodeDescription
200OK - The request has succeeded. The client can read the result of the request in the body and the headers of the response.
204No Content - The request has succeeded but returns no message body.
400Bad Request - The request could not be understood by the server due to malformed syntax. The message body will contain more information; see Error Details.
401Unauthorized - The request requires user authentication or, if the request included authorization credentials, authorization has been refused for those credentials.
403Forbidden - The server understood the request, but is refusing to fulfill it.
404Not Found - The requested resource could not be found. This error can be due to a temporary or permanent condition.
500Internal Server Error. You should never receive this error because our clever coders catch them all ... but if you are unlucky enough to get one, please report it to us by sending an email to api@doremir.com.
502Bad Gateway - The server was acting as a gateway or proxy and received an invalid response from the upstream server.
503Service Unavailable - The server is currently unable to handle the request due to a temporary condition which will be alleviated after some delay. You can choose to resend the request again.

Authentication

Some requests to the Web API require authentication. This is achieved by sending a valid OAuth access token as a request parameter, see the API Endpoint Reference.