1openapi: '3.0.2'
2info:
3 title: "Bundestag: Lobbyregister API"
4 version: '1.6' # According to the latest newsletter
5
6servers:
5
6servers:
7 - url: https://www.lobbyregister.bundestag.de/
8
9paths:
10 /sucheDetailJson:
16 description: "The text to search for. Will search in all text fields.\n\nLeave empty to retrieve all registrations"
17 in: query
18 schema:
19 type: string
20 - name: "sort"
21 in: query
54 - searchDate
55 properties:
56 source:
57 type: string
58 default: "Deutscher Bundestag, Lobbyregister für die Interessenvertretung gegenüber dem Deutschen Bundestag und der Bundesregierung"
59 sourceUrl:
57 type: string
58 default: "Deutscher Bundestag, Lobbyregister für die Interessenvertretung gegenüber dem Deutschen Bundestag und der Bundesregierung"
59 sourceUrl:
60 type: string
61 default: "https://www.lobbyregister.bundestag.de"
62 searchUrl:
66 type: string
67 example: "2022-03-01T17:55:09.667Z"
68 searchParameters:
69 type: object
70 required:
71 - queryString
86 items:
87 $ref: "#/components/schemas/NumberRange"
88 resultCount:
89 type: integer
90 results:
91 $ref: "#/components/schemas/SearchResult"
154 - "-"
155 example: "BOTH"
156 employeeCount:
157 type: object
158 description: Number of lobbying employees, in increments of ten.
159 required:
169 refuseFinancialExpensesInformation:
170 type: boolean
171 financialExpensesEuro:
172 type: object
173 required:
174 - "from"
197 description: |
198 True, if this entity received more than € 20,000 of donations from a single donor in the last calendar year
199 locationOfReportPublication:
200 type: string
201 account:
202 type: object
199 locationOfReportPublication:
200 type: string
201 account:
202 type: object
203 properties:
204 registerNumber:
208 type: string
209 example: "2022-03-01T17:42:53.000Z"
210 activityDescription:
211 type: string
212 activityOperationType:
213 type: string
227 lobbyistIdentity:
228 $ref: "#/components/schemas/LobbyistIdentity"
229 legislativeProjects:
230 type: array
231 items:
232 $ref: "#/components/schemas/LegislativeProject"
233 donators:
234 $ref: "#/components/schemas/Donator"
235 fieldsOfInterest:
236 type: array
237 items:
238 $ref: "#/components/schemas/FieldOfInterest"
237 items:
238 $ref: "#/components/schemas/FieldOfInterest"
239 clientOrganizations:
240 type: array
241 items:
242 $ref: "#/components/schemas/ClientOrganization"
241 items:
242 $ref: "#/components/schemas/ClientOrganization"
243 clientPersons:
244 type: array
245 items:
246 $ref: "#/components/schemas/NamedEmployee"
245 items:
246 $ref: "#/components/schemas/NamedEmployee"
247 registerEntryMedia:
248 type: array
249 items:
250 $ref: "#/components/schemas/Media"
255 annualReportExist:
256 type: boolean
257 missingAnnualReportReason:
258 type: string
259
260 Activity:
315 - "Think tank, research institution or university"
316 - "Trade association"
317 text:
318 type: string
319
320 LobbyistIdentity:
329 - "ORGANIZATION"
330 - "NATURAL"
331 name:
332 type: string
333 phoneNumber:
334 type: string
348 type: string
349 example: "https://acme.org"
350 legalRepresentatives:
351 type: array
352 items:
353 $ref: "#/components/schemas/LegalRepresentative"
352 items:
353 $ref: "#/components/schemas/LegalRepresentative"
354 namedEmployees:
355 type: array
356 items:
357 $ref: "#/components/schemas/NamedEmployee"
394 type: string
395 example: "121314"
396 country:
397 type: object
398 properties:
399 code:
400 type: string
401 example: "DE"
402 nationalAdditional1:
403 type: string
404 nationalAdditional2:
405 type: string
402 nationalAdditional1:
403 type: string
404 nationalAdditional2:
405 type: string
406 internationalAdditional1:
407 type: string
404 nationalAdditional2:
405 type: string
406 internationalAdditional1:
407 type: string
408 internationalAdditional2:
409 type: string
406 internationalAdditional1:
407 type: string
408 internationalAdditional2:
409 type: string
410
411 LegalForm:
429 - "OTHER_ASSOCIATION_OF_PERSONS"
430 - "NETWORK_PLATFORM_OR_OTHER"
431 legalFormText:
432 type: string
433
434 LegalRepresentative:
498 type: string
499 example: "Europäische Union"
500 description:
501 type: string
502 location:
503 type: string
509 type: string
510 example: "09/21"
511 donationEuro:
512 type: object
513 description: Received money in € 10,000 increments.
514 required:
691 type: string
692 example: "Economy"
693 fieldOfInterestText:
694 type: string
695 description: "Field of interest if code is `FOI_OTHER`"
696
706 type: string
707 example: "Gute Wirtschaft GmbH"
708 phoneNumber:
709 type: string
710 address:
711 $ref: "#/components/schemas/Address"
722 type: string
723 example: "https://gute-wirtschaft.de"
724 legalRepresentatives:
725 type: array
726 items:
727 $ref: "#/components/schemas/LegalRepresentative"
738 - "CODE_OF_CONDUCT"
739 - "ANNUAL_REPORT"
740 media:
741 type: object
742 required:
743 - "fileName"
9paths:
10 /sucheDetailJson:
11 get:
12 summary: "Search through all registrations"
13 operationId: "sucheDetailJson"
14 parameters:
9paths:
10 /sucheDetailJson:
11 get:
12 summary: "Search through all registrations"
13 operationId: "sucheDetailJson"
14 parameters:
1openapi: '3.0.2'
2info:
3 title: "Bundestag: Lobbyregister API"
4 version: '1.6' # According to the latest newsletter
5
6servers:
9paths:
10 /sucheDetailJson:
11 get:
12 summary: "Search through all registrations"
13 operationId: "sucheDetailJson"
14 parameters:
9paths:
10 /sucheDetailJson:
11 get:
12 summary: "Search through all registrations"
13 operationId: "sucheDetailJson"
14 parameters:
5
6servers:
7 - url: https://www.lobbyregister.bundestag.de/
8
9paths:
10 /sucheDetailJson:
16 description: "The text to search for. Will search in all text fields.\n\nLeave empty to retrieve all registrations"
17 in: query
18 schema:
19 type: string
20 - name: "sort"
21 in: query
54 - searchDate
55 properties:
56 source:
57 type: string
58 default: "Deutscher Bundestag, Lobbyregister für die Interessenvertretung gegenüber dem Deutschen Bundestag und der Bundesregierung"
59 sourceUrl:
57 type: string
58 default: "Deutscher Bundestag, Lobbyregister für die Interessenvertretung gegenüber dem Deutschen Bundestag und der Bundesregierung"
59 sourceUrl:
60 type: string
61 default: "https://www.lobbyregister.bundestag.de"
62 searchUrl:
66 type: string
67 example: "2022-03-01T17:55:09.667Z"
68 searchParameters:
69 type: object
70 required:
71 - queryString
86 items:
87 $ref: "#/components/schemas/NumberRange"
88 resultCount:
89 type: integer
90 results:
91 $ref: "#/components/schemas/SearchResult"
154 - "-"
155 example: "BOTH"
156 employeeCount:
157 type: object
158 description: Number of lobbying employees, in increments of ten.
159 required:
169 refuseFinancialExpensesInformation:
170 type: boolean
171 financialExpensesEuro:
172 type: object
173 required:
174 - "from"
197 description: |
198 True, if this entity received more than € 20,000 of donations from a single donor in the last calendar year
199 locationOfReportPublication:
200 type: string
201 account:
202 type: object
199 locationOfReportPublication:
200 type: string
201 account:
202 type: object
203 properties:
204 registerNumber:
208 type: string
209 example: "2022-03-01T17:42:53.000Z"
210 activityDescription:
211 type: string
212 activityOperationType:
213 type: string
227 lobbyistIdentity:
228 $ref: "#/components/schemas/LobbyistIdentity"
229 legislativeProjects:
230 type: array
231 items:
232 $ref: "#/components/schemas/LegislativeProject"
233 donators:
234 $ref: "#/components/schemas/Donator"
235 fieldsOfInterest:
236 type: array
237 items:
238 $ref: "#/components/schemas/FieldOfInterest"
237 items:
238 $ref: "#/components/schemas/FieldOfInterest"
239 clientOrganizations:
240 type: array
241 items:
242 $ref: "#/components/schemas/ClientOrganization"
241 items:
242 $ref: "#/components/schemas/ClientOrganization"
243 clientPersons:
244 type: array
245 items:
246 $ref: "#/components/schemas/NamedEmployee"
245 items:
246 $ref: "#/components/schemas/NamedEmployee"
247 registerEntryMedia:
248 type: array
249 items:
250 $ref: "#/components/schemas/Media"
255 annualReportExist:
256 type: boolean
257 missingAnnualReportReason:
258 type: string
259
260 Activity:
315 - "Think tank, research institution or university"
316 - "Trade association"
317 text:
318 type: string
319
320 LobbyistIdentity:
329 - "ORGANIZATION"
330 - "NATURAL"
331 name:
332 type: string
333 phoneNumber:
334 type: string
348 type: string
349 example: "https://acme.org"
350 legalRepresentatives:
351 type: array
352 items:
353 $ref: "#/components/schemas/LegalRepresentative"
352 items:
353 $ref: "#/components/schemas/LegalRepresentative"
354 namedEmployees:
355 type: array
356 items:
357 $ref: "#/components/schemas/NamedEmployee"
394 type: string
395 example: "121314"
396 country:
397 type: object
398 properties:
399 code:
400 type: string
401 example: "DE"
402 nationalAdditional1:
403 type: string
404 nationalAdditional2:
405 type: string
402 nationalAdditional1:
403 type: string
404 nationalAdditional2:
405 type: string
406 internationalAdditional1:
407 type: string
404 nationalAdditional2:
405 type: string
406 internationalAdditional1:
407 type: string
408 internationalAdditional2:
409 type: string
406 internationalAdditional1:
407 type: string
408 internationalAdditional2:
409 type: string
410
411 LegalForm:
429 - "OTHER_ASSOCIATION_OF_PERSONS"
430 - "NETWORK_PLATFORM_OR_OTHER"
431 legalFormText:
432 type: string
433
434 LegalRepresentative:
498 type: string
499 example: "Europäische Union"
500 description:
501 type: string
502 location:
503 type: string
509 type: string
510 example: "09/21"
511 donationEuro:
512 type: object
513 description: Received money in € 10,000 increments.
514 required:
691 type: string
692 example: "Economy"
693 fieldOfInterestText:
694 type: string
695 description: "Field of interest if code is `FOI_OTHER`"
696
706 type: string
707 example: "Gute Wirtschaft GmbH"
708 phoneNumber:
709 type: string
710 address:
711 $ref: "#/components/schemas/Address"
722 type: string
723 example: "https://gute-wirtschaft.de"
724 legalRepresentatives:
725 type: array
726 items:
727 $ref: "#/components/schemas/LegalRepresentative"
738 - "CODE_OF_CONDUCT"
739 - "ANNUAL_REPORT"
740 media:
741 type: object
742 required:
743 - "fileName"