Educational Testing Service (ETS) lets approved score users view Test of English as a Foreign Language (TOEFL) scores through TOEFL Access.

Step 1: Receiving the API key

Automatically fetching TOEFL data via API requires an ETS-provided API key, which contains the encoded Client ID and Client Secret.

To get the API key:

1. Go to TOEFL Access.

2. Go to Server-to-Server feeds. If you don’t have access, go to the TOEFL website and follow steps to request access.

3. If you already have an integration account, copy the existing API key from the Integrations section and skip to adding the source format. If you don’t have a prior integration account, generate a new key from TOEFL Access.

4. Keep the API key handy for the next steps in the integration process.

💡 Setting up GRE scores too?

When you set up your GRE integration, use this API key in place of the base64 encoded value described in the first section of the GRE article.

Step 2: Adding the TOEFL test type

📝 Starting January 21, 2026, you must add a TOEFL Internet-based test type to your database.

To add the test type:

1. Go to Database → Slate Template Library.

2. Select Refresh the Slate Template Library.

3. In the Test Types section, next to TOEFL - IBT26, select Add.

4. Select Save.

Step 3: Adding the source format

To add the TOEFL source format:

1. Go to Database → Source Format Library.

2. Next to TOEFL Score Data File: Fixed Width >01/2026, select Add. A pop-up appears.

3. Select Add. A pop-up appears that describes the source format.

4. Select Add. A browser dialog appears.

5. Select OK.

You are redirected to the overview page for the source format.

Step 4: Configuring the import

The Score Data File automatically fetches score results shared with your institution.

1. Go to Database → Source Formats.

2. Select TOEFL Score Data File (Format: Fixed Width >01/2026).

3. Select Edit.

4. Select the Import Automation tab.

5. In the Import Remote Server field, paste the following:

   https://toeflaccess-api.ets.org/scores/?startdate={{dtstart|date:'s'}}&enddate={{dtend|date:'s'}}&type=TOEFL&reportby=scorelinkbyreportdate

6. In the HTTP Headers field, add the following tag:

   <t name="authcode"></t>

7. Between the opening and closing tags, paste the base-64 encoded value you created earlier as part of step one.

8. By default, all currently valid TOEFL scores released to your institution will be sent during the first fetch. If you prefer this option, select Save. If you'd like to override this default, continue to overriding the last remote server fetch.

   

Optional: Overriding the last remote server fetch

Overriding this value will limit the fetch to just those since the last import.

1. To the right of the Last Remote Server Fetch (UTC) field, select Override.

2. Enter the case-sensitive confirmation message.

3. Select OK.  

4. In the Last Remote Server Fetch (UTC) field, enter the approximate timestamp, in the format yyyy-MM-ddTHH:mm:ss (for example, 2023-04-05T03:22:30), that the source format should send to EDMTOEFL to restrict the data retrieved during the first data fetch.
   

5. Select Save.

Troubleshooting

If the connection from the GRE or TOEFL source formats break, the password likely expired.

To receive the API key for TOEFL Server-to-Server Feeds:

1. Log in to TOEFL Access.

2. Copy your existing API key, or generate a new API key.

3. Update the configuration in the ETS Source format with the API key.

If your server-to-server account integrates with both TOEFL and GRE, you will need to update your GRE encoded value when you update it for TOEFL.

Additional resources

• Update guide for existing Slate integration users

• Generate a new API key

• Important update for both GRE and TOEFL integration accounts

💡 You can also contact TOEFL Access Support at help.toeflaccess@ets.org