The SEEK Pass API v1 is deprecated. Partners are required to migrate existing integrations to API v2, and new integrations must use v2. The migration deadline is TBA.
Review the v2 OpenAPI specification and the sample request payloads on each credential page, then update your endpoint URLs and request bodies. The v1 OpenAPI specification remains available for reference while you plan and validate the migration.
Education is used as the example throughout this page. Each credential type has its own payload and fields, so refer to the Credential types section of the documentation for the credential you are migrating.
Endpoint URLs
Replace /api/partner/v1 with /api/partner/v2. Create and status paths also change shape. Other credential types use the same URL pattern with their own path segment, such as english_proficiency or microcredential.
Action
API v1
API v2
OAuth token
POST /api/partner/v1/oauth/token.json
POST /api/partner/v2/oauth/token.json
Revoke OAuth token
POST /api/partner/v1/oauth/token/revoke.json
POST /api/partner/v2/oauth/token/revoke.json
Create an Education request
POST /api/partner/v1/add/education.json
POST /api/partner/v2/add/requests/education.json
Create a batch
POST /api/partner/v1/add/batch.json
POST /api/partner/v1/add/batch/microcredential.json
POST /api/partner/v2/add/requests/batch.json
Submission status
GET /api/partner/v1/submissions/$ID/status.json
GET /api/partner/v2/add/requests/$CREDENTIAL_ID
Multiple submission statuses
POST /api/partner/v1/submissions/status.json
GET /api/partner/v2/add/requests?credential_id[]=...
OAuth request fields (grant_type, client_id, client_secret, and scope) are unchanged. Bulk status is now a GET with repeated credential_id[] query parameters, instead of a POST body containing ids.
Batch does not follow the same URL pattern. API v1 had POST /api/partner/v1/add/batch.json and POST /api/partner/v1/add/batch/microcredential.json. API v2 has one batch endpoint, POST /api/partner/v2/add/requests/batch.json. Learning and Development credentials in that request are microcredential_items.
Credential payloads
The same Education qualification is shown in both versions. Field names inside the qualification, such as course_name and conferral_year, stay the same. What changes is where those fields sit, and how the document is attached. See Education for the full v2 schema.
id becomes credential_id. Status responses use credential_id as well.
credential_type is removed from the body. The credential type is part of the URL.
data.credential becomes fields.
document_type and data.document become an assets item with asset_id, asset_type, and asset_data. For an OpenCert, asset_type is open_cert and asset_data is the OpenCert content. For a PDF URL, asset_type is pdf and asset_data is the URL.
When v1 used document_type of none, omit assets.
A successful create response still includes redirect_uri and also includes asset_uploads. That array is empty when asset_data was sent inline.