Education Qualification

Field descriptions

Copy
{
  "id": { "type": "string" }, // (Required) Unique identifier for the data
  "document_type": { "type": "string" }, // (Required) Must be "open_cert"
  "credential_type": { "type": "string" }, // (Required) Must be "education"
  "data": { // { "type": "object" }, (Required)
    "credential": { // { "type": "object" }, (Required)
      "full_name": { "type": "string" }, // (Required)
      "education_provider": { "type": "string" }, // (Required)
      "course_name": { "type": "string" }, // (Required)
      "conferral_year": { "type": ["string", "null"] }, // (Required unless awaiting_graduation) Year: YYYY or null if awaiting graduation
      "awaiting_graduation": { "type": "boolean" }, // (Optional)
      "has_majors": { "type": "boolean" }, // (Optional)
      "majors": { "type": "array", "items": { "type": "string" } }, // (Optional)
      "with_honours": { "type": "boolean" }, // (Optional)
      "transcript": { // { "type": "object" }, // (Optional)
        "overall": { // { "type": "object" }, (Required)
          "issuance_date": { "type": "string" }, // (Required) Date format: "YYYY-MM-DD"
          "score": { "type": "string" }, // (Optional)
        },
        "subjects": [ // { "type": "array" }, (Required)
          {
            "name": { "type": "string" }, // (Required)
            "code": { "type": "string" }, // (Required)
            "credit": { "type": "string" }, // (Optional)
            "score": { "type": "string" }, // (Optional)
            "grade": { "type": "string" }, // (Required), e.g. "A+ or High Distinction or Pass"
            "completion_date": { "type": "string" }, // (Required) Year or ISO date
          }
        ]
      }
    },
    "document": { "type": "string" }, // (Required) Certificate data
  }
}

Leveraging education fields

1. Constructing a correct qualification

There are a number of key value pairs which combine to form a Qualification field. This field is shown as the title of the credential on SEEK Pass and SEEK (e.g. on SEEK Profile). This is the most prominent field seen by candidates and hirers using our products so having a clear and representative field is highly impactful. This field is also consumed by internal SEEK teams to map constructs within our systems.

The following fields are required to construct a correct Qualification field:

• course_name
• majors
• with_honours

Given this, there are preferred ways to leverage these fields:

1. Fully write out the course_name (e.g. "Bachelor of Commerce" or "Bachelor of Science" is preferred, avoid "BCom" or "BSc").
2. Use correct spelling within course_name (e.g. "Master of..." and not "Masters of...").
3. Use standard conjunctions within course_name (e.g. "Master of..." instead of "Master in").
4. Leverage the majors fields where applicable. Do not also include majors in the course name.
5. Leverage the with_honours field where applicable. Do not also include honours in course_name.

Example 1

• course_name: "Bachelor of Commerce"
• majors: ["Economics", "Finance"]
• with_honours: true
• Qualification: Bachelor of Commerce (Economics and Finance) (Honours)

Example 2

• course_name: "Bachelor of Commerce"
• majors: ["Finance"]
• with_honours: false
• Qualification: Bachelor of Commerce (Finance)

2. Awaiting graduation qualifications

Education Qualifications that have been completed but not yet conferred due to a pending graduation ceremony can still be submitted via Add to SEEK Pass.

The field requirements are as follows:

• conferral_year set to null
• awaiting_graduation set to true

The document_type field may also be set to none if there isn't relevant supporting documentation to indicate that an Education Qualification has been completed by not yet conferred.

Example

• course_name: "Bachelor of Commerce"
• majors: ["Finance"]
• conferral_year: null
• awaiting_graduation: true
• Qualification: Bachelor of Commerce (Finance) (Awaiting Graduation)

Sample payload

Bachelor of Commerce (Economics and Finance) (Honours)

Copy
{
  "id": "1",
  "document_type": "open_cert",
  "credential_type": "education",
  "data": {
    "credential": {
      "full_name": "John Doe",
      "education_provider": "National University of Singapore",
      "course_name": "Bachelor of Commerce",
      "conferral_year": "2024",
      "has_majors": true,
      "majors": ["Economics", "Finance"],
      "with_honours": true,
      "transcript": {
        "overall": {
          "issuance_date": "2022",
          "score": "4.5"
        },
        "subjects": [
          {
            "name": "Introductory Microeconomics",
            "code": "ECON10001",
            "credit": "4",
            "score": "4.5",
            "grade": "A+",
            "completion_date": "2020"
          },
          {
            "name": "Introductory Macroeconomics",
            "code": "ECON10002",
            "credit": "4",
            "score": "3.5",
            "grade": "A",
            "completion_date": "2021"
          }
        ]
      }
    },
    "document": "Placeholder for document data."
  }
}

Awaiting graduation example

Copy
{
  "id": "1",
  "document_type": "none",
  "credential_type": "education",
  "data": {
    "credential": {
      "full_name": "John Doe",
      "education_provider": "National University of Singapore",
      "course_name": "Bachelor of Commerce",
      "conferral_year": null,
      "awaiting_graduation": true,
      "has_majors": true,
      "majors": ["Economics", "Finance"]
    },
    "document": null
  }
}