API Reference

The AltDataEU API is organized around REST. Our API has predictable resource-oriented URLs, accepts form-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

The base URL for all API requests is https://api.altdataeu.com

Authentication

Authenticate your account by including your secret API key in the request. You can manage your API keys in the Dashboard. Your API keys carry many privileges, so be sure to keep them secure.

Authentication to the API is performed via HTTP Bearer Auth. Provide your API key as the bearer token value.

Pagination

All top-level API resources have support for bulk fetches via "list" API methods. These list API methods share a common structure, taking at least these two parameters: limit and starting_after (cursor).

  • limit (default 100, max 1000): A limit on the number of objects to be returned.
  • starting_after: An object ID that defines your place in the list.

Lobbyist Meetings

Retrieve a list of official meetings logged by politicians and regulators across 77+ European parliaments. This endpoint is crucial for tracking early-stage legislative influence.

Query Parameters

countryFilter by ISO-2 country code (e.g. DE, FR, EU).
politician_idFilter by a specific politician's unique AltDataEU ID.
sinceISO 8601 timestamp to filter meetings logged after this date.

Authentication Example

# With cURL, you pass the token in the Authorization header
curl https://api.altdataeu.com/v1/meetings \
  -H "Authorization: Bearer alt_live_x89f..."

List Meetings Request

curl -G https://api.altdataeu.com/v1/meetings \
  -H "Authorization: Bearer alt_live_..." \
  -d limit=3 \
  -d country="DE"

Response

{
  "object": "list",
  "data": [
    {
      "id": "mtg_eu_829312",
      "object": "meeting",
      "date": "2025-10-12",
      "politician": {
        "id": "pol_98234",
        "name": "Klaus W."
      },
      "lobbyists": [
        {
          "name": "TechAdvocacy Partners EU",
          "tr_id": "8492019482-12"
        }
      ],
      "dossiers_discussed": ["AI Act"]
    }
  ],
  "has_more": true,
  "next_cursor": "mtg_eu_829312"
}