Generate a single content item via GET

GET

/api/v1/problems/single

• Production
• Local development

GET mirror of POST /generate/single. Convenience endpoint for single-item generation via query params.

Parameters

Query Parameters

skill

required

string

Example

multiply-by-5

Skill slug (required)

grade

string

Example

grade-3

Grade slug

seed

integer

Example

42

Deterministic seed

Responses

200

Single generated content item

object

data

object

item

Universal content item — the type field determines the shape of content.

object

id

required

string

type

required

string

Allowed values: arithmetic multiple-choice fill-blank true-false short-answer passage-based matching ordering diagram word-puzzle picture-counting picture-arithmetic data-table spelling-activity word-bank category-sorting phonics-word-list tracing-activity

skill

required

Skill slug this item was generated for

string

gradeLevel

required

Grade order (0=K, 1-8)

integer

<= 8

standard

object

code

string

Example

3.OA.C.7

framework

string

Example

CCSS-MATH

description

string

difficulty

required

object

level

required

string

Allowed values: easy medium hard

dok

Depth of Knowledge level

integer

>= 1 <= 4

bloom

Bloom’s taxonomy level

string

Allowed values: remember understand apply analyze evaluate create

gradeEquivalent

Grade-equivalent difficulty

number

complexityScore

Normalized complexity score (0-100)

number

<= 100

content

required

One of: discriminator: type

object

object

type

required

string

Allowed value: arithmetic

operand1

required

One of:

number

number

object

object

numerator

required

integer

denominator

required

integer

> 0

wholeNumber

integer

display

required

string

Example

3/4

operand2

required

One of:

number

number

object

object

numerator

required

integer

denominator

required

integer

> 0

wholeNumber

integer

display

required

string

Example

3/4

operand3

number

operator

required

string

Allowed values: + - × ÷

displayFormat

string

Allowed values: horizontal vertical

missingOperand

string

Allowed values: operand1 operand2 result

object

object

type

required

string

Allowed value: multiple-choice

stem

required

The question text

string

choices

required

Array<object>

object

text

required

string

isDistractor

required

boolean

distractorReason

string

correctIndex

required

integer

explanation

string

object

object

type

required

string

Allowed value: fill-blank

template

required

Text with blank indicated by ___

string

Example

The capital of France is ___.

answer

required

string

acceptableAnswers

Array<string>

caseSensitive

boolean

object

object

type

required

string

Allowed value: true-false

statement

required

string

isTrue

required

boolean

explanation

string

object

object

type

required

string

Allowed value: short-answer

question

required

string

sampleAnswer

string

keywords

Array<string>

object

object

type

required

string

Allowed value: passage-based

passage

required

object

text

required

string

title

required

string

genre

required

string

Allowed values: fiction nonfiction poetry

wordCount

required

integer

readingLevel

string

paragraphs

required

Array<string>

questionCount

required

integer

object

object

type

required

string

Allowed value: matching

instructions

required

string

pairs

required

Array<object>

object

left

required

string

right

required

string

shuffledRight

required

The ‘right’ values in shuffled order for the student

Array<string>

object

object

type

required

string

Allowed value: ordering

instructions

required

string

items

required

Items in correct order

Array<string>

shuffledItems

required

Items in shuffled order for the student

Array<string>

object

object

type

required

string

Allowed value: diagram

diagramKind

required

string

Allowed values: number-line shape coordinate-plane bar-model clock ruler visual-multiplication

diagramData

required

Diagram-specific structured data

object

key

additional properties

any

question

required

string

answer

required

One of:

string

string

number

number

object

object

type

required

string

Allowed value: word-puzzle

puzzleType

required

string

Allowed values: word-search crossword

grid

required

2D character grid

Array<Array<string>>

words

required

Array<object>

object

word

required

string

clue

string

gridSize

required

object

rows

required

integer

cols

required

integer

object

object

type

required

string

Allowed value: picture-counting

count

required

integer

> 0

objectDescription

required

What to count (e.g. ‘apples’, ‘stars’)

string

object

Arithmetic with picture-based counting (K-1 addition/subtraction with icons).

object

type

required

string

Allowed value: picture-arithmetic

operand1

required

integer

operand2

required

integer

operator

required

string

Allowed values: + -

iconType

required

Icon category for visual representation (e.g., ‘apple’, ‘star’)

string

object

object

type

required

string

