Automating GRE Score Import with EDM Touchless Solution

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.

Get the Client ID and Client Secret

To receive and encode the Client ID and Client Secret:

1. Go to the GRE website.

2. Follow instructions to request access to automated server-to-server data feeds.

3. Follow further instructions to obtain a Client ID and a Client Secret.

Perform Base64 encoding on your Client ID and Client Secret

To include the Client ID and Client Secret in the HTTP headers used during the import, you must encode them in Base64.

1. Join your Client ID and Client Secret values with a colon: CLIENT_ID:CLIENT_SECRET.

2. Open your operating system’s terminal.

3. Depending on your operating system, use one of the following examples to encode the combined value, replacing CLIENT_ID:CLIENT_SECRET in these examples with your combined value:

   • Windows (PowerShell):

     [Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes("CLIENT_ID:CLIENT_SECRET"))

   • macOS or Linux:

     printf '%s' 'CLIENT_ID:CLIENT_SECRET' | base64

4. Keep the return value in a secure location—you’ll need to paste it later.

💡 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 GRE test types

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

1. Go to Database → Suitcase

2. Select Import.

3. In the text field, paste the Suitcase ID of the shared Suitcase item:

   0a37b9f2-b73d-4040-85fb-7c232324ff03:slate-examples

4. Select Retrieve.

Step 3: Adding the source format

1. Go to Database → Source Format Library.

2. Next to GRE Score Data File Format: Fixed Width 2017, 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 GRE Score Data File (Format: Fixed Width 2017).

3. Select Edit.

4. Select the Import Automation tab.

5. 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

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

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

7. Between the opening <t name="authcode"> tag and closing </t> tag, paste the base-64 encoded value you created earlier.

8. 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.

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 EDMGRE to restrict the data retrieved during the first data fetch.

5. 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:

1. Contact GRE Tech Support at institutionportal@ets.org, 855-242-6478, or 609-310-3252.

2. Receive a temporary password from ETS Tech Support.

3. Encode your Client ID and temporary password, treating your temporary password as the Client Secret.

💡 Important update for both GRE and TOEFL integration accounts.