Automating GRE Score Import with EDM Touchless Solution

Updated 06 Jan 2026

Print
Share
Dark
Light
PDF

Article summary

Did you find this summary helpful?

Thank you for your feedback

Educational Testing Service (ETS) lets approved score users view Graduate Record Examination (GRE) scores through ETS Data Manager (EDM).

The EDM Touchless Solution lets you automatically import these scores into Slate with corresponding APIs. GRE scores can be imported into Slate using an API call configured as a source format.

This article shows you how to configure this process in Slate.

Step 1: Receiving and encoding Client ID and Client Secret

Automatically fetching GRE data via API requires a Client ID and Client Secret from ETS. These values must be encoded before they will function.

To receive and encode the Client ID and Client Secret:

Go to the GRE website.
Follow instructions to request access to automated server-to-server data feeds.
Follow further instructions to obtain a Client ID and a Client Secret.
Go to a base-64 encoding site, like https://www.base64encode.org/.
Paste the Client ID, enter a colon :, then paste the Client Secret.
Select Encode.
Copy the encoded values for the next steps in the integration process.

💡 Setting up TOEFL scores too?
When you set up your TOEFL integration, use this base 64 encoded value as your API key (that is: skip to step 2).

Step 2: Adding the source format

Go to Database → Source Format Library.
Next to GRE Score Data File Format: Fixed Width 2017, select Add. A pop-up appears.
Select Add. A pop-up appears that describes the source format.
Select Add. A browser dialog appears.
Select OK.

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

Step 3: Configuring the import

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

Go to Database → Source Formats.
Select GRE Score Data File (Format: Fixed Width 2017).
Select Edit.
Select the Import Automation tab.

In the Import Remote Server field, paste the following:

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

In the HTTP Headers field, add the following tag:
```
<t name="authcode"></t>
```
Between the opening and closing tags, paste the base-64 encoded value you created earlier as part of step one.
By default, all currently valid EDMGRE 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 the next steps.

Optional: Overriding the last remote server fetch

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

To the right of the Last Remote Server Fetch (UTC) field, select Override.
Enter the case-sensitive confirmation message.
Select OK.
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 EDMGRE to restrict the data retrieved during the first data fetch.
Select Save.

Troubleshooting

If the connection from the GRE source format breaks, the password likely expired.

To receive a temporary password for GRE Server-to-Server Feeds:

Contact GRE Tech Support at institutionportal@ets.org, 855-242-6478, or 609-310-3252.
ETS Tech Support provides you with a temporary password.
Go to https://www.base64encode.org/.
Select the Encode tab.
Enter the Client ID, a colon :, and the temporary password.
Select Encode.

💡 Important update for both GRE and TOEFL integration accounts.

Was this article helpful?

What's Next

Automating TOEFL Score Import with TOEFL Access Touchless Solution

Table of contents

Step 1: Receiving and encoding Client ID and Client Secret
Step 2: Adding the source format
Step 3: Configuring the import
Optional: Overriding the last remote server fetch
Troubleshooting