Flashcards

A deck of question-and-answer flashcards from a topic, your text or a document, with an Anki-compatible CSV.

Price1 credit (10p) per set
Typical time10 s to 60 s
Scopelearning:write
Runs asA background job

Try it

Run flashcards in the sandbox

No key and nothing to pay. The sandbox returns a realistic example in a couple of seconds; no AI runs and no data is kept.

TopicA subject to study from general knowledge, for example "Photosynthesis for GCSE Biology".

Source TextYour own teaching text (at least 200 characters, at most 10,000 words). Material stays grounded in it.

TitleA name for your text or document, such as the lesson or chapter title.

FocusConcepts to concentrate on, in plain words.

LevelHow to pitch the material. Leave it out for upper-secondary to first-year university level.

AudienceWho the material is for, for example "Year 10 learners who find maths hard".

LanguageThe language to write in. British English unless you choose another.

CountHow many cards to make (5 to 30). Fewer come back only when the source honestly supports fewer.

Stylequick_recall: one crisp fact per card. definitions: term and definition. key_concepts: core ideas explained briefly. difficult_concepts: the ideas learners most often confuse. exam_style: exam questions with model answers.

Queued202 and a job id, straight away
ProcessingPoll, stream or wait for a webhook
SucceededResult and files on the job

Every AI request runs as a background job, so nothing times out.

Cards are grounded in your text or document; a topic uses accurate, mainstream knowledge. Each card has a front, back, optional hint and a short topic tag. A finished job also has flashcards.csv, which Anki imports directly (File > Import). Maths is written as LaTeX inside .

Requires learning:write. Costs 1 credit per set. Send a unique Idempotency-Key; reuse it with the identical body when retrying. Returns 202 with a job: poll GET /jobs/{job_id}, stream GET /jobs/{job_id}/events, or use a signed webhook.

Flashcards

POST/v1/flashcards

Scope learning:write

Headers

Flashcards: headers
Field	Details
`Idempotency-Key`	stringRequiredA unique key per new operation; reuse it with the identical body when retrying.
`EduMark-Version`	enumAPI version. Defaults to the latest.One of `2026-10-21`

Request body

Flashcards: request body
Field	Details
`topic`	string, optionalA subject to study from general knowledge, for example "Photosynthesis for GCSE Biology".Up to 200 characters
`source_text`	string, optionalYour own teaching text (at least 200 characters, at most 10,000 words). Material stays grounded in it.Up to 120,000 characters
`document`	FileReference or DocumentInput, optionalA PDF, DOCX or TXT to study from: `{"file_id"}` from POST /v1/files, or inline base64.
`file_id`document.file_id	stringRequiredThe id returned by POST /v1/files, after POST /v1/files/{id}/complete reported ready.When sending FileReferencePattern `^file_[a-f0-9]{32}$`
`filename`document.filename	stringRequiredWhen sending DocumentInputUp to 200 characters
`base64`document.base64	stringRequiredWhen sending DocumentInputUp to 27,962,028 characters
`mime_type`document.mime_type	string, optionalWhen sending DocumentInputUp to 150 characters
`title`	string, optionalA name for your text or document, such as the lesson or chapter title.Up to 200 characters
`focus`	stringConcepts to concentrate on, in plain words.Up to 500 charactersDefault `""`
`level`	enum, optionalHow to pitch the material. Leave it out for upper-secondary to first-year university level.One of `new_to_this`, `foundation`, `intermediate`, `advanced`, `exam_revision`, `deep_dive`
`audience`	string, optionalWho the material is for, for example "Year 10 learners who find maths hard".Up to 200 characters
`language`	enumThe language to write in. British English unless you choose another.One of `English`, `Welsh`, `Irish`, `Gaelic`, `French`, `Spanish`, `German`, `Italian`, `Portuguese`, `Dutch`, `Polish`, `Arabic`, `Urdu`, `Hindi`, `Punjabi`, `Bengali`, `Chinese`, `Mandarin`, `Cantonese`, `Japanese`, `Korean`, `Russian`, `Turkish`, `Greek`, `Swedish`, `Norwegian`, `Danish`, `Finnish`, `Romanian`, `Hungarian`, `Czech`, `Ukrainian`, `Farsi`, `Persian`, `Hebrew`, `Swahili`, `Somali`, `Tamil`, `Gujarati`, `Vietnamese`, `Thai`, `Indonesian`, `Malay`, `Tagalog`, `Latin`Default `"English"`
`count`	integerHow many cards to make (5 to 30). Fewer come back only when the source honestly supports fewer.5 to 30Default `15`
`style`	enumquick_recall: one crisp fact per card. definitions: term and definition. key_concepts: core ideas explained briefly. difficult_concepts: the ideas learners most often confuse. exam_style: exam questions with model answers.One of `quick_recall`, `definitions`, `key_concepts`, `difficult_concepts`, `exam_style`Default `"key_concepts"`

