API keys
User authentication and authorisation (for those TED APIs that require it) is controlled by the use of API keys. TED API keys are essentially UUIDs (Universally Unique Identifiers) without hyphens (dashes).
You can generate and manage your own API keys by logging-in to your account in the TED Developer Portal[1].
If you use the Publication API, after you generate your key, log into the eNotices2 website at least once to pair your account and perform at least one valid API request for the system to recognise you as an "eSender".
| Only one API key is allowed per user. The creation of a new API key implies the automatic revocation of the previous one. |
API key generation
You can generate an API Key by logging into the TED Developer Portal[1] and clicking on the "Manage your API Keys" button. To login to the TED Developer Portal you will need a valid EU Login[2] account.
| For security reasons API keys are not stored and cannot be retrieved via the TED Developer Portal after they are generated. Your API key will be delivered to you only at the time of generation. Copy and safely store the provided API key; if you lose it, you will have to generate a new one. |
API key life span
-
Expiry:
-
Every API key is valid for 24 months.
-
After its validity period elapses, the API key expires.
-
-
Renewal:
-
API key renewal extends the validity of an API key for 12 months.
-
An automated notification will be sent four (4) weeks before expiration to the email associated with the EU-Login account used to create the API key.
-
The email contains a hyperlink for renewing the API key. If not clicked within 21 days, the link expires, and a new email will be sent with a fresh hyperlink.
-
-
Revocation:
-
You can revoke any unused API keys as needed in the TED Developer Portal.
-
Revoked API keys are invalidated permanently.
-
