Education Qualification

Field descriptions

Copy
{
  "id": { "type": "string" }, // (Required) Unique identifier for the data
  "document_type": { "type": "string" }, // (Required) Must be one of "pdf", "open_cert", or "none"
  "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
          }
        ]
      },
      "partner_chain": { "type": ["array", "null"] } // (Optional unless otherwise specified) Array of objects to specifiy partner institutions, e.g. [{ "name": "Partner Organization" }]
    },
    "document": { "type": "string" }, // (Optional) Depending on the supplied document_type, either a URL pointing to a PDF document, the content of an OpenCert document, or null if not applicable.
  }
}

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)

3. Partner chain

With the partner_chain field, partners can specify partner institutions associated with the credential. This is particularly useful for qualifications awarded through collaborations between multiple institutions.

Example

• partner_chain: [{ "name": "Partner University" }]

Sample payloads

Sample OpenCerts: Bachelor of Commerce (Economics and Finance) (Honours)

Copy
{
  "id": "fa651300-b91a-49cb-8ee7-cac68b3fdf74",
  "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": "{\"version\":\"https://schema.openattestation.com/2.0/schema.json\",\"schema\":\"https://raw.githubusercontent.com/OpenCerts/open-certificate/master/schema/transcripts/2.0/schema.json\"}"
  }
}

Sample PDF certificate

Copy
{
  "id": "fa651300-b91a-49cb-8ee7-cac68b3fdf74",
  "document_type": "pdf",
  "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": "https://example.com/certificate.pdf"
  }
}

Awaiting graduation example

Copy
{
  "id": "fa651300-b91a-49cb-8ee7-cac68b3fdf74",
  "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
  }
}

Sample with partner_chain

Copy
{
  "id": "fa651300-b91a-49cb-8ee7-cac68b3fdf74",
  "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,
      "partner_chain": [
        { "name": "Partner University" }
      ]
    },
    "document": "{\"version\":\"https://schema.openattestation.com/2.0/schema.json\",\"schema\":\"https://raw.githubusercontent.com/OpenCerts/open-certificate/master/schema/transcripts/2.0/schema.json\"}"
  }
}