List Issues

GET

issues

curl "https://api.promptster.ai/v1/issues?language=typescript&difficulty=medium&limit=10" \
  -H "Authorization: Bearer psk_live_abc123def456"

{
  "issues": [
    {
      "id": "iss_abc123",
      "source": "github",
      "repoUrl": "https://github.com/facebook/react",
      "repoSlug": "facebook/react",
      "issueNumber": 28347,
      "issueTitle": "useEffect cleanup runs with stale closure",
      "issueUrl": "https://github.com/facebook/react/issues/28347",
      "language": "typescript",
      "difficulty": "medium",
      "skillTags": ["hooks", "closures", "state-management"],
      "estimatedMinutes": 45,
      "taskBrief": "Fix the stale closure bug in the useEffect cleanup function...",
      "setupInstructions": "Run `npm install` then `npm test` to see the failing test.",
      "isCustom": false,
      "createdAt": "2026-03-01T00:00:00.000Z"
    }
  ],
  "total": 23,
  "limit": 20,
  "offset": 0
}

Returns a paginated list of issues from the Promptster problem library. Each issue is a real, verified open-source bug with a test suite that validates the fix. Use these when creating assessments to give candidates well-defined coding challenges.

Authentication

Requires either an org API key or a Clerk JWT.

Authorization: Bearer psk_live_...

string

Filter by programming language (e.g. typescript, python, go, react).

string

Filter by difficulty level (e.g. easy, medium, hard).

string

default:"active"

Filter by issue status. Defaults to active.

integer

default:"20"

Number of issues to return. Maximum 50.

integer

default:"0"

Number of issues to skip for pagination.

array

List of issue objects.

Show properties

string

Issue ID (UUID).

string

Source repository host (e.g. github).

string

Repository URL.

string | null

Short repo identifier (e.g. facebook/react).

integer | null

Original issue/PR number.

string

Issue title.

string | null

Link to the original GitHub issue.

string

Primary language.

string

Difficulty level.

string[]

Skill tags (e.g. ["state-management", "hooks"]).

integer | null

Estimated time to solve in minutes.

string

Markdown task description for candidates.

string

Setup instructions for the candidate’s workspace.

boolean

Whether this is a custom (org-uploaded) issue.

string

ISO 8601 timestamp.

integer

Total number of matching issues.

integer

The limit used for this request.

integer

The offset used for this request.

{
  "issues": [
    {
      "id": "iss_abc123",
      "source": "github",
      "repoUrl": "https://github.com/facebook/react",
      "repoSlug": "facebook/react",
      "issueNumber": 28347,
      "issueTitle": "useEffect cleanup runs with stale closure",
      "issueUrl": "https://github.com/facebook/react/issues/28347",
      "language": "typescript",
      "difficulty": "medium",
      "skillTags": ["hooks", "closures", "state-management"],
      "estimatedMinutes": 45,
      "taskBrief": "Fix the stale closure bug in the useEffect cleanup function...",
      "setupInstructions": "Run `npm install` then `npm test` to see the failing test.",
      "isCustom": false,
      "createdAt": "2026-03-01T00:00:00.000Z"
    }
  ],
  "total": 23,
  "limit": 20,
  "offset": 0
}

curl "https://api.promptster.ai/v1/issues?language=typescript&difficulty=medium&limit=10" \
  -H "Authorization: Bearer psk_live_abc123def456"

curl "https://api.promptster.ai/v1/issues?language=typescript&difficulty=medium&limit=10" \
  -H "Authorization: Bearer psk_live_abc123def456"

{
  "issues": [
    {
      "id": "iss_abc123",
      "source": "github",
      "repoUrl": "https://github.com/facebook/react",
      "repoSlug": "facebook/react",
      "issueNumber": 28347,
      "issueTitle": "useEffect cleanup runs with stale closure",
      "issueUrl": "https://github.com/facebook/react/issues/28347",
      "language": "typescript",
      "difficulty": "medium",
      "skillTags": ["hooks", "closures", "state-management"],
      "estimatedMinutes": 45,
      "taskBrief": "Fix the stale closure bug in the useEffect cleanup function...",
      "setupInstructions": "Run `npm install` then `npm test` to see the failing test.",
      "isCustom": false,
      "createdAt": "2026-03-01T00:00:00.000Z"
    }
  ],
  "total": 23,
  "limit": 20,
  "offset": 0
}

Get Started

Understanding Sessions

Guides

API Reference

Assessments

Keys

Sessions

Candidates

Analytics

Problem Library

Hooks

Branding

Webhooks

Resources

Authentication

​Authentication

Authentication