List challenges
curl --request GET \
--url https://app.dotportion.com/api/v1/challenges \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.dotportion.com/api/v1/challenges', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.dotportion.com/api/v1/challenges"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "00000000-0000-4000-8000-000000000001",
"slug": "lru-cache",
"name": "LRU Cache",
"domain": "backend",
"difficulty": "easy",
"level": "mid",
"stack": "node",
"time_limit_minutes": 60,
"budget_dollars_cap": 3,
"is_platform": true,
"is_multi_task": false,
"published_at": "2026-01-15T12:00:00.000Z",
"created_at": "2026-01-15T12:00:00.000Z"
},
{
"id": "00000000-0000-4000-8000-000000000002",
"slug": "spell-cooldown-arbiter",
"name": "Spell Cooldown Arbiter",
"domain": "backend",
"difficulty": "hard",
"level": "senior",
"stack": "node",
"time_limit_minutes": 180,
"budget_dollars_cap": 6,
"is_platform": true,
"is_multi_task": true,
"published_at": "2026-01-15T12:00:00.000Z",
"created_at": "2026-01-15T12:00:00.000Z"
},
{
"id": "00000000-0000-4000-8000-000000000003",
"slug": "acme-internal-etl",
"name": "Acme Internal ETL",
"domain": "data_ml",
"difficulty": "medium",
"level": "mid",
"stack": "python",
"time_limit_minutes": 90,
"budget_dollars_cap": 3,
"is_platform": false,
"is_multi_task": false,
"published_at": "2026-01-15T12:00:00.000Z",
"created_at": "2026-01-15T12:00:00.000Z"
}
],
"meta": {
"request_id": "req_4f2a9c1e8b7d4a5f9e3c2b1a8d7f6e5c",
"page": 1,
"page_size": 20,
"total": 3,
"has_more": false
}
}{
"error": {
"code": "INVALID_INPUT",
"message": "Invalid request",
"details": {
"formErrors": [],
"fieldErrors": {
"name": [
"String must contain at least 1 character(s)"
]
}
},
"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"
}
}Challenges
List challenges
The challenge library visible to you: the shared platform library plus your organization’s own custom challenges. is_platform tells them apart.
Hidden test paths, grading rubrics and grader pack keys are never returned — a candidate could otherwise be coached straight past them.
GET
/
api
/
v1
/
challenges
List challenges
curl --request GET \
--url https://app.dotportion.com/api/v1/challenges \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.dotportion.com/api/v1/challenges', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.dotportion.com/api/v1/challenges"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "00000000-0000-4000-8000-000000000001",
"slug": "lru-cache",
"name": "LRU Cache",
"domain": "backend",
"difficulty": "easy",
"level": "mid",
"stack": "node",
"time_limit_minutes": 60,
"budget_dollars_cap": 3,
"is_platform": true,
"is_multi_task": false,
"published_at": "2026-01-15T12:00:00.000Z",
"created_at": "2026-01-15T12:00:00.000Z"
},
{
"id": "00000000-0000-4000-8000-000000000002",
"slug": "spell-cooldown-arbiter",
"name": "Spell Cooldown Arbiter",
"domain": "backend",
"difficulty": "hard",
"level": "senior",
"stack": "node",
"time_limit_minutes": 180,
"budget_dollars_cap": 6,
"is_platform": true,
"is_multi_task": true,
"published_at": "2026-01-15T12:00:00.000Z",
"created_at": "2026-01-15T12:00:00.000Z"
},
{
"id": "00000000-0000-4000-8000-000000000003",
"slug": "acme-internal-etl",
"name": "Acme Internal ETL",
"domain": "data_ml",
"difficulty": "medium",
"level": "mid",
"stack": "python",
"time_limit_minutes": 90,
"budget_dollars_cap": 3,
"is_platform": false,
"is_multi_task": false,
"published_at": "2026-01-15T12:00:00.000Z",
"created_at": "2026-01-15T12:00:00.000Z"
}
],
"meta": {
"request_id": "req_4f2a9c1e8b7d4a5f9e3c2b1a8d7f6e5c",
"page": 1,
"page_size": 20,
"total": 3,
"has_more": false
}
}{
"error": {
"code": "INVALID_INPUT",
"message": "Invalid request",
"details": {
"formErrors": [],
"fieldErrors": {
"name": [
"String must contain at least 1 character(s)"
]
}
},
"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.
Query Parameters
Restrict to one problem domain.
Available options:
frontend, backend, full_stack, data_ml, ai_agents, security, system_design, infra, mobile Restrict to one difficulty band.
Available options:
easy, medium, hard, trivial, brutal Restrict to one language/framework stack.
Available options:
python, node, python-fastapi, node-express Page number, 1-based.
Items per page, max 100.
Was this page helpful?