Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: OpenAIRE Broker API
version: '2026-10-14'
description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-14: 8 operation(s) read from 10 public documentation page(s) (each operation names its page in x-source). This is not the provider''s published contract; OpenAIRE has published no machine-readable contract that the pipeline could find. Engine: local.'
x-evidence-tiers:
code-example: 2
documentation: 6
pages-with-code: 6
pages-read: 10
x-generated-from: documentation
x-provenance: generated
x-authored-by: API Evangelist
x-generated: '2026-10-14'
x-generator: generate-contract-from-docs.py
x-engine: local
x-sources:
- https://graph.openaire.eu/docs/apis/graph-api
- https://graph.openaire.eu/docs/apis/skg-if
- https://graph.openaire.eu/docs/apis/broker-api
- https://graph.openaire.eu/docs/apis/authentication
- https://graph.openaire.eu/docs/next/apis/graph-api
- https://graph.openaire.eu/docs/next/apis/skg-if
- https://graph.openaire.eu/docs/next/apis/broker-api
- https://graph.openaire.eu/docs/next/apis/authentication
- https://graph.openaire.eu/docs/7.0.0/apis/broker-api
- https://graph.openaire.eu/docs/7.0.0/apis/authentication
servers:
- url: https://aai.openaire.eu
tags:
- name: Broker
paths:
/broker/scroll/notifications/[scroll_id]:
get:
operationId: get_broker_scroll_notifications_scroll_id
tags:
- Broker
summary: Request subsequent pages of enrichment notification records
description: Returns the next page of notification records using the provided scroll identifier.
x-source: https://graph.openaire.eu/docs/apis/broker-api
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: documentation
/broker/scroll/notifications/bySubscriptionId/[sub-1234]:
get:
operationId: get_broker_scroll_notifications_bySubscriptionId_sub_1234
tags:
- Broker
summary: Access the 1st page of enrichment notification records for a subscription
description: Returns the first page of notification records for the specified subscription.
x-source: https://graph.openaire.eu/docs/apis/broker-api
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: documentation
/broker/subscriptions:
get:
operationId: get_broker_subscriptions
tags:
- Broker
summary: GET /broker/subscriptions
x-source: https://graph.openaire.eu/docs/apis/broker-api
parameters:
- name: email
in: query
required: false
schema:
type: string
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: code-example
language: curl
snippet: 'curl - X GET -- header ''Accept: application/json'' ''https://api.openaire.eu/broker/subscriptions?email=[subscriber_email]'' Extract the subscription ID and use it to access the 1st page of enrichment notification records curl - X GET -- header ''Accept: application/json'' ''https://api.openaire.eu/broker/scroll/notifications/bySubscriptionId/[sub-1234]'' Extract the scroll ID from the response to reques'