First API Call

This guide walks through making your first successful API call — listing studies.

Prerequisites

• You have a client_id and client_secret (see Authentication)
• Your client has the Study:Read scope

Step 1 — Get a token

curl -X POST https://api.account.dev2.patholytix.com/oauth2/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET"

Copy the access_token value from the response.

Step 2 — List studies

curl "https://api.dev2.patholytix.com/api/v1/studies?pageNumber=1&pageSize=10" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Response:

{
  "paging": {
    "pageNumber": 1,
    "pageSize": 10,
    "totalItems": 1,
    "links": {
      "prev": null,
      "next": null
    }
  },
  "items": [
    {
      "studyId": "5cd97ae75fdbf7000143cb30",
      "studyName": "Phase II Oncology Study",
      "siteId": "698b6bb4b4469696051e32ad",
      "glpStatus": "NONE",
      "createdDate": "2026-01-07T12:55:14.041Z",
      "updatedDate": "2026-01-07T12:55:14.041Z"
    }
  ]
}

Step 3 — Fetch a single study

curl "https://api.dev2.patholytix.com/api/v1/studies/5cd97ae75fdbf7000143cb30" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"