POST
/
v1
/
toefl
/
evaluation
curl --request POST \
  --url https://api-staging.crazygoldfish.com/v1/toefl/evaluation \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'accept: <accept>' \
  --data '{
  "client_id": "1",
  "institution_id": "inst_456",
  "teacher_id": "",
  "parent_id": "",
  "student_id": "123",
  "exam_type": "IB",
  "student_name": "Jhon Doe",
  "image_urls": [
    "http://example.com/image1.jpg",
    "http://example.com/image2.jpg"
  ],
  "evaluation_text": [
    {
      "question_id": "q1",
      "question_number": "1",
      "question_section": "writing",
      "question_type": "TF-ES-W-02",
      "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": "",
      "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."
    }
  ]
}'
{
  "status_code": "200",
  "status": "Processing",
  "message": "Evaluation request submitted successfully",
  "data": [
    {
      "evaluation_id": "bbb264b6-4780-4095-a973-25daa5e8545f"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
accept
enum<string>
default:application/json
required
Available options:
application/json

Body

application/json
​
client_id
string
required

Unique identifier assigned to the client accessing the API.

Example:

"1"

​
student_id
string
required

Identifies the specific student for whom the evaluation is being requested.

Example:

"123"

​
exam_type
enum<string>
required

Type of TOEFL exam (essentials, ibt).

Available options:
ES,
IB
Example:

"IB"

​
student_name
string
required

Name of the student for whom the evaluation is being requested.

Example:

"Jhon Doe"

​
evaluation_text
object[]
required

List of evaluation questions and answers.

​
institution_id
string

Unique identifier of the institution (optional).

Example:

"inst_456"

​
teacher_id
string

Identifier of the teacher (optional).

Example:

""

​
parent_id
string

Unique identifier of the parent associated with the student (optional).

Example:

""

​
image_urls
string[]

List of URLs pointing to the images of the evaluated work (optional).

Example:
[
  "http://example.com/image1.jpg",
  "http://example.com/image2.jpg"
]

Response

200
application/json
Evaluation request submitted successfully
​
status_code
string
Example:

"200"

​
status
string
Example:

"Processing"

​
message
string
Example:

"Evaluation request submitted successfully"

​
data
object[]