Retrieve your account
curl --request GET \
--url https://app.dotportion.com/api/v1/account \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.dotportion.com/api/v1/account', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.dotportion.com/api/v1/account"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"id": "00000000-0000-4000-8000-000000000001",
"name": "Sandbox Co",
"slug": "sandbox-co",
"plan": {
"id": "startup",
"subscription_status": "active",
"billing_currency": "USD",
"limits_enforced": true
},
"usage": {
"period_start": "2026-01-01T00:00:00.000Z",
"assessments_used": 4,
"assessments_limit": 25
},
"branding": {
"accent_color": "#2f6f4f",
"primary_color": null,
"logo_url": null,
"sender_name": null,
"support_email": null
},
"custom_domain": null,
"custom_domain_verified": false,
"created_at": "2025-11-01T00:00:00.000Z"
},
"meta": {
"request_id": "req_4f2a9c1e8b7d4a5f9e3c2b1a8d7f6e5c"
}
}{
"error": {
"code": "INVALID_TOKEN",
"message": "Invalid or revoked API key",
"request_id": "req_4f2a9c1e8b7d4a5f9e3c2b1a8d7f6e5c"
}
}{
"error": {
"code": "INSUFFICIENT_SCOPE",
"message": "This API key lacks the required scope: write.",
"request_id": "req_4f2a9c1e8b7d4a5f9e3c2b1a8d7f6e5c"
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "Rate limit exceeded for write requests (200/hour). Retry after 2026-01-15T13:00:00.000Z.",
"details": {
"limit": 200,
"remaining": 0,
"reset": 1768482000
},
"request_id": "req_4f2a9c1e8b7d4a5f9e3c2b1a8d7f6e5c"
}
}{
"error": {
"code": "INTERNAL_ERROR",
"message": "Internal server error",
"request_id": "req_4f2a9c1e8b7d4a5f9e3c2b1a8d7f6e5c"
}
}Account
Retrieve your account
Organization, plan, current-period usage and branding.
Usage covers the current period only. Billing identifiers are never exposed — manage billing in your provider dashboard.
GET
/
api
/
v1
/
account
Retrieve your account
curl --request GET \
--url https://app.dotportion.com/api/v1/account \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.dotportion.com/api/v1/account', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.dotportion.com/api/v1/account"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"id": "00000000-0000-4000-8000-000000000001",
"name": "Sandbox Co",
"slug": "sandbox-co",
"plan": {
"id": "startup",
"subscription_status": "active",
"billing_currency": "USD",
"limits_enforced": true
},
"usage": {
"period_start": "2026-01-01T00:00:00.000Z",
"assessments_used": 4,
"assessments_limit": 25
},
"branding": {
"accent_color": "#2f6f4f",
"primary_color": null,
"logo_url": null,
"sender_name": null,
"support_email": null
},
"custom_domain": null,
"custom_domain_verified": false,
"created_at": "2025-11-01T00:00:00.000Z"
},
"meta": {
"request_id": "req_4f2a9c1e8b7d4a5f9e3c2b1a8d7f6e5c"
}
}{
"error": {
"code": "INVALID_TOKEN",
"message": "Invalid or revoked API key",
"request_id": "req_4f2a9c1e8b7d4a5f9e3c2b1a8d7f6e5c"
}
}{
"error": {
"code": "INSUFFICIENT_SCOPE",
"message": "This API key lacks the required scope: write.",
"request_id": "req_4f2a9c1e8b7d4a5f9e3c2b1a8d7f6e5c"
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "Rate limit exceeded for write requests (200/hour). Retry after 2026-01-15T13:00:00.000Z.",
"details": {
"limit": 200,
"remaining": 0,
"reset": 1768482000
},
"request_id": "req_4f2a9c1e8b7d4a5f9e3c2b1a8d7f6e5c"
}
}{
"error": {
"code": "INTERNAL_ERROR",
"message": "Internal server error",
"request_id": "req_4f2a9c1e8b7d4a5f9e3c2b1a8d7f6e5c"
}
}Authorizations
Your API key, live (sk_live_…) or test (sk_test_…). Create one in Settings → API keys. Send it as Authorization: Bearer <key> — never in a query string.
Was this page helpful?