Skip to main content

Lead provider API - 2.0.0

The lead provider API for DfE’s manage teacher CPD service

Base URLs

GET /api/v2/participant-declarations

List all participant declarations

Parameters

Parameter In Type Required Description Example
filter query object false

Refine participant declarations to return.

This consumes a ListFilterDeclarations schema.

participant_id=ab3a7848-1208-7679-942a-b4a70eed400a&updated_since=2020-11-13T11:21:55Z
page query object false

Pagination options to navigate through the list of participant declarations.

This consumes a Pagination schema.

page[page]=1&page[per_page]=5

Responses

Status Description
200

A list of participant declarations

This response returns a MultipleParticipantDeclarationsResponse schema.

401

Unauthorized

This response returns a UnauthorisedResponse schema.

Response examples

200 - A list of participant declarations

This response returns a MultipleParticipantDeclarationsResponse schema.

{
  "data": [
    {
      "id": "01017c12-354b-4b2d-b621-3531ab729c43",
      "type": "participant-declaration",
      "attributes": {
        "participant_id": "db3a7848-7308-4879-942a-c4a70ced400a",
        "declaration_type": "started",
        "declaration_date": "2021-05-31T02:21:32.000Z",
        "course_identifier": "ecf-mentor"
      }
    },
    {
      "id": "bb36d74a-68a7-47b6-86b6-1fd0d141c590",
      "type": "participant-declaration",
      "attributes": {
        "participant_id": "ab3a7848-7308-4879-942a-c4a70ced400a",
        "declaration_type": "started",
        "declaration_date": "2021-05-31T02:21:32.000Z",
        "course_identifier": "ecf-mentor"
      }
    }
  ]
}
401 - Unauthorized

This response returns a UnauthorisedResponse schema.

{
  "error": "HTTP Token: Access denied"
}

POST /api/v2/participant-declarations

Declare a participant has reached a milestone. Idempotent endpoint - submitting exact copy of a request will return the same response body as submitting it the first time.

Request body

This consumes a ParticipantDeclarationRequest schema.

Responses

Status Description
200

Successful

This response returns a SingleParticipantDeclarationResponse schema.

422

Bad or Missing parameter

This response returns a ErrorResponse schema.

401

Unauthorized

This response returns a UnauthorisedResponse schema.

400

Bad Request

This response returns a BadRequestResponse schema.

Response examples

200 - Successful

This response returns a SingleParticipantDeclarationResponse schema.

{
  "data": {
    "id": "cd3a12347-7308-4879-942a-c4a70ced400a",
    "type": "participant-declaration",
    "attributes": {
      "participant_id": "db3a7848-7308-4879-942a-c4a70ced400a",
      "declaration_type": "started",
      "declaration_date": "2021-05-31T02:21:32.000Z",
      "course_identifier": "ecf-induction",
      "state": "submitted",
      "updated_at": "2021-05-31T02:22:32.000Z",
      "has_passed": true
    }
  }
}
422 - Bad or Missing parameter

This response returns a ErrorResponse schema.

{
  "error": [
    {
      "title": "string",
      "detail": "string"
    }
  ]
}
401 - Unauthorized

This response returns a UnauthorisedResponse schema.

{
  "error": "HTTP Token: Access denied"
}
400 - Bad Request

This response returns a BadRequestResponse schema.

{
  "bad_request": "string"
}

GET /api/v2/participant-declarations.csv

Retrieve all participant declarations in CSV format

Responses

Status Description
200

A CSV file of participant declarations

This response returns a MultipleParticipantDeclarationsCsvResponse schema.

401

Unauthorized

This response returns a UnauthorisedResponse schema.

Response examples

200 - A CSV file of participant declarations

This response returns a MultipleParticipantDeclarationsCsvResponse schema.

401 - Unauthorized

This response returns a UnauthorisedResponse schema.


GET /api/v2/participant-declarations/{id}

Get single participant declaration

Parameters

Parameter In Type Required Description Example
id path string true

The ID of the participant declaration ID

9ed4612b-f8bd-44d9-b296-38ab103fadd2

Responses

Status Description
200

A single participant declaration

This response returns a SingleParticipantDeclarationResponse schema.

404

Not found

This response returns a NotFoundResponse schema.

401

Unauthorized

This response returns a UnauthorisedResponse schema.

Response examples

200 - A single participant declaration

This response returns a SingleParticipantDeclarationResponse schema.

{
  "data": {
    "id": "cd3a12347-7308-4879-942a-c4a70ced400a",
    "type": "participant-declaration",
    "attributes": {
      "participant_id": "db3a7848-7308-4879-942a-c4a70ced400a",
      "declaration_type": "started",
      "declaration_date": "2021-05-31T02:21:32.000Z",
      "course_identifier": "ecf-induction",
      "state": "submitted",
      "updated_at": "2021-05-31T02:22:32.000Z",
      "has_passed": true
    }
  }
}
404 - Not found

This response returns a NotFoundResponse schema.

{
  "error": "Resource not found"
}
401 - Unauthorized

This response returns a UnauthorisedResponse schema.

{
  "error": "HTTP Token: Access denied"
}

PUT /api/v2/participant-declarations/{id}/void

