Quickstart

Step 1: Obtain your Client Credentials

mpathic credentials are provided via the OAuth2.0 Client Credentials flow. To make any authenticated calls you will need an MPATHIC-ID, CLIENT_ID and CLIENT_SECRET. Please reach out to us to obtain your unique combination. You will receive an authentication error if any combination of these are invalid.

Step 2: Request an Access Token

POST /v1/token HTTP/1.1
Host: example.com
mpathic-id: <<MPATHIC-ID>>
Content-Type: application/json

{
  "grant_type": "client_credentials",
  "client_id": "<<CLIENT_ID>>",
  "client_secret": "<<CLIENT_SECRET>>"
}

Try it via our API Reference or paste the above into any http request

Step 3: Retrieve your Profile

The MPATHIC-PROFILE header is optional. If no profile is provided then the default profile will be used.

GET /v1/profile HTTP/1.1
Host: example.com
mpathic-id: <<MPATHIC-ID>>
mpathic-profile: <<MPATHIC-PROFILE>>
Authorization: Bearer <<ACCESS_TOKEN>>

Try it via our API Reference or paste the above into any http request