Responses

Status	Meaning
202	Successful Response
400	Request rejected. Inspect error.code and request_id; failed work is not billed.
401	Request rejected. Inspect error.code and request_id; failed work is not billed.
402	Request rejected. Inspect error.code and request_id; failed work is not billed.
403	Request rejected. Inspect error.code and request_id; failed work is not billed.
404	Request rejected. Inspect error.code and request_id; failed work is not billed.
409	Request rejected. Inspect error.code and request_id; failed work is not billed.
410	Request rejected. Inspect error.code and request_id; failed work is not billed.
413	Request rejected. Inspect error.code and request_id; failed work is not billed.
415	Request rejected. Inspect error.code and request_id; failed work is not billed.
422	Validation Error
429	Request rejected. Inspect error.code and request_id; failed work is not billed.
503	Request rejected. Inspect error.code and request_id; failed work is not billed.

Request

curl -X POST 'https://api.edumark.ai/v1/flashcards' \
  -H "Authorization: Bearer $EDUMARK_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "topic": "Photosynthesis for GCSE Biology",
  "count": 10,
  "style": "key_concepts"
}'

# Then poll until the job finishes (wait poll_after_seconds between calls)
curl 'https://api.edumark.ai/v1/jobs/job_01JB7Q8M4X2V9R' \
  -H "Authorization: Bearer $EDUMARK_API_KEY"

Queued202 and a job id, straight away
ProcessingPoll, stream or wait for a webhook
SucceededResult and files on the job

Every AI request runs as a background job, so nothing times out.

Response 202JSON

{
  "id": "job_0123456789abcdef0123456789abcdef01234567",
  "product": "flashcards",
  "status": "queued",
  "poll_after_seconds": 2,
  "credits": 1,
  "result_available": false
}

Finished job: resultJSON

{
  "status": "completed",
  "title": "Photosynthesis for GCSE Biology",
  "style": "key_concepts",
  "card_count": 6,
  "cards": [
    {
      "id": "c1",
      "front": "What does photosynthesis make?",
      "back": "Glucose and oxygen, from carbon dioxide and water, using light energy.",
      "hint": "Think of the two products.",
      "tag": "Products"
    },
    {
      "id": "c2",
      "front": "Where in a plant cell does photosynthesis happen?",
      "back": "In the chloroplasts, which contain the green pigment chlorophyll.",
      "hint": "A green organelle.",
      "tag": "Cell structure"
    },
    {
      "id": "c3",
      "front": "What is the job of chlorophyll?",
      "back": "It absorbs light energy, mostly red and blue light, to drive photosynthesis.",
      "hint": "",
      "tag": "Chlorophyll"
    },
    {
      "id": "c4",
      "front": "Give the word equation for photosynthesis.",
      "back": "Carbon dioxide + water → glucose + oxygen (in the presence of light).",
      "hint": "Reactants on the left.",
      "tag": "Equation"
    },
    {
      "id": "c5",
      "front": "Name one factor that limits the rate of photosynthesis.",
      "back": "Light intensity, carbon dioxide concentration or temperature.",
      "hint": "",
      "tag": "Limiting factors"
    },
    {
      "id": "c6",
      "front": "Why does photosynthesis slow down at high temperatures?",
      "back": "The enzymes involved start to denature, so the reactions slow.",
      "hint": "Enzymes have an ideal temperature.",
      "tag": "Limiting factors"
    }
  ],
  "language": "English",
  "source": {
    "kind": "topic",
    "title": "Photosynthesis for GCSE Biology",
    "truncated": false
  },
  "warnings": [],
  "provenance": {
    "engine": "edumark_study",
    "sandbox": true
  }
}

Files and errors

Files on the finished job

flashcards.csvAnki-compatible CSV: Front, Back, Tags.

Download with GET /v1/jobs/{id}/files/{name}.

Product errors

SOURCE_REQUIREDHTTP 422. Provide exactly one of topic, source_text or document.
SOURCE_TOO_SHORTHTTP 422. source_text needs at least 200 characters to study from.
INPUT_TOO_LARGEHTTP 422. source_text supports at most 10,000 words.
MODEL_RESULT_INVALIDOn the finished job. The generated material did not pass EduMark's checks. No charge was applied.
PROCESSING_UNAVAILABLEOn the finished job. Processing could not complete safely. No complete result was issued.
DOCUMENT_READ_FAILEDOn the finished job. The document could not be read safely.