Allowed value: data-table

tableTitle

required

string

headers

required

Array<string>

rows

required

Array<Array<string>>

question

required

string

answer

required

string

object

Spelling exercise with various activity types (write, unscramble, complete, etc.).

object

type

required

string

Allowed value: spelling-activity

exerciseType

required

string

Allowed values: write-word unscramble complete-word find-misspelling write-contraction expand-contraction copy-word write-from-dictation

word

required

string

definition

string

scrambled

Scrambled version of the word (for unscramble exercises)

string

partial

Partially completed word (for complete-word exercises)

string

misspellings

List of misspelled variants (for find-misspelling)

Array<string>

fullForm

Full form of a contraction

string

contraction

Contracted form of words

string

copyCount

Number of times to copy the word

integer

showTracing

Whether to show tracing guides

boolean

object

Word bank reference section for vocabulary or spelling skills.

object

type

required

string

Allowed value: word-bank

title

Custom header (e.g., ‘Spelling Words’)

string

words

required

Array<object>

object

word

required

string

definition

required

string

partOfSpeech

string

exampleSentence

string

object

Category sorting exercise (science classification, vocabulary grouping).

object

type

required

string

Allowed value: category-sorting

instructions

required

string

categories

required

Array<string>

items

required

Array<object>

object

item

required

string

correctCategory

required

string

object

Phonics word list with target sound identification.

object

type

required

string

Allowed value: phonics-word-list

targetSound

required

The phonics sound or pattern being practiced

string

exerciseType

Type of phonics exercise

string

words

required

All words presented

Array<string>

correctWords

required

Words that contain the target sound

Array<string>

object

Tracing and sight word exercise with SVG guides and sentence context.

object

type

required

string

Allowed value: tracing-activity

exerciseType

required

string

Allowed values: read-and-trace read-and-circle fill-missing rainbow-write match-word

word

required

string

traceSvg

SVG markup for tracing guides

string

sentence

Context sentence using the word

string

choices

Word choices for matching exercises

Array<string>

correctIndex

Index of correct choice

integer

answer

required

object

type

required

string

Allowed values: exact multiple-choice-index open-ended set boolean

value

required

One of:

string

string

number

number

boolean

boolean

display

required

Human-readable display of the answer

string

unit

Unit of measurement if applicable

string

explanation

Explanation of why this is the answer

string

acceptableAnswers

Alternative acceptable answers

Array<string>

renderHints

Optional presentation hints for consumers rendering the content.

object

print

object

suggestedWidth

string

Allowed values: quarter-page half-page full-page

orientation

string

Allowed values: portrait landscape

showWorkSpace

boolean

columns

integer

digital

object

interactiveType

string

Allowed values: input drag-drop tap-choice draw

inputType

string

Allowed values: number text fraction

visuals

object

diagramSvg

SVG markup for diagrams

string

imageRefs

Array<object>

object

id

string

alt

string

category

string

Allowed values: object diagram symbol

answer

object

itemId

required

string

answer

required

Human-readable answer display

string

meta

object

requestId

string format: uuid

generatedAt

string format: date-time

apiVersion

string

Allowed values: v1

cacheHit

boolean

seed

integer

404

Skill not found

RFC 7807 Problem Details

object

type

required

string format: uri

title

required

string

status

required

integer

detail

required

string

instance

string

retryAfter

Seconds to wait before retrying (present on 429 responses)

integer

422

Missing skill parameter

RFC 7807 Problem Details

object

type

required

string format: uri

title

required

string

status

required

integer

detail

required

string

instance

string

retryAfter

Seconds to wait before retrying (present on 429 responses)

integer

429

Rate limit exceeded

RFC 7807 Problem Details

object

type

required

string format: uri

title

required

string

status

required

integer

detail

required

string

instance

string

retryAfter

Seconds to wait before retrying (present on 429 responses)

integer

Example

{
  "type": "https://api.studyplug.org/errors/rate-limited",
  "title": "Rate Limit Exceeded",
  "status": 429,
  "detail": "You have exceeded 30 requests per minute. Please wait before retrying.",
  "instance": "/api/v1/skills",
  "retryAfter": 12
}

Headers

Retry-After

integer

Seconds until rate limit resets

X-RateLimit-Limit

integer

Max requests per window

X-RateLimit-Remaining

integer

Allowed values: 0

Always 0 when rate limited