Skip to main content
Our API enables you to assess both questions and answers according to TOEFL examination standards. Whether for Essentials or IBT, this API allows you to submit questions and answers in various multimedia formats, providing scores, feedback, improvement suggestions, and objective error detection.
Customize the evaluation with your own rubrics for tailored assessments.

TOEFL

Evaluation API

​
Question Types:

Assessment Type CodeDescription
TF-ES-W-01TOEFL Essentials Writing: Build a Sentence
TF-ES-W-02TOEFL Essentials Writing: Email Brief
TF-ES-W-03TOEFL Essentials Writing: Email Detailed
TF-ES-W-04TOEFL Essentials Writing: Describe a Photo
TF-ES-W-05TOEFL Essentials Writing: Academic Discussion
TF-IB-W-01TOEFL IBT Writing: Integrated Writing
TF-IB-W-02TOEFL IBT Writing: Academic Discussion
Currently, this API is available exclusively for evaluating Writing Skills for TOEFL Essentials and IBT.

​
Key Features

  • Automated Grading : Efficiently grade TOEFL writing tasks with high accuracy.
  • Detailed Feedback : Receive comprehensive feedback, including suggestions for improvement and objective error detection.
  • Customization : Customize the evaluation with your own rubrics.
  • Multimedia Support : Submit questions and answers in text, audio, image, and video formats.
  • Scalability : Handle large volumes of evaluations during peak times without compromising speed or accuracy.
  • Integration : Seamlessly integrate with other educational tools and platforms to create a cohesive evaluation ecosystem.

​
Endpoints

1

Submit Evaluation Request

Submit a request for evaluation directly by providing questions and respective answers in a json format. The API generates an evaluation report based on the provided data, and returns an acknowledgment along with an evaluation ID.
POST /v1/toefl/evaluation
2

Get Specific Evaluation Report

Retrieve a specific evaluation report using its unique identifier (ID). Clients can access past evaluations or reference specific reports by providing the evaluation ID.
GET /v1/toefl/evaluation
3

Get All Evaluation Reports

Retrieve all the evaluation report or for a specific set of handwritten notes. Clients can provide parameters such as student name, class, subject, and date of evaluation to filter the results.
GET /v1/toefl/evaluation/{id}

​
Sample Request

curl --location 'https://api-staging.crazygoldfish.com/v1/toefl/evaluation' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VybmFtZSI6ImhhcnNoaXQiLCJ1c2VyX2lkIjoxLCJ1c2VyX3JvbGUiOiJUZWFjaGVyIiwiaXNfYWN0aXZlIjp0cnVlLCJjbGllbnRfaWQiOjEsImV4cCI6MTczMjAwOTczNn0.y0Qp9K5YLx01X0YWW3oDQWwyir4f5rgL-LKSh0cJKPM' \
--header 'Content-Type: application/json' \
--data '{
  "client_id": "1",
  "institution_id": "inst_456",
  "teacher_id": "string",
  "parent_id": "string",
  "student_id": "123",
  "exam_type": "IS",
  "student_name": "crazygoldfish",
  "image_urls": [
    "string"
  ],
  "evaluation_text": [
    {
      "question_text": "Write your personal opinion on the academic topic. answer the question based on the discussion.Minimum of 100 words \n Academic Discussion Professor John: Many universities offer online courses as an alternative to traditional classroom-based learning. Do you think online courses provide the same quality of education as traditional classroom-based learning? Why or why not? Use examples and details in your response.Jason: I believe online courses can provide a similar quality of education as traditional classroom-based learning. With advanced technology and interactive platforms, students can access high-quality lectures, engage in virtual discussions, and submit assignments online, often at their own pace and convenience. So, personally, I think that online courses provide the same quality of education as traditional classroom-based learning while being more accessible. \n Anna: In my opinion, online courses offer convenience and flexibility, but they often fall short of delivering the same quality of education as traditional classroom-based learning. In a traditional classroom setting, students can actively engage in discussions, ask questions, and receive immediate feedback from professors, which facilitates deeper understanding and retention of the material. While online courses offer certain advantages, such as accessibility, they often lack the personalized attention and immersive learning experience provided by traditional classroom-based learning.",
      "question_multimedia_url": "string",
      "answer_text": "In fact, online courses could provide the same quality of education similar to the one a student will experience in a classroom.But it all depends on how they are designed and delivered. eg universities employing advanced technology with interactive platforms are able to offer quality lectures, virtual discussions, and online assignments. These ingredients allow learning at a self-determined pace which is essential for people who have other commitments, such as work or family. Moreover, the flexibility and accessibilities of online courses could let more types of students be involved in the learning process, enriching it for everyone. For example, suppose some student lives in a remote area and is unable to commute to any university. With the help of online courses, he or she can obtain top-class education. At the same time, it is also necessary to be aware of the negative side, like the impossibility of immediate feedback and interaction with professors and peers, which is more available in a traditional class.",
      "question_type": "TF-IB-W-02",
      "question_section": "writing",
      "question_number": "2",
      "question_id": "2"
    }
  ]
}'

​
FAQ

The TOEFL Evaluation API scores responses against TOEFL standards and supports multimodal evaluation across text, handwriting, audio, and video. It returns scores, granular feedback, and objective error detection so your program gets consistent, standards-aligned results.
Each evaluation returns structured scores with granular feedback and objective error flags aligned to the task rubric. Outputs are designed to slot into reporting and analytics pipelines, with JSON-friendly fields and dashboards supported across the ecosystem.
The API supports custom rubrics in addition to TOEFL standards so you can tailor evaluation to your program. This lets you keep standardized banding while adding institution-specific criteria where needed.
You can add an optional human-in-the-loop review step so educators approve or adjust provisional scores before publishing. This safeguard preserves the targeted 95% accuracy in high-stakes contexts without slowing routine operations.
You can integrate via API or use a white-label Embeddable UI delivered as a secure link or iframe. Most teams achieve a 24h integration with no AI team required by embedding the UI for instant, rubric-based feedback, then expanding to APIs as needed.
Start with TOEFL multimodal evaluation, then feed results into personalized plans and curriculum-aligned content generation. The cohesive Evaluate → Personalize → Generate → Observe loop compounds learning outcomes and operational efficiency over time.
TOEFL evaluation is multimodal: typed text, handwriting, audio, and video are all supported. Mixed-media submissions are handled under the same rubric so learners can practice in realistic formats.
Governance, reports, and dashboards are designed to be CBSE/ICSE/GDPR aligned so they fit district and enterprise standards. Transparent, auditable records support rechecks and institutional reporting requirements.
TOEFL evaluations target 95% accuracy, combining rubric-driven scoring with objective error detection. The human-in-the-loop option helps maintain fairness and trust as volumes scale.
Integration is designed for speed and practicality—embed the white-label UI or call the APIs to enforce uniform evaluations across tenants. Because setup requires no AI team and aligns with CBSE/ICSE/GDPR practices, multi-tenant rollouts scale with consistent scoring and auditability.