Void a declaration - it will not be soft-deleted

Parameters

Parameter In Type Required Description Example
id path string true

The ID of the declaration to void

28c461ee-ffc0-4e56-96bd-788579a0ed75

Responses

Status Description
200

Successful

This response returns a SingleParticipantDeclarationResponse schema.

Response examples

200 - Successful

This response returns a SingleParticipantDeclarationResponse schema.

{
  "data": {
    "id": "cd3a12347-7308-4879-942a-c4a70ced400a",
    "type": "participant-declaration",
    "attributes": {
      "participant_id": "db3a7848-7308-4879-942a-c4a70ced400a",
      "declaration_type": "started",
      "declaration_date": "2021-05-31T02:21:32.000Z",
      "course_identifier": "ecf-induction",
      "state": "submitted",
      "updated_at": "2021-05-31T02:22:32.000Z",
      "has_passed": true
    }
  }
}

GET /api/v2/participants/ecf

Retrieve multiple participants, replaces /api/v2/participants

Parameters

Parameter In Type Required Description Example
filter query object false

Refine ECF participants to return.

This consumes a ListFilter schema.

filter[cohort]=2022&filter[updated_since]=2020-11-13T11:21:55Z
page query object false

Pagination options to navigate through the list of ECF participants.

This consumes a Pagination schema.

page[page]=1&page[per_page]=5

Responses

Status Description
200

A list of ECF participants

This response returns a MultipleECFParticipantsResponse schema.

401

Unauthorized

This response returns a UnauthorisedResponse schema.

Response examples

200 - A list of ECF participants

This response returns a MultipleECFParticipantsResponse schema.

{
  "data": [
    {
      "id": "db3a7848-7308-4879-942a-c4a70ced400a",
      "type": "participant",
      "attributes": {
        "email": "jane.smith@some-school.example.com",
        "full_name": "Jane Smith",
        "mentor_id": "bb36d74a-68a7-47b6-86b6-1fd0d141c590",
        "school_urn": "106286",
        "participant_type": "ect",
        "cohort": "2021",
        "status": "active",
        "teacher_reference_number": "0012345",
        "teacher_reference_number_validated": true,
        "eligible_for_funding": true,
        "pupil_premium_uplift": false,
        "sparsity_uplift": true,
        "training_status": "active",
        "updated_at": "2021-05-31T02:22:32.000Z"
      }
    },
    {
      "id": "bb36d74a-68a7-47b6-86b6-1fd0d141c590",
      "type": "participant",
      "attributes": {
        "email": "martin.jones@some-school.example.com",
        "full_name": "Martin jones",
        "school_urn": "106286",
        "participant_type": "mentor",
        "cohort": "2021",
        "status": "active",
        "teacher_reference_number": null,
        "teacher_reference_number_validated": false,
        "eligible_for_funding": null,
        "pupil_premium_uplift": true,
        "sparsity_uplift": false,
        "training_status": "deferred",
        "updated_at": "2021-05-31T02:22:32.000Z"
      }
    },
    {
      "id": "eb475531-bf08-48ae-b0ef-c2ff5e5bdef0",
      "type": "participant",
      "attributes": {
        "email": "null,",
        "full_name": null,
        "mentor_id": null,
        "school_urn": null,
        "participant_type": null,
        "cohort": null,
        "status": "withdrawn",
        "teacher_reference_number": null,
        "teacher_reference_number_validated": null,
        "eligible_for_funding": null,
        "pupil_premium_uplift": null,
        "sparsity_uplift": null,
        "training_status": "withdrawn",
        "updated_at": "2021-05-31T02:22:32.000Z"
      }
    }
  ]
}
401 - Unauthorized

This response returns a UnauthorisedResponse schema.

{
  "error": "HTTP Token: Access denied"
}

GET /api/v2/participants/ecf.csv

Retrieve all participants in CSV format, replaces /api/v2/participants.csv

Parameters

Parameter In Type Required Description Example
filter query object false

Refine ECF participants to return.

This consumes a ListFilter schema.

updated_since=2020-11-13T11:21:55Z

Responses

Status Description
200

A CSV file of ECF participants

This response returns a MultipleECFParticipantsCsvResponse schema.

401

Unauthorized

This response returns a UnauthorisedResponse schema.

Response examples

200 - A CSV file of ECF participants

This response returns a MultipleECFParticipantsCsvResponse schema.

401 - Unauthorized

This response returns a UnauthorisedResponse schema.


GET /api/v2/participants/ecf/{id}

Get a single ECF participant

Parameters

Parameter In Type Required Description Example
id path string true

The ID of the ECF participant.

28c461ee-ffc0-4e56-96bd-788579a0ed75

Responses

Status Description
200

A single ECF participant

This response returns a ECFParticipantResponse schema.

401

Unauthorized

This response returns a UnauthorisedResponse schema.

Response examples

200 - A single ECF participant

This response returns a ECFParticipantResponse schema.

