Projects
Get a project
GET
/api/v1/projects/{id}
- API key access
- Read only or read and write
- Project permission
- Any access to the project
- Success
- 200 — OK
Parameters
Path
| Parameter | Type | Notes |
|---|---|---|
id required |
string | Project id |
Example request
Replace tk_live_YOUR_KEY with your API key and the ids with your own.
curl 'https://trackerv2.marketingplanet.global/api/v1/projects/6650a4c2e1b3d5f7a9c1e301' \
-H 'Authorization: Bearer tk_live_YOUR_KEY'
const response = await fetch('https://trackerv2.marketingplanet.global/api/v1/projects/6650a4c2e1b3d5f7a9c1e301', {
headers: {
Authorization: 'Bearer tk_live_YOUR_KEY',
},
});
const result = await response.json();
if (!response.ok) throw new Error(`${result.error.code}: ${result.error.message}`);
console.log(result.data);
import requests
response = requests.get(
"https://trackerv2.marketingplanet.global/api/v1/projects/6650a4c2e1b3d5f7a9c1e301",
headers={"Authorization": "Bearer tk_live_YOUR_KEY"},
)
result = response.json()
if not response.ok:
raise RuntimeError(f"{result['error']['code']}: {result['error']['message']}")
print(result["data"])
Example response
{
"data": {
"id": "6650a4c2e1b3d5f7a9c1e301",
"name": "Acme Retail",
"domain": "acmeretail.com",
"role": "owner",
"trackingStatus": "active",
"phases": {
"uptime": true,
"technical": true,
"sitemap": true,
"pages": true,
"robots": true,
"llm": false,
"udp": false,
"dns": true,
"domainExpiry": true,
"ports": true
},
"intervals": {
"uptimeMinutes": 5,
"pagesMinutes": 1440,
"technicalMinutes": 1440,
"dnsMinutes": 60
},
"uptime": {
"scheme": "https",
"port": null,
"timeoutSeconds": 30,
"alertRepeatMinutes": 60,
"lastStatus": "success",
"lastCheckedAt": "2026-10-06T09:25:12.000Z"
},
"healthCheck": {
"verifyHeader": false,
"headerName": "",
"headerValueIncludes": "",
"verifyContent": true,
"contentIncludes": "Add to cart"
},
"sitemap": {
"url": "https://acmeretail.com/sitemap.xml",
"status": "ok",
"lastCheckedAt": "2026-10-06T03:00:41.000Z",
"pagesFound": 128
},
"robotsUrl": null,
"llmUrl": null,
"domainExpiry": {
"status": "ok",
"daysLeft": 212,
"lastCheckedAt": "2026-10-05T03:00:00.000Z"
},
"technicalLastCheckedAt": "2026-10-06T03:00:45.000Z",
"cms": "wordpress",
"createdAt": "2026-05-24T10:12:00.000Z",
"updatedAt": "2026-10-06T09:25:12.000Z"
}
}
Response fields
| Field | Type | Notes |
|---|---|---|
data |
object | |
data.id |
string | |
data.name |
string | |
data.domain |
string | |
data.role |
"owner" | "member" | |
data.trackingStatus |
"active" | "inactive" | "paused-by-plan" | |
data.phases |
object | Which monitors are on. |
data.phases.uptime |
boolean | |
data.phases.technical |
boolean | |
data.phases.sitemap |
boolean | |
data.phases.pages |
boolean | |
data.phases.robots |
boolean | |
data.phases.llm |
boolean | |
data.phases.udp |
boolean | |
data.phases.dns |
boolean | |
data.phases.domainExpiry |
boolean | |
data.phases.ports |
boolean | |
data.intervals |
object | Minutes. Plan minimums apply. null when that monitor has no schedule yet. |
data.intervals.uptimeMinutes |
integer or null | |
data.intervals.pagesMinutes |
integer or null | |
data.intervals.technicalMinutes |
integer or null | |
data.intervals.dnsMinutes |
integer or null | |
data.uptime |
object | |
data.uptime.scheme |
"https" | "http" | |
data.uptime.port |
integer or null | |
data.uptime.timeoutSeconds |
integer | |
data.uptime.alertRepeatMinutes |
integer | |
data.uptime.lastStatus |
string or null | |
data.uptime.lastCheckedAt |
string (date-time) or null | |
data.healthCheck |
object | |
data.healthCheck.verifyHeader |
boolean | |
data.healthCheck.headerName |
string | max 200 chars |
data.healthCheck.headerValueIncludes |
string | max 500 chars |
data.healthCheck.verifyContent |
boolean | |
data.healthCheck.contentIncludes |
string | max 2000 chars |
data.sitemap |
object | |
data.sitemap.url |
string or null | |
data.sitemap.status |
string or null | |
data.sitemap.lastCheckedAt |
string (date-time) or null | |
data.sitemap.pagesFound |
integer | |
data.robotsUrl |
string or null | |
data.llmUrl |
string or null | |
data.domainExpiry |
object | |
data.domainExpiry.status |
string or null | |
data.domainExpiry.daysLeft |
integer or null | |
data.domainExpiry.lastCheckedAt |
string (date-time) or null | |
data.technicalLastCheckedAt |
string (date-time) or null | |
data.cms |
string or null | |
data.createdAt |
string (date-time) | |
data.updatedAt |
string (date-time) |
Errors
Besides the errors any request can return (bad or missing key, plan, scope, rate limit), this endpoint can return:
| Status | error.code | Meaning |
|---|---|---|
| 404 | not-found | The resource does not exist or you cannot open it. Tracker does not reveal which. |
Errors always look like { "error": { "code": "…", "message": "…" } }. See Errors & limits.