API IDs explained

We use various unique identifiers (IDs) in the endpoint requests and responses to help make the API reliable, efficient, and unambiguous.

ID What the ID is for
clawback_statement_id Identifies a clawback statement we’ve attached when funding paid to a lead provider needs to be returned due to overpayments or participant data changes (for example, someone withdraws from training or is found to be ineligible). Enables lead providers using the declarations endpoints to identify which clawback statement a participant’s funding adjustment relates to and reconcile clawbacks against their monthly or cumulative funding reports.
declaration_id Created when providers submit a declaration. This ID can also be used to void a declaration. It’s shown as simply id at the top of successful responses in the declarations endpoints.
delivery_partner_id Identifies delivery partners. Used when providers form partnerships as part of the POST partnerships endpoint. It’s also listed in GET participants/ecf and GET participants/ecf/{id} responses in API v3.
mentor_id Identifies individual ECT mentors within the API. This ID is used to link mentors to ECTs they’re supporting, and tracks their training status, funding eligibility, and contact information. The same mentor_id is used whether the mentor is funded or unfunded, including those trained by a different lead provider than the one supporting their ECT.
participant_id Identifies participants registered for training. This is used for declarations, changing schedules, notifying us of a change in circumstances related to their training as well as other endpoints to monitor training and progress.
participant_id_changes A record of changes where a participant’s ID has been updated, usually to fix a data issue like a duplicate or incorrect registration. In such cases, the from_participant_id field is the original ID that has been retired or replaced. The to_participant_id is the new ID that should now be used when referring to this participant.
partnership_id Identifies the partnership between schools, delivery partners and providers for a specific cohort who work together to deliver training to participants. It’s shown as simply id at the top of successful responses in the partnership endpoints.
statement_id Identifies a financial statement we’ve attached to a lead provider. It acts as a reference for each individual payment cycle or statement and allows lead providers to retrieve financial data using the GET statements endpoints.
school_id Identifies schools. Used when providers form partnerships as part of the POST partnerships endpoint.
training_record_id Identifies participants with multiple enrolments, such as an ECT who later becomes a mentor. Providers using the participants endpoints will see separate records for the same participant, each with a different training_record_id based on their role.