{
  "data": {
    "id": "db3a7848-7308-4879-942a-c4a70ced400a",
    "type": "participant",
    "attributes": {
      "email": "jane.smith@some-school.example.com",
      "full_name": "Jane Smith",
      "mentor_id": "bb36d74a-68a7-47b6-86b6-1fd0d141c590",
      "school_urn": "106286",
      "participant_type": "ect",
      "cohort": "2021",
      "status": "active",
      "teacher_reference_number": "1234567",
      "teacher_reference_number_validated": true,
      "eligible_for_funding": true,
      "pupil_premium_uplift": true,
      "sparsity_uplift": true,
      "training_status": "active",
      "training_record_id": "bb36d74a-68a7-47b6-86b6-1fd0d141c590",
      "schedule_identifier": "ecf-standard-january",
      "updated_at": "2021-05-31T02:22:32.000Z"
    }
  }
}
401 - Unauthorized

This response returns a UnauthorisedResponse schema.

{
  "error": "HTTP Token: Access denied"
}

PUT /api/v2/participants/ecf/{id}/defer

Notify that an ECF participant is taking a break from their course

Parameters

Parameter In Type Required Description Example
id path string true

The ID of the participant to defer

28c461ee-ffc0-4e56-96bd-788579a0ed75

Request body

This consumes a ECFParticipantDeferRequest schema.

Request example

{
  "data": {
    "type": "participant-defer",
    "attributes": {
      "reason": "career-break",
      "course_identifier": "ecf-mentor"
    }
  }
}

Responses

Status Description
200

The ECF participant being deferred

This response returns a ECFParticipantDeferResponse schema.

Response examples

200 - The ECF participant being deferred

This response returns a ECFParticipantDeferResponse schema.

{
  "data": {
    "id": "db3a7848-7308-4879-942a-c4a70ced400a",
    "type": "participant",
    "attributes": {
      "email": "jane.smith@some-school.example.com",
      "full_name": "Jane Smith",
      "mentor_id": "bb36d74a-68a7-47b6-86b6-1fd0d141c590",
      "school_urn": "106286",
      "participant_type": "ect",
      "cohort": "2021",
      "status": "active",
      "teacher_reference_number": "1234567",
      "teacher_reference_number_validated": true,
      "eligible_for_funding": true,
      "pupil_premium_uplift": true,
      "sparsity_uplift": true,
      "training_status": "deferred",
      "schedule_identifier": "ecf-standard-january",
      "updated_at": "2021-05-31T02:22:32.000Z"
    }
  }
}

PUT /api/v2/participants/ecf/{id}/resume

Notify that an ECF participant is resuming their course

Parameters

Parameter In Type Required Description Example
id path string true

The ID of the participant to resume

28c461ee-ffc0-4e56-96bd-788579a0ed75

Request body

This consumes a ECFParticipantResumeRequest schema.

Request example

{
  "data": {
    "type": "participant-resume",
    "attributes": {
      "course_identifier": "ecf-mentor"
    }
  }
}

Responses

Status Description
200

The ECF participant being resumed

This response returns a ECFParticipantResumeResponse schema.

Response examples

200 - The ECF participant being resumed

This response returns a ECFParticipantResumeResponse schema.

{
  "data": {
    "id": "db3a7848-7308-4879-942a-c4a70ced400a",
    "type": "participant",
    "attributes": {
      "email": "jane.smith@some-school.example.com",
      "full_name": "Jane Smith",
      "mentor_id": "bb36d74a-68a7-47b6-86b6-1fd0d141c590",
      "school_urn": "106286",
      "participant_type": "ect",
      "cohort": "2021",
      "status": "active",
      "teacher_reference_number": "1234567",
      "teacher_reference_number_validated": true,
      "eligible_for_funding": true,
      "pupil_premium_uplift": true,
      "sparsity_uplift": true,
      "training_status": "active",
      "schedule_identifier": "ecf-standard-january",
      "updated_at": "2021-05-31T02:22:32.000Z"
    }
  }
}

PUT /api/v2/participants/ecf/{id}/withdraw

Notify that an ECF participant has withdrawn from their course

Parameters

Parameter In Type Required Description Example
id path string true

The ID of the participant to withdraw

28c461ee-ffc0-4e56-96bd-788579a0ed75

Request body

This consumes a ECFParticipantWithdrawRequest schema.

Request example

{
  "data": {
    "type": "participant-withdraw",
    "attributes": {
      "reason": "left-teaching-profession",
      "course_identifier": "ecf-mentor"
    }
  }
}

Responses

Status Description
200

The ECF participant being withdrawn

This response returns a ECFParticipantWithdrawResponse schema.

Response examples

200 - The ECF participant being withdrawn

This response returns a ECFParticipantWithdrawResponse schema.

{
  "data": {
    "id": "db3a7848-7308-4879-942a-c4a70ced400a",
    "type": "participant",
    "attributes": {
      "email": "jane.smith@some-school.example.com",
      "full_name": "Jane Smith",
      "mentor_id": "bb36d74a-68a7-47b6-86b6-1fd0d141c590",
      "school_urn": "106286",
      "participant_type": "ect",
      "cohort": "2021",
      "status": "active",
      "teacher_reference_number": "1234567",
      "teacher_reference_number_validated": true,
      "eligible_for_funding": true,
      "pupil_premium_uplift": true,
      "sparsity_uplift": true,
      "training_status": "withdrawn",
      "schedule_identifier": "ecf-standard-january",
      "updated_at": "2021-05-31T02:22:32.000Z"
    }
  }
}

