Accessing the APIs

To send successful requests, you need to retrieve a valid access token and add it to your requests.

❗️

Warning

The token needs to be kept secret. Do not reveal it to anyone and avoid practices that might do so. For instance, it is advised not to save it in plain text and not to commit it to the source code repositories (ilke GitHub or Mercurial).

To access the API, you use access tokens.

You can retrieve this token from the dashboard.

To add the access token to your requests, you can add the x-marketplace-token field to the headers of them.

After you register your marketplace with support, you will be sent a user that you can use to log in to the dashboard. You can access the dashboard at https://manage.marketplace.taxamo.com.

To create a token, go to Settings > View API tokens > Create token.

Once the access token is retrieved, all the API endpoints offered by the service can be used. You can add the token in the x-marketplace-token field in the request's header. For example:

```
GET /api/v3/marketplace/transactions HTTP/2
Host: marketplace-api.marketplace.taxamo.com
x-marketplace-token: ms_******************************
...
```

You can also issue multiple tokens. You can also enter a token description and remove a token.