Fetch one of your students’ applications

Body

Headers

X-RateLimit-Limit integer

Requests your account may make to this operation per window (100).

X-RateLimit-Remaining integer

Requests left in the current window.

X-RateLimit-Reset integer

Seconds until the current window ends.

{
  "success": true,
  "message": "Application fetched successfully.",
  "data": {
    "_id": "6650a1b2c3d4e5f6a7b8c9e5",
    "exam": {
      "_id": "6650a1b2c3d4e5f6a7b8c9e1",
      "session": "6650a1b2c3d4e5f6a7b8c9e2",
      "category": "6650a1b2c3d4e5f6a7b8c9e3",
      "language": "6650a1b2c3d4e5f6a7b8c9e4",
      "grades": [
        "6650a1b2c3d4e5f6a7b8c9d4"
      ],
      "countries": [],
      "examType": "standard",
      "examTime": 75,
      "duration": 15,
      "questionCount": 30,
      "price": 25,
      "preventApplication": false,
      "createdAt": "2026-09-01T09:30:00.000Z",
      "updatedAt": "2026-09-02T14:05:00.000Z"
    },
    "user": {
      "_id": "6650a1b2c3d4e5f6a7b8c9e9",
      "mainId": "6650a1b2c3d4e5f6a7b8c9d0",
      "firstName": "Jane",
      "lastName": "Doe"
    },
    "payment": {
      "_id": "6650a1b2c3d4e5f6a7b8c9e6",
      "status": "pending",
      "amount": 25,
      "application": "6650a1b2c3d4e5f6a7b8c9e5",
      "exam": "6650a1b2c3d4e5f6a7b8c9e1",
      "for": "6650a1b2c3d4e5f6a7b8c9e9",
      "createdAt": "2026-09-01T09:30:00.000Z",
      "updatedAt": "2026-09-02T14:05:00.000Z"
    },
    "partners": [
      {
        "user": "6650a1b2c3d4e5f6a7b8c9d6",
        "accepted": true
      }
    ],
    "participated": false,
    "examStart": "2026-11-14T10:04:12.000Z",
    "examSubmitted": false,
    "submitDate": "2026-11-14T11:12:40.000Z",
    "simulationStarted": false,
    "simulationStart": "2026-11-07T10:00:00.000Z",
    "simulationSubmitted": false,
    "removeAfter": "2026-09-02T14:05:00.000Z",
    "uuid": "a3f-09c-7e1",
    "createdAt": "2026-09-01T09:30:00.000Z",
    "updatedAt": "2026-09-02T14:05:00.000Z"
  }
}

When

• bad_request

  applicationId is not 24 hexadecimal digits.

{
  "error": {
    "code": "bad_request",
    "documentation_url": "https://hub.main-team.org/api/errors#bad_request",
    "message": "Invalid value for '_id': expected ObjectId.",
    "request_id": "0b5c6d0e-8f7a-4b1c-9d2e-3f4a5b6c7d8e"
  }
}

When

• unauthorized

  The token is missing or malformed, is not signed with your account’s apiSecret, breaks the iat and exp rules, has expired or been revoked, or its account is not active. All of these answer the same.

{
  "error": {
    "code": "unauthorized",
    "documentation_url": "https://hub.main-team.org/api/errors#unauthorized",
    "message": "Authentication is required or the provided credentials are invalid.",
    "request_id": "0b5c6d0e-8f7a-4b1c-9d2e-3f4a5b6c7d8e"
  }
}

When

• forbidden

  The token is valid, but no role on your account allows application/read on the organization in the path, or a role denies it.

{
  "error": {
    "code": "forbidden",
    "documentation_url": "https://hub.main-team.org/api/errors#forbidden",
    "message": "Insufficient role permissions",
    "request_id": "0b5c6d0e-8f7a-4b1c-9d2e-3f4a5b6c7d8e"
  }
}

When

• not_found

  organizationId is not the _id of an organization.

• not_found

  No application of your students has this id: it matches nothing, or the application belongs to another account’s student. Both get the same answer.

{
  "error": {
    "code": "not_found",
    "documentation_url": "https://hub.main-team.org/api/errors#not_found",
    "message": "Organization not found!",
    "request_id": "0b5c6d0e-8f7a-4b1c-9d2e-3f4a5b6c7d8e"
  }
}

When

• too_many_requests

  Your account has made more than 100 requests to this operation in the current 60-second window. Wait the seconds in Retry-After before sending again.

Headers

Retry-After integer

Seconds to wait before sending again; a request sent sooner is refused too.

{
  "error": {
    "code": "too_many_requests",
    "documentation_url": "https://hub.main-team.org/api/errors#too_many_requests",
    "message": "Too many requests to this operation. Wait the number of seconds in Retry-After, then try again.",
    "request_id": "0b5c6d0e-8f7a-4b1c-9d2e-3f4a5b6c7d8e"
  }
}

When

• internal_error

  Something failed on our side. Retry later, and quote request_id if it goes on.

{
  "error": {
    "code": "internal_error",
    "documentation_url": "https://hub.main-team.org/api/errors#internal_error",
    "message": "An unexpected error occurred.",
    "request_id": "0b5c6d0e-8f7a-4b1c-9d2e-3f4a5b6c7d8e"
  }
}