PUT /api/v2/participants/ecf/{id}/change-schedule

Notify that an ECF participant is changing training schedule

Parameters

Parameter In Type Required Description Example
id path string true

The ID of the participant

28c461ee-ffc0-4e56-96bd-788579a0ed75

Request body

This consumes a ECFParticipantChangeScheduleRequest schema.

Request example

{
  "data": {
    "type": "participant-change-schedule",
    "attributes": {
      "schedule_identifier": "ecf-standard-january",
      "course_identifier": "ecf-mentor",
      "cohort": "2021"
    }
  }
}

Responses

Status Description
200

The ECF participant changing schedule

This response returns a ECFParticipantResponse schema.

Response examples

200 - The ECF participant changing schedule

This response returns a ECFParticipantResponse schema.

{
  "data": {
    "id": "db3a7848-7308-4879-942a-c4a70ced400a",
    "type": "participant",
    "attributes": {
      "email": "jane.smith@some-school.example.com",
      "full_name": "Jane Smith",
      "mentor_id": "bb36d74a-68a7-47b6-86b6-1fd0d141c590",
      "school_urn": "106286",
      "participant_type": "ect",
      "cohort": "2021",
      "status": "active",
      "teacher_reference_number": "1234567",
      "teacher_reference_number_validated": true,
      "eligible_for_funding": true,
      "pupil_premium_uplift": true,
      "sparsity_uplift": true,
      "training_status": "active",
      "training_record_id": "bb36d74a-68a7-47b6-86b6-1fd0d141c590",
      "schedule_identifier": "ecf-standard-january",
      "updated_at": "2021-05-31T02:22:32.000Z"
    }
  }
}

Schemas

BadOrMissingParametersResponse

Request was missing data or contained invalid data

Name Type Required Description
bad_or_missing_parameters array true

An error message for each bad or missing attribute describing the problems

BadRequestResponse

Bad Request

Name Type Required Description
bad_request string false

An error message for bad request

Example

{
  "errors": [
    {
      "title": "Bad request",
      "detail": "correct json data structure required. See API docs for reference"
    }
  ]
}

ECFParticipant

The details of a participant

Name Type Required Description
id string true

The unique identifier of the participant record

type string true

The data type

attributes object true

The data attributes associated with an ECF participant

It conforms to ECFParticipantAttributes schema.

ECFParticipantAttributes

The data attributes associated with an ECF participant

Name Type Required Description
email string true

The email address registered for this ECF participant

full_name string true

The full name of this ECF participant

mentor_id string false

The unique identifier of this ECF participants mentor

school_urn string true

The Unique Reference Number (URN) of the school that submitted this ECF participant

participant_type string true

The type of ECF participant this record refers to

Possible values:

  • ect
  • mentor
cohort string true

Indicates which call-off contract funds this participant’s training. 2021 indicates a participant that has started, or will start, their training in the 2021/22 academic year.

status string true

The status of this ECF participant record

Possible values:

  • active
  • withdrawn
teacher_reference_number string false

The Teacher Reference Number (TRN) for this ECF participant

teacher_reference_number_validated boolean false

Indicates whether the Teacher Reference Number (TRN) has been validated

eligible_for_funding boolean false

Indicates whether this participant is eligible to receive DfE funded induction

pupil_premium_uplift boolean false

Indicates whether this participant qualifies for an uplift payment due to pupil premium

sparsity_uplift boolean false

Indicates whether this participant qualifies for an uplift payment due to sparsity

training_status string true

The training status of the ECF participant

Possible values:

  • active
  • deferred
  • withdrawn
training_record_id string true

The unique identifier of the participant training record

schedule_identifier string true

The schedule of the ECF participant

Possible values:

  • ecf-standard-september
  • ecf-standard-january
  • ecf-standard-april
  • ecf-reduced-september
  • ecf-reduced-january
  • ecf-reduced-april
  • ecf-extended-september
  • ecf-extended-january
  • ecf-extended-april
  • ecf-replacement-september
  • ecf-replacement-january
  • ecf-replacement-april
updated_at string true

The date the ECF participant was last updated

ECFParticipantChangeSchedule

An ECF participant change schedule action

Name Type Required Description
type string true

The data type

Possible values:

  • participant-change-schedule
attributes object true

An ECF participant change schedule action

It conforms to ECFParticipantChangeScheduleAttributes schema.

Example

{
  "type": "participant-change-schedule",
  "attributes": {
    "schedule_identifier": "ecf-standard-january",
    "course_identifier": "ecf-mentor"
  }
}

ECFParticipantChangeScheduleAttributes

An ECF participant change schedule action

Name Type Required Description
schedule_identifier string true

The new schedule of the participant

Possible values:

  • ecf-standard-september
  • ecf-standard-january
  • ecf-standard-april
  • ecf-reduced-september
  • ecf-reduced-january
  • ecf-reduced-april
  • ecf-extended-september
  • ecf-extended-january
  • ecf-extended-april
  • ecf-replacement-september
  • ecf-replacement-january
  • ecf-replacement-april
