{"openapi":"3.1.0","info":{"title":"NCLEX RN Practice Questions API","version":"1.0.0","description":"Free NCLEX RN practice questions with a rationale for every answer. Take a free NCLEX practice test, try every NGN item type and see what to study next."},"servers":[{"url":"https://nclexrnpracticequestions.com"}],"security":[{"bearer":[]}],"paths":{"/api/v1/attempts":{"get":{"summary":"List Practice attempts","description":"One finished practice session, quiz or mock test, with its score and the client-needs category it covered.","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 NCLEX-RN?"},"attempt":{"type":"string","enum":["First attempt","Retaking"],"description":"Is this your first attempt?"},"weak_area":{"type":"string","enum":["Pharmacology","Management of care","Safety and infection control","Physiological adaptation","Risk reduction","Psychosocial","Not sure yet"],"description":"Which area feels weakest right now?"},"focus":{"type":"string","description":"Anything specific you want to practice?"}},"required":["exam_timing","attempt","weak_area"]},"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":["label","mode","items","score_pct"],"properties":{"label":{"type":"string","description":"What this attempt was"},"mode":{"type":"string","enum":["practice","mock","review","daily"],"description":"Which kind of session produced the attempt"},"category":{"type":"string","description":"Client-needs category slug"},"items":{"type":"number","description":"Number of items answered"},"score_pct":{"type":"number","description":"Points earned as a percent of points possible"},"minutes":{"type":"number","description":"Time spent in minutes"}}}},"securitySchemes":{"bearer":{"type":"http","scheme":"bearer"}}}}