How to use the webservice?

 Export PDF Print this page 

Registration

How to register for a webservice:

  1. Click Webservice registration in the right menu.
  2. Click Register if you don't already have an EU Login account. Once you have registered an account, click Sign in. Read more on how to register on EUR-Lex.
  3. Click Register and fill out the registration form (see table below).
  4. Click Save to send us the form.
  5. If your form checks out, we will send you an e-mail specifying your access rights.

Information to put in the form

Used data Data you want to get from the webservice, for further use.
Final use of data What you intend to do with the data
Calling application Name of the application you intend to use to query EUR-Lex
Days of use Day of the week when you will use the webservice. One check box per day.
Call frequency Number of calls per day
Comments Additional comments
Username Your user name (prefilled - in "read-only" mode).
First name Your first name
Last name Your last name
Phone number Your phone number
Email address Your email address
Name Name of your organisation
Address Address of your organisation
Postcode (ZIP code) Postcode (ZIP code) of your organisation
Country Country where your organisation is located
Phone number Phone number of your organisation
I accept the terms of usage Your acceptance of the terms of use for webservices

Using the webservice

You can use your webservice as soon as we send you the email granting you access:

  1. Click Webservice registration in the right menu.
  2. The information you will see includes a link to the WSDL of the webservice - you will need to provide the URL of the WSDL to the application you are using to query EUR‑Lex.
  3. Call the webservice, using the username and password we emailed to you. You need to specify:
    • your query, written as an expert query. It can contain a SELECT clause, to choose the metadata to be displayed, and an ORDER BY clause, to define the sorting order. You can also use the webservice template.
    • the language
    • the page number
    • the number of results per page
  4. The results list will contain the metadata you selected, for each document. If you did not select any metadata here, the display profile defined in your search preferences is used.

Get the webservice template

If you are approved to use the webservice, you can get a special XML template to use for every query you make:

  1. Sign in and run a search (quick, advanced or expert).
  2. Click  the webservices template icon at the top of the search results.
  3. A new window will open with the query written in a structured way and instructions on how to use it in your webservice call. You can copy this template and use it for all subsequent webservice calls.

Change your webservice limits

The maximum daily number of calls to the webservice is limited. To change these limits, go to the webservices page and click the link to change the limits.

We will inform you by email about your new limits (if any). 

Unsubscribe

To unsubscribe from webservices, go to the webservices page and click the link to unsubscribe.

Give your reasons for doing so, and then click Unsubscribe

Your webservice access will be revoked and your password deactivated.

Some technical information about webservices (in English only)

  1. Search Web service User Manual
  2. Data Extraction using Web Services
  3. Web Services query metadata

Go to top