course_identifier string true

The type of course the participant is enrolled in

Possible values:

  • ecf-induction
  • ecf-mentor
cohort string false

Providers may not change the current value for ECF participants. Indicates which call-off contract funds this participant’s training. 2021 indicates a participant that has started, or will start, their training in the 2021/22 academic year.

Example

{
  "schedule_identifier": "ecf-standard-january",
  "course_identifier": "ecf-mentor",
  "cohort": "2021"
}

ECFParticipantChangeScheduleRequest

The change schedule request for a participant

Name Type Required Description
data object true

An ECF participant change schedule action

It conforms to ECFParticipantChangeSchedule schema.

Example

{
  "data": {
    "type": "participant-change-schedule",
    "attributes": {
      "schedule_identifier": "ecf-standard-january",
      "course_identifier": "ecf-mentor",
      "cohort": "2021"
    }
  }
}

ECFParticipantCsvRow

The details of an ECF participant

Name Type Required Description
id string true

The unique identifier of the ECF participant record

type string true

The data type

Possible values:

  • participant
email string true

The email registered for this ECF participant

full_name string true

The full name of the ECF participant

mentor_id string false

The unique identifier of the ECF participants mentor

school_urn string true

The Unique Reference Number (URN) of the school the submitted this ECF participant

participant_type string true

The type of ECF Participant this record refers to either ECT or Mentor

Possible values:

  • ect
  • mentor
cohort string true

Indicates which call-off contract funds this participant’s training. 2021 indicates a participant that has started, or will start, their training in the 2021/22 academic year.

status string true

The status of the ECF Participant record

Possible values:

  • active
  • withdrawn
teacher_reference_number string false

The Teacher Reference Number (TRN) for this ECF participant

teacher_reference_number_validated boolean false

Indicates whether the Teacher Reference Number (TRN) has been validated

eligible_for_funding boolean false

Indicates whether this participant is eligible to receive DfE funded induction

pupil_premium_uplift boolean false

Indicates whether this participant qualifies for an uplift payment due to pupil premium

sparsity_uplift boolean false

Indicates whether this participant qualifies for an uplift payment due to sparsity

training_status string true

The training status of the ECF Participant

Possible values:

  • active
  • deferred
  • withdrawn
training_record_id string true

The unique identifier of the participant training record

schedule_identifier string true

The schedule of the ECF participant

Possible values:

  • ecf-standard-september
  • ecf-standard-january
  • ecf-standard-april
  • ecf-reduced-september
  • ecf-reduced-january
  • ecf-reduced-april
  • ecf-extended-september
  • ecf-extended-january
  • ecf-extended-april
  • ecf-replacement-september
  • ecf-replacement-january
  • ecf-replacement-april
updated_at string true

The date the ECF participant was last updated

ECFParticipantDeclarationCompletedAttributesRequest

An ECF completed participant declaration

Name Type Required Description
participant_id string true

The unique ID of the participant

declaration_type string true

The event declaration type

Possible values:

  • completed
declaration_date string true

The event declaration date

course_identifier string true

The type of course the participant is enrolled in

Possible values:

  • ecf-induction
  • ecf-mentor
evidence_held string true

The type of evidence that the lead provider holds on their platform to demonstrate that the participant has met the retention criteria for the current milestone period

Possible values:

  • training-event-attended
  • self-study-material-completed
  • other

ECFParticipantDeclarationExtendedAttributesRequest

An ECF extended participant declaration

Name Type Required Description
participant_id string true

The unique ID of the participant

declaration_type string true

The event declaration type

Possible values:

  • extended-1
  • extended-2
  • extended-3
declaration_date string true

The event declaration date

course_identifier string true

The type of course the participant is enrolled in

Possible values:

  • ecf-induction
  • ecf-mentor
evidence_held string true

The type of evidence that the lead provider holds on their platform to demonstrate that the participant has met the retention criteria for the current milestone period

Possible values:

  • training-event-attended
  • self-study-material-completed
  • other

ECFParticipantDeclarationRetainedAttributesRequest

An ECF participant retained declaration

Name Type Required Description
participant_id string true

The unique ID of the participant

declaration_type string true

The event declaration type

Possible values:

  • retained-1
  • retained-2
  • retained-3
  • retained-4
declaration_date string true

The event declaration date

course_identifier string true

The type of course the participant is enrolled in

Possible values:

  • ecf-induction
  • ecf-mentor
evidence_held string true

The type of evidence that the lead provider holds on their platform to demonstrate that the participant has met the retention criteria for the current milestone period

Possible values:

  • training-event-attended
  • self-study-material-completed
  • other

ECFParticipantDeclarationStartedAttributesRequest

An ECF started participant declaration

Name Type Required Description
participant_id string true

The unique ID of the participant

declaration_type string true

The event declaration type

Possible values:

  • started
declaration_date string true

The event declaration date

course_identifier string true

The type of course the participant is enrolled in

Possible values:

  • ecf-induction
  • ecf-mentor

ECFParticipantDefer

The details of a participant deferral request

Name Type Required Description
type string true

The data type

Possible values:

  • participant-defer
attributes object true

An ECF participant deferral action

It conforms to ECFParticipantDeferAttributes schema.

