HAPI FAQ – Meetings API Overview and Query Examples

HAPI FAQ – Meetings API

Where is the Meetings API documented?

XSD: https://bitbucket.org/sdo-hapi/data-models/src/master/schema/xsd/meetings/harmonized-meetings.xsd
OpenAPI YAML:
- https://bitbucket.org/sdo-hapi/api-specifications/src/master/openapi-v3/iec-meetings-openapi3.yaml
OpenAPI: IEC API Portal – https://api-portal.iec.ch/ (developer account required)

What can my application see?

Meetings and practical information (location, date, time): visible to all NCs.
Participation: only for users linked to your NC.

Which meeting documents are available?

Official working documents: linked with a URN to the Working Documents API.
Other meeting documents: no URN; a direct download URL is provided.

How are participants identified?

By last name, first name and URN, linked to the Identity Management API.

How can I filter meetings?

By committee, organizing NC, date range, country/city and meeting type. Use tenantCode=IEC or tenantCode=CENELEC.

Example queries

Need	Call
IEC main meetings in Brussels	`/harmonized/meetings?countryUrn=iec:country:2172&type=TCSCMAIN&city=Bruxelles&sortBy=lastChangeTimestamp&tenantCode=IEC`
IEC main meetings from a date	`/harmonized/meetings?type=TCSCMAIN&sortBy=lastChangeTimestamp&meetingFromFrom=2024-10-25&tenantCode=IEC`
General Meeting in a period	`/harmonized/meetings?type=GM&sortBy=urn&meetingFromFrom=2024-10-14&meetingFromTo=2024-10-25&tenantCode=IEC`
Meetings of a committee	`/harmonized/meetings?committeeUrn=iec:committee:1224&sortBy=urn&tenantCode=IEC`
All IEC meetings	`/harmonized/meetings?sortBy=urn&tenantCode=IEC`
All CENELEC meetings	`/harmonized/meetings?sortBy=urn&tenantCode=CENELEC`

All URLs are relative to https://api.iec.ch.