{"openapi":"3.1.0","info":{"title":"CNA Practice Questions API","version":"1.0.0","description":"Free CNA practice questions with every answer explained. Take a free CNA practice test, a timed CNA practice exam and step-by-step CNA skills test checklists."},"servers":[{"url":"https://cnapracticequestions.com"}],"security":[{"bearer":[]}],"paths":{"/api/v1/attempts":{"get":{"summary":"List Practice attempts","description":"One finished practice quiz or mock written exam, with its score, so you can see how your studying is going.","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","maximum":200}},{"name":"offset","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"401":{"description":"Invalid key"},"429":{"description":"Rate or quota limit"}}},"post":{"summary":"Create a Practice attempt","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Practiceattempt"}}}},"responses":{"201":{"description":"Created"},"402":{"description":"Record limit"},"422":{"description":"Invalid"}}}},"/api/v1/attempts/{id}":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"get":{"summary":"Read a Practice attempt","responses":{"200":{"description":"OK"},"404":{"description":"Not found"}}},"patch":{"summary":"Update a Practice attempt","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Practiceattempt"}}}},"responses":{"200":{"description":"OK"},"404":{"description":"Not found"}}},"delete":{"summary":"Delete a Practice attempt","responses":{"204":{"description":"Deleted"},"404":{"description":"Not found"}}}},"/api/v1/onboarding":{"get":{"summary":"Onboarding questions","description":"The questions that finish setting up an account. No key needed; with a key the reply also carries the current answers. Costs no quota.","security":[],"responses":{"200":{"description":"OK"}}},"post":{"summary":"Answer onboarding for your user","description":"Stores the answers exactly as the onboarding form does, marked as answered by an agent. Idempotent. Costs no quota.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["answers"],"properties":{"answers":{"type":"object","properties":{"exam_timing":{"type":"string","enum":["Within 2 weeks","2 to 6 weeks","More than 6 weeks","Not scheduled yet"],"description":"When is your CNA exam?"},"state":{"type":"string","description":"Which state are you testing in?"},"focus":{"type":"string","enum":["Written exam","Skills test","Both"],"description":"What do you want to work on most?"}},"required":["exam_timing","state","focus"]},"client":{"type":"string","description":"Your name, such as Claude Code."}}}}}},"responses":{"200":{"description":"Saved"},"401":{"description":"Invalid key"},"422":{"description":"Invalid answers"},"429":{"description":"Too many answers this minute"}}}}},"components":{"schemas":{"Practiceattempt":{"type":"object","additionalProperties":false,"required":["quiz","mode","correct","total"],"properties":{"quiz":{"type":"string","description":"Which quiz or mock exam this attempt was"},"mode":{"type":"string","enum":["topic_quiz","mock_exam","missed_review","skills_review"],"description":"What kind of practice it was"},"correct":{"type":"number","description":"Questions answered correctly"},"total":{"type":"number","description":"Questions in the attempt"},"minutes":{"type":"number","description":"Minutes spent"},"topic":{"type":"string","description":"Topic slug for a topic quiz"},"missed":{"type":"string","description":"Comma-separated ids of questions answered wrong"},"answered":{"type":"string","description":"Comma-separated ids of every question answered in this attempt"}}}},"securitySchemes":{"bearer":{"type":"http","scheme":"bearer"}}}}