ECFParticipantDeferAttributes

An ECF participant deferral action

Name Type Required Description
reason string true

The reason for the deferral

Possible values:

  • bereavement
  • long-term-sickness
  • parental-leave
  • career-break
  • other
course_identifier string true

The type of course the participant is enrolled in

Possible values:

  • ecf-induction
  • ecf-mentor

Example

{
  "reason": "career-break",
  "course_identifier": "ecf-mentor"
}

ECFParticipantDeferAttributesResponse

The data attributes associated with an ECF participant

Name Type Required Description
email string true

The email address registered for this ECF participant

full_name string true

The full name of this ECF participant

mentor_id string false

The unique identifier of this ECF participants mentor

school_urn string true

The Unique Reference Number (URN) of the school that submitted this ECF participant

participant_type string true

The type of ECF participant this record refers to

Possible values:

  • ect
  • mentor
cohort string true

Indicates which call-off contract funds this participant’s training. 2021 indicates a participant that has started, or will start, their training in the 2021/22 academic year.

status string true

The status of this ECF participant record

Possible values:

  • active
  • withdrawn
teacher_reference_number string false

The Teacher Reference Number (TRN) for this ECF participant

teacher_reference_number_validated boolean false

Indicates whether the Teacher Reference Number (TRN) has been validated

eligible_for_funding boolean false

Indicates whether this participant is eligible to receive DfE funded induction

pupil_premium_uplift boolean false

Indicates whether this participant qualifies for an uplift payment due to pupil premium

sparsity_uplift boolean false

Indicates whether this participant qualifies for an uplift payment due to sparsity

training_status string true

The training status of the ECF participant

Possible values:

  • active
  • deferred
  • withdrawn
schedule_identifier string true

The schedule of the ECF participant

Possible values:

  • ecf-standard-september
  • ecf-standard-january
  • ecf-standard-april
  • ecf-reduced-september
  • ecf-reduced-january
  • ecf-reduced-april
  • ecf-extended-september
  • ecf-extended-january
  • ecf-extended-april
  • ecf-replacement-september
  • ecf-replacement-january
  • ecf-replacement-april
updated_at string true

The date the ECF participant was last updated

ECFParticipantDeferRequest

The deferral request for a participant

Name Type Required Description
data object true

The details of a participant deferral request

It conforms to ECFParticipantDefer schema.

Example

{
  "data": {
    "type": "participant-defer",
    "attributes": {
      "reason": "career-break",
      "course_identifier": "ecf-mentor"
    }
  }
}

ECFParticipantDeferResponse

An ECF Participant

Name Type Required Description
data object true

The details of a participant

It conforms to ECFParticipantDeferResponseData schema.

ECFParticipantDeferResponseData

The details of a participant

Name Type Required Description
id string true

The unique identifier of the participant record

type string true

The data type

attributes object true

The data attributes associated with an ECF participant

It conforms to ECFParticipantDeferAttributesResponse schema.

ECFParticipantResponse

An ECF Participant

Name Type Required Description
data object true

The details of a participant

It conforms to ECFParticipant schema.

ECFParticipantResume

An ECF participant resume action

Name Type Required Description
type string true

The data type

Possible values:

  • participant-resume
attributes object true

An ECF participant resume action

It conforms to ECFParticipantResumeAttributes schema.

ECFParticipantResumeAttributes

An ECF participant resume action

Name Type Required Description
course_identifier string true

The type of course the participant is enrolled in

Possible values:

  • ecf-induction
  • ecf-mentor

Example

{
  "course_identifier": "ecf-mentor"
}

ECFParticipantResumeAttributesResponse

The data attributes associated with an ECF participant

Name Type Required Description
email string true

The email address registered for this ECF participant

full_name string true

The full name of this ECF participant

mentor_id string false

The unique identifier of this ECF participants mentor

school_urn string true

The Unique Reference Number (URN) of the school that submitted this ECF participant

participant_type string true

The type of ECF participant this record refers to

Possible values:

  • ect
  • mentor
cohort string true

Indicates which call-off contract funds this participant’s training. 2021 indicates a participant that has started, or will start, their training in the 2021/22 academic year.

status string true

The status of this ECF participant record

Possible values:

  • active
  • withdrawn
teacher_reference_number string false

The Teacher Reference Number (TRN) for this ECF participant

teacher_reference_number_validated boolean false

Indicates whether the Teacher Reference Number (TRN) has been validated

eligible_for_funding boolean false

Indicates whether this participant is eligible to receive DfE funded induction

pupil_premium_uplift boolean false

Indicates whether this participant qualifies for an uplift payment due to pupil premium

sparsity_uplift boolean false

Indicates whether this participant qualifies for an uplift payment due to sparsity

training_status string true

The training status of the ECF participant

Possible values:

  • active
  • deferred
  • withdrawn
schedule_identifier string true

The schedule of the ECF participant

Possible values:

  • ecf-standard-september
  • ecf-standard-january
  • ecf-standard-april
  • ecf-reduced-september
  • ecf-reduced-january
  • ecf-reduced-april
  • ecf-extended-september
  • ecf-extended-january
  • ecf-extended-april
  • ecf-replacement-september
  • ecf-replacement-january
  • ecf-replacement-april
updated_at string true

The date the ECF participant was last updated

ECFParticipantResumeRequest

The resume request for a participant

Name Type Required Description
data object true

An ECF participant resume action

It conforms to ECFParticipantResume schema.

Example

{
  "data": {
    "type": "participant-resume",
    "attributes": {
      "course_identifier": "ecf-mentor"
    }
  }
}

ECFParticipantResumeResponse

An ECF Participant

Name Type Required Description
data object true

The details of a participant

It conforms to ECFParticipantResumeResponseData schema.

ECFParticipantResumeResponseData

The details of a participant

Name Type Required Description
id string true

The unique identifier of the participant record

type string true

The data type

attributes object true

The data attributes associated with an ECF participant

It conforms to ECFParticipantResumeAttributesResponse schema.

ECFParticipantRetainedDeclaration

An ECF participant retained declaration request body

Name Type Required Description
type object false

The request data

Possible values:

  • participant-declaration
attributes object true

An ECF participant retained declaration

It conforms to ECFParticipantRetainedDeclarationAttributes schema.

ECFParticipantRetainedDeclarationAttributes

An ECF participant retained declaration

Name Type Required Description
participant_id string true

The unique id of the participant

declaration_type string true

The event declaration type

Possible values:

  • retained-1
  • retained-2
  • retained-3
  • retained-4
declaration_date string true

The event declaration date

course_identifier string true

The type of course the participant is enrolled in

Possible values:

  • ecf-induction
  • ecf-mentor
evidence_held string true

The type of evidence that the lead provider holds on their platform to demonstrate that the participant has met the retention criteria for the current milestone period

Possible values:

  • training-event-attended
  • self-study-material-completed
  • other

Example

{
  "participant_id": "db3a7848-7308-4879-942a-c4a70ced400a",
  "declaration_type": "retained-1",
  "declaration_date": "2021-05-31T02:21:32.000Z",
  "course_identifier": "ecf-induction",
  "evidence_held": "training-event-attended"
}

ECFParticipantStartedDeclaration

A participant started declaration request body

Name Type Required Description
type object false

The request data

Possible values:

  • participant-declaration
attributes object true

An ECF started and completed participant declaration

It conforms to ECFParticipantStartedDeclarationAttributes schema.

ECFParticipantStartedDeclarationAttributes

An ECF started and completed participant declaration

Name Type Required Description
participant_id string true

The unique id of the participant

declaration_type string true

The event declaration type

Possible values:

  • started
  • completed
declaration_date string true

The event declaration date

course_identifier string true

The type of course the participant is enrolled in

Possible values:

  • ecf-induction
  • ecf-mentor

Example

{
  "participant_id": "db3a7848-7308-4879-942a-c4a70ced400a",
  "declaration_type": "started",
  "declaration_date": "2021-05-31T02:21:32.000Z",
  "course_identifier": "ecf-mentor"
}

ECFParticipantWithdraw

An ECF participant withdrawal action

Name Type Required Description
type string false

The data type

Possible values:

  • participant-withdraw
attributes object false

An ECF participant withdrawal action

It conforms to ECFParticipantWithdrawAttributes schema.

ECFParticipantWithdrawAttributes

An ECF participant withdrawal action

Name Type Required Description
reason string true

The reason for the withdrawal

Possible values:

  • left-teaching-profession
  • moved-school
  • mentor-no-longer-being-mentor
  • school-left-fip
  • other
course_identifier string true

The type of course the participant is enrolled in

Possible values:

  • ecf-induction
  • ecf-mentor

Example

{
  "reason": "left-teaching-profession",
  "course_identifier": "ecf-mentor"
}

ECFParticipantWithdrawAttributesResponse

The data attributes associated with an ECF participant

Name Type Required Description
email string true

The email address registered for this ECF participant

full_name string true

The full name of this ECF participant

mentor_id string false

The unique identifier of this ECF participants mentor

school_urn string true

The Unique Reference Number (URN) of the school that submitted this ECF participant

participant_type string true

The type of ECF participant this record refers to

Possible values:

  • ect
  • mentor
cohort string true

Indicates which call-off contract funds this participant’s training. 2021 indicates a participant that has started, or will start, their training in the 2021/22 academic year.

status string true

The status of this ECF participant record

Possible values:

  • active
  • withdrawn
teacher_reference_number string false

The Teacher Reference Number (TRN) for this ECF participant

teacher_reference_number_validated boolean false

Indicates whether the Teacher Reference Number (TRN) has been validated

eligible_for_funding boolean false

Indicates whether this participant is eligible to receive DfE funded induction

pupil_premium_uplift boolean false

Indicates whether this participant qualifies for an uplift payment due to pupil premium

sparsity_uplift boolean false

Indicates whether this participant qualifies for an uplift payment due to sparsity

training_status string true

The training status of the ECF participant

Possible values:

  • active
  • deferred
  • withdrawn
schedule_identifier string true

The schedule of the ECF participant

Possible values:

  • ecf-standard-september
  • ecf-standard-january
  • ecf-standard-april
  • ecf-reduced-september
  • ecf-reduced-january
  • ecf-reduced-april
  • ecf-extended-september
  • ecf-extended-january
  • ecf-extended-april
  • ecf-replacement-september
  • ecf-replacement-january
  • ecf-replacement-april
updated_at string true

The date the ECF participant was last updated

ECFParticipantWithdrawDataResponse

The details of a participant

Name Type Required Description
id string true

The unique identifier of the participant record

type string true

The data type

attributes object true

The data attributes associated with an ECF participant

It conforms to ECFParticipantWithdrawAttributesResponse schema.

ECFParticipantWithdrawRequest

The withdrawal request for a participant

Name Type Required Description
data object true

An ECF participant withdrawal action

It conforms to ECFParticipantWithdraw schema.

Example

{
  "data": {
    "type": "participant-withdraw",
    "attributes": {
      "reason": "left-teaching-profession",
      "course_identifier": "ecf-mentor"
    }
  }
}

ECFParticipantWithdrawResponse

An ECF Participant

Name Type Required Description
data object true

The details of a participant

It conforms to ECFParticipantWithdrawDataResponse schema.

Error

An single error element

Name Type Required Description
title string false

A title of the error

detail string false

Additional details of the error

ErrorResponse

A list of errors

Name Type Required Description
error array false It conforms to Error schema.

ListFilter

Filter a list of records to return more specific results

Name Type Required Description
updated_since string false

Return only records that have been updated since this date and time (ISO 8601 date format)

ListFilterDeclarations

Filter a list of declarations records to return more specific results

Name Type Required Description
updated_since string false

Return only records that have been updated since this date and time (ISO 8601 date format)

participant_id string false

The unique id of the participant

MultipleECFParticipantsCsvResponse

A list of ECF participants in the Comma Separated Value (CSV) format

Name Type Required Description
data array true It conforms to ECFParticipantCsvRow schema.

MultipleECFParticipantsResponse

A list of ECF participants

Name Type Required Description
data array true It conforms to ECFParticipant schema.

MultipleParticipantDeclarationsCsvResponse

A list of participant declarations in the Comma Separated Value (CSV) format

Name Type Required Description
data array true It conforms to ParticipantDeclarationCsvRow schema.

MultipleParticipantDeclarationsResponse

A list of participant declarations

Name Type Required Description
data array true It conforms to ParticipantDeclarationResponse schema.

NotFoundResponse

The requested resource was not found

Name Type Required Description
error string false

Pagination

This schema used to paginate through a collection.

Name Type Required Description
page integer false

The page number to paginate to in the collection. If no value is specified it defaults to the first page.

per_page integer false

The number items to display on a page. Defaults to 100. Maximum is 3000, if the value is greater that the maximum allowed it will fallback to 3000.

ParticipantDeclarationAttributes

The data attributes associated with a participant declaration response

Name Type Required Description
participant_id string true

The unique id of the participant

declaration_type string true

The event declaration type

Possible values:

  • started
  • retained-1
  • retained-2
  • retained-3
  • retained-4
  • completed
  • extended-1
  • extended-2
  • extended-3
declaration_date string true

The event declaration date

course_identifier string true

The type of course the participant is enrolled in

Possible values:

  • ecf-induction
  • ecf-mentor
state string true

Indicates the state of this payment declaration

Possible values:

  • submitted
  • eligible
  • payable
  • paid
  • voided
  • ineligible
updated_at string true

The date the declaration was last updated

has_passed boolean false

Whether the participant has failed or passed

ParticipantDeclarationCsvRow

The details of a participant declaration

Name Type Required Description
id string true

The unique identifier of the participant declaration record

participant_id string true

The unique identifier of the participant record the declaration refers to

declaration_type string true

The event declaration type

Possible values:

  • started
  • retained-1
  • retained-2
  • retained-3
  • retained-4
  • completed
  • extended-1
  • extended-2
  • extended-3
declaration_date string true

The event declaration date

course_identifier string true

The type of course the participant is enrolled in

Possible values:

  • ecf-induction
  • ecf-mentor
state string false

Indicates the state of this payment declaration

updated_at string true

The date the declaration was last updated

ParticipantDeclarationDataRequest

A participant declaration data request

Name Type Required Description
type string false

Possible values:

  • participant-declaration
attributes false

This conforms to any of the following schemas:

ParticipantDeclarationRequest

An participant declaration request

Name Type Required Description
data object true

A participant declaration data request

It conforms to ParticipantDeclarationDataRequest schema.

ParticipantDeclarationResponse

A participant declaration response

Name Type Required Description
id string true

The unique identifier of the participant declaration record

type string true

The data type

attributes object true

The data attributes associated with a participant declaration response

It conforms to ParticipantDeclarationAttributes schema.

ParticipantListFilter

Filter a list of records to return more specific results

Name Type Required Description
updated_since string false

Return only records that have been updated since this date and time (ISO 8601 date format)

cohort string false

Return only records for the given cohort

SingleParticipantDeclarationResponse

A confirmation that the participant declaration has been recorded successfully

Name Type Required Description
data object true

A participant declaration response

It conforms to ParticipantDeclarationResponse schema.

UnauthorisedResponse

Authorization information is missing or invalid

Name Type Required Description
error string false