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 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. If a participant is registered as both an ECT and a mentor, this ID will be the same. 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. |
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. If the PUT partnership is used, the ID will not update.
|
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 the specific training as either an ECT or a mentor for a participant. An ECT who later becomes a mentor would have 1 participant ID, but 2 training record IDs. Providers using the participants endpoints will see separate enrolment records for the same participant, each with a different training_record_id based on their role. It is also the ID returned in the GET transfers endpoint.
|