Skip to main content


The MARCO API is RESTful interface designed for developers to integrate MARCO into their applications and services. This documentation provides an understanding of the HTTP requests, endpoints, and additional guides.

HTTP requests

Most endpoints are protected using Bearer Authentication.

Before you start making API calls, you need two tokens:

  • AccessToken: A token issued from the /v1/auth/token endpoint. Generate one with Key File or API Key.
  • ApplicationToken: A token that is associated with the Marpp. To create one, see Generate an API Key

For a step-by-step tutorial to retrieve the necessary access and application tokens, refer to our Quickstart.

With the tokens in hand, you are set to authenticate your API requests. For instance, if you are aiming to access the GET /v1/sample-endpoint, ensure your request includes the headers as shown below:

curl --location --request GET '' \
--header 'Accept: application/json' \
--header 'ApplicationToken: <APPLICATION_TOKEN>'\
--header 'Authorization: Bearer <ACCESS_TOKEN>'

By following this authentication method, you can securely and effectively communicate with MARCO's API endpoints.


MARCO API is organized into the following collections: