--- title: "GET /pub/v1/publications" method: GET path: "/pub/v1/publications" --- # GET /pub/v1/publications `GET /pub/v1/publications` Retrieve publications. At most 10 publications are returned with each call. For more, repeat the call setting the pos parameter to the newPos attribute value of the response. ## Query parameters - `id` string - `minDate` string, date - `maxDate` string, date - `minTimestamp` string, date-time - `maxTimestamp` string, date-time - `minPublicationDate` string, date - `maxPublicationDate` string, date - `sources` unknown[] - unknown - `source` string, required - `content` boolean - `attachments` boolean - `publisherHistory` boolean - `publisherFinancials` boolean - `publisherRelations` boolean - `publisherEvents` boolean - `publisherExtras` boolean - `publisherSheets` boolean - `pos` string - `censor` boolean - `output` 'json' | 'xml' ## Response `200` A successful response - GenericResponse - `newPos` string - `publications` Publication[] - `id` string, required — interne ID - `date` string, date — publishing date - `effectiveDate` string, date — date when published changes became effective (e.g., appointment of new director) - `creationTime` string, date-time — database creation time (which is right after the initial publication download) - `source` string, required — Source identifier, for a complete list see [Source reference](https://www.northdata.com/_coverage#sources) - `sourceName` string — full name of source - `category` string — category under which publication was filed in the original source - `originalLanguage` string — ISO language code - `language` string — ISO language code. This is different from the original language, for translations only. - `title` string, required — title of publication - `northDataUrl` string — North data web page for this publication - `text` string — raw text of the publication - `html` string — text of publication in HTML format - `publisher` Company — All data for a particular company - `id` string, required — internal company id (do not store this id in an external database, it may change over time) - `name` CompanyName, required - `name` string, required — name of a company - `legalForm` string — legal form (for example: A/S, AG, AG & Co. KG, AöR, Co. KG, d.o.o., e. K., e. V., eG, EWIV, gAG, GbR, gGmbH, GmbH, GmbH & Co. KG, gSE, gUG, Inh., InvAG, KG, KGaA, KGaA & Co. KG, Ltd., Ltd. & Co. KG, OHG, PartGG, plc, REITG, S.L., SCE, SCE, SCE mbH, SE, SE & Co. KG, Stiftung & Co. KG, UG, UG & Co. KG, VVaG) - `rawName` string — May provide the raw name found in register sources before applying normalizations and spelling fixes - `address` Address, required - `street` string — street and house number - `extra` string — extra address information (such as c/o) - `postalCode` string — postal code - `city` string, required — city - `state` string — state - `country` string, required — two-letter ISO country code - `lat` number, double — geo coordinates, latitude part - `lng` number, double — geo coordinates, longitude part - `formattedValue` string — the whole address in one human readable string - `register` Register — register entry information (e.g., Amtsgericht Hamburg HRB 9999) - `country` string — register country (two-letter ISO code) - `city` string — city of the register court (e.g. Hamburg). Empty for most countries. - `id` string, required — ID of the register filing (e.g. HRB 9999) - `uniqueKey` string — unique numerical key for repeatably unique identification of the register entry - `lei` string — International Legal Entity Identifier (LEI) - `euId` string — European Unique Identifier (EUID) - `elfCode` string — current entity legal form code according to ISO 20275 - `subject` string — subject according to register filing (also called corporate object, purpose, Unternehmensgegenstand), possibly translated - `originalSubject` string — subject according to register filing (also called corporate object, purpose, Unternehmensgegenstand), in the original language - `originalSubjectLang` string — original language of the subject - `proxyPolicy` string — rules for representation by legal representatives (e.g., signatory authority) - `segmentCodes` object — each property (naics, isic, nace, wz, uksic) contains a list of segment codes in respective standard classification - `northDataUrl` string — North data web page for this company - `terminated` boolean — company has been terminated - `status` 'active' | 'liquidation' | 'terminated' — current status of the company, where liquidation is the intermediate state before the final removal from the register (=terminated) - `history` CompanyHistory - `names` CompanyNameHistoryItem[] — name history of a company - `name` CompanyName, required - `name` string, required — name of a company - `legalForm` string — legal form (for example: A/S, AG, AG & Co. KG, AöR, Co. KG, d.o.o., e. K., e. V., eG, EWIV, gAG, GbR, gGmbH, GmbH, GmbH & Co. KG, gSE, gUG, Inh., InvAG, KG, KGaA, KGaA & Co. KG, Ltd., Ltd. & Co. KG, OHG, PartGG, plc, REITG, S.L., SCE, SCE, SCE mbH, SE, SE & Co. KG, Stiftung & Co. KG, UG, UG & Co. KG, VVaG) - `date` string, date — since when the referred company name is (known to be) in use - `addresses` AddressHistoryItem[] — adress history of a company - `address` Address, required - `street` string — street and house number - `extra` string — extra address information (such as c/o) - `postalCode` string — postal code - `city` string, required — city - `state` string — state - `country` string, required — two-letter ISO country code - `lat` number, double — geo coordinates, latitude part - `lng` number, double — geo coordinates, longitude part - `formattedValue` string — the whole address in one human readable string - `date` string, date — since when the referred address is (known to be) in use - `registers` RegisterHistoryItem[] — register entry history of a company - `register` Register, required — register entry information (e.g., Amtsgericht Hamburg HRB 9999) - `country` string — register country (two-letter ISO code) - `city` string — city of the register court (e.g. Hamburg). Empty for most countries. - `id` string, required — ID of the register filing (e.g. HRB 9999) - `uniqueKey` string — unique numerical key for repeatably unique identification of the register entry - `date` string, date — since when this registry entry is valid - `financials` Financials[] — historical financial data - `date` string, date, required — reference date - `formattedDate` string, required — date formatted as a string (depending on the language settings) - `consolidated` boolean, required — true if the financial data refer to a consolidated balance (Konzernabschluss) - `source` FinancialsSource — source of financial data - `publicationId` string — internal publication ID - `publicationTitle` string, required — publication title such as "Jahresabschluss 2015" - `publicationDate` string, date, required — date the publication was published - `auditorName` string — name of auditing company - `snippets` SourceSnippet[] — excerpts from the original publication containing the financial data - … - `items` Financial[], required — list of financial numbers (maybe empty. If empty, see note for the reason) - `id` string, required — type of number (for example, revenue). Please see the [indicator reference](https://www.northdata.com/_coverage#indicators) for a complete list - `name` string, required — name in current language (for example, Umsatz in German or Revenue in English) - `value` number, double, required — actual value - `unit` string — unit or currency (EUR, % or empty) - `estimate` boolean — true if the value is not exact (because it relies on an estimate or an unsafe determination method) - `note` string — optional note or comment with respect to the calculation of the financial - `formattedValue` string, required — value formatted as a string (depending on the language settings) - `note` FinancialsNote — additional explanation of financials (or of their absence) - `text` string, required — explanation as plain text - `html` string, required — explanation as html - `mktgTechIndicators` Financials[] — historical financial data - `date` string, date, required — reference date - `formattedDate` string, required — date formatted as a string (depending on the language settings) - `consolidated` boolean, required — true if the financial data refer to a consolidated balance (Konzernabschluss) - `source` FinancialsSource — source of financial data - `publicationId` string — internal publication ID - `publicationTitle` string, required — publication title such as "Jahresabschluss 2015" - `publicationDate` string, date, required — date the publication was published - `auditorName` string — name of auditing company - `snippets` SourceSnippet[] — excerpts from the original publication containing the financial data - … - `items` Financial[], required — list of financial numbers (maybe empty. If empty, see note for the reason) - `id` string, required — type of number (for example, revenue). Please see the [indicator reference](https://www.northdata.com/_coverage#indicators) for a complete list - `name` string, required — name in current language (for example, Umsatz in German or Revenue in English) - `value` number, double, required — actual value - `unit` string — unit or currency (EUR, % or empty) - `estimate` boolean — true if the value is not exact (because it relies on an estimate or an unsafe determination method) - `note` string — optional note or comment with respect to the calculation of the financial - `formattedValue` string, required — value formatted as a string (depending on the language settings) - `note` FinancialsNote — additional explanation of financials (or of their absence) - `text` string, required — explanation as plain text - `html` string, required — explanation as html - `capital` Financials — financial data - `date` string, date, required — reference date - `formattedDate` string, required — date formatted as a string (depending on the language settings) - `consolidated` boolean, required — true if the financial data refer to a consolidated balance (Konzernabschluss) - `source` FinancialsSource — source of financial data - `publicationId` string — internal publication ID - `publicationTitle` string, required — publication title such as "Jahresabschluss 2015" - `publicationDate` string, date, required — date the publication was published - `auditorName` string — name of auditing company - `snippets` SourceSnippet[] — excerpts from the original publication containing the financial data - `title` string, required — title - `content` string, required — text - `contentType` string — content format, usually "text/html" - `items` Financial[], required — list of financial numbers (maybe empty. If empty, see note for the reason) - `id` string, required — type of number (for example, revenue). Please see the [indicator reference](https://www.northdata.com/_coverage#indicators) for a complete list - `name` string, required — name in current language (for example, Umsatz in German or Revenue in English) - `value` number, double, required — actual value - `unit` string — unit or currency (EUR, % or empty) - `estimate` boolean — true if the value is not exact (because it relies on an estimate or an unsafe determination method) - `note` string — optional note or comment with respect to the calculation of the financial - `formattedValue` string, required — value formatted as a string (depending on the language settings) - `note` FinancialsNote — additional explanation of financials (or of their absence) - `text` string, required — explanation as plain text - `html` string, required — explanation as html - `financials` Financials — financial data - `date` string, date, required — reference date - `formattedDate` string, required — date formatted as a string (depending on the language settings) - `consolidated` boolean, required — true if the financial data refer to a consolidated balance (Konzernabschluss) - `source` FinancialsSource — source of financial data - `publicationId` string — internal publication ID - `publicationTitle` string, required — publication title such as "Jahresabschluss 2015" - `publicationDate` string, date, required — date the publication was published - `auditorName` string — name of auditing company - `snippets` SourceSnippet[] — excerpts from the original publication containing the financial data - `title` string, required — title - `content` string, required — text - `contentType` string — content format, usually "text/html" - `items` Financial[], required — list of financial numbers (maybe empty. If empty, see note for the reason) - `id` string, required — type of number (for example, revenue). Please see the [indicator reference](https://www.northdata.com/_coverage#indicators) for a complete list - `name` string, required — name in current language (for example, Umsatz in German or Revenue in English) - `value` number, double, required — actual value - `unit` string — unit or currency (EUR, % or empty) - `estimate` boolean — true if the value is not exact (because it relies on an estimate or an unsafe determination method) - `note` string — optional note or comment with respect to the calculation of the financial - `formattedValue` string, required — value formatted as a string (depending on the language settings) - `note` FinancialsNote — additional explanation of financials (or of their absence) - `text` string, required — explanation as plain text - `html` string, required — explanation as html - `mktgTechIndicators` Financials — financial data - `date` string, date, required — reference date - `formattedDate` string, required — date formatted as a string (depending on the language settings) - `consolidated` boolean, required — true if the financial data refer to a consolidated balance (Konzernabschluss) - `source` FinancialsSource — source of financial data - `publicationId` string — internal publication ID - `publicationTitle` string, required — publication title such as "Jahresabschluss 2015" - `publicationDate` string, date, required — date the publication was published - `auditorName` string — name of auditing company - `snippets` SourceSnippet[] — excerpts from the original publication containing the financial data - `title` string, required — title - `content` string, required — text - `contentType` string — content format, usually "text/html" - `items` Financial[], required — list of financial numbers (maybe empty. If empty, see note for the reason) - `id` string, required — type of number (for example, revenue). Please see the [indicator reference](https://www.northdata.com/_coverage#indicators) for a complete list - `name` string, required — name in current language (for example, Umsatz in German or Revenue in English) - `value` number, double, required — actual value - `unit` string — unit or currency (EUR, % or empty) - `estimate` boolean — true if the value is not exact (because it relies on an estimate or an unsafe determination method) - `note` string — optional note or comment with respect to the calculation of the financial - `formattedValue` string, required — value formatted as a string (depending on the language settings) - `note` FinancialsNote — additional explanation of financials (or of their absence) - `text` string, required — explanation as plain text - `html` string, required — explanation as html - `oflagsIndicators` Financials — financial data - `date` string, date, required — reference date - `formattedDate` string, required — date formatted as a string (depending on the language settings) - `consolidated` boolean, required — true if the financial data refer to a consolidated balance (Konzernabschluss) - `source` FinancialsSource — source of financial data - `publicationId` string — internal publication ID - `publicationTitle` string, required — publication title such as "Jahresabschluss 2015" - `publicationDate` string, date, required — date the publication was published - `auditorName` string — name of auditing company - `snippets` SourceSnippet[] — excerpts from the original publication containing the financial data - `title` string, required — title - `content` string, required — text - `contentType` string — content format, usually "text/html" - `items` Financial[], required — list of financial numbers (maybe empty. If empty, see note for the reason) - `id` string, required — type of number (for example, revenue). Please see the [indicator reference](https://www.northdata.com/_coverage#indicators) for a complete list - `name` string, required — name in current language (for example, Umsatz in German or Revenue in English) - `value` number, double, required — actual value - `unit` string — unit or currency (EUR, % or empty) - `estimate` boolean — true if the value is not exact (because it relies on an estimate or an unsafe determination method) - `note` string — optional note or comment with respect to the calculation of the financial - `formattedValue` string, required — value formatted as a string (depending on the language settings) - `note` FinancialsNote — additional explanation of financials (or of their absence) - `text` string, required — explanation as plain text - `html` string, required — explanation as html - `events` Events — list of events - `items` Event[], required — the list of events - `type` string — one of ... - `date` string, date — when it happened - `description` string — human-readable description of what happend - `extras` Extras[] — extra data provided by 3rd parties - `sourceName` string — name of the source - `sourceUrl` string — url of the source - `items` Extra[] — extra data items in this set - `id` string, required — common ids are: email, url, phone, fax, vatId, wz - `name` string, required — describing name (for example, "Email" with English language settings, "E-Mail" with German language settigns) - `value` string, required — actual value - `formattedHtmlValue` string, required — value formatted as an HTML string - `sheets` Sheet[] — company's financial sheets (such as balance and earnings sheets) - `columnHeaders` SheetColumnHeader[], required — list of column headers - `date` string, date, required — the date of entries in this column - `source` FinancialsSource — source of financial data - `publicationId` string — internal publication ID - `publicationTitle` string, required — publication title such as "Jahresabschluss 2015" - `publicationDate` string, date, required — date the publication was published - `auditorName` string — name of auditing company - `snippets` SourceSnippet[] — excerpts from the original publication containing the financial data - … - `rows` SheetRow[], required — list of rows - `name` string, required — name of row - `level` integer — if the sheet is structured as a tree, indicates the depth of the nesting of this row. - `cells` SheetCell[], required — list of cells - `value` number, double — numeric value - `type` 'balance' | 'earnings' | 'cashflow', required — the kind of financial data reported in this sheet - `consolidated` boolean, required — true if the financial is consolidated (including dependent companies) or not (excluding) - `reporting` 'HGB' | 'IFRS' | 'GAAP' — the reporting standard used - `unit` string — unit or currency (EUR, % or empty) - `relatedCompanies` Relations — list of related companies / persons - `items` Relation[], required - `company` Company — recursive - `person` Person - `id` string, required — internal person id (do not store this id in an external database, it may change over time) - `name` PersonName, required - … - `address` Address - … - `birthDate` string, date — Birth date - `birthYear` integer — Sometimes only the birth years is known, but not the exact date - `birthMonth` integer — Sometimes only birth year and month are known, but not the exact date - `deceased` boolean — person is known to be dead - `northDataUrl` string — North data web page for this person - `relatedCompanies` Relations — recursive - `filings` Filing[] — external source-specific IDs - … - `blocked` boolean — person data should not be publicly on the Internet because of a request for privacy protection - `lastUpdateTime` string, date-time — last time this person was updated - `description` string — human readable short summary - `roles` Role[], required — description of the type of the relation - `date` string, date — date - `name` string, required — description (depending on the current language settings) - `detail` string — depending on role and country - `demotion` boolean — true if the relation ends at the given date - `announce` boolean — true if the relation might be preliminary - `type` string, required — internal identifier (for possible values, see Appendix F of the API User Guide) - `group` 'Succession' | 'Control' | 'Merger' | 'Personal' | 'Other' | 'Interest', required — internal group identifier - `dir` 'None' | 'Source' | 'Target' | 'Bi' — Direction. The exact interpretation depends of the value of the field "group". See the API User Guide for details. - `sharesPercent` number, double — shares in percent - `sharesNominal` object — nominal shares - … - `relatedPersons` Relations — list of related companies / persons - `items` Relation[], required - `company` Company — recursive - `person` Person - `id` string, required — internal person id (do not store this id in an external database, it may change over time) - `name` PersonName, required - … - `address` Address - … - `birthDate` string, date — Birth date - `birthYear` integer — Sometimes only the birth years is known, but not the exact date - `birthMonth` integer — Sometimes only birth year and month are known, but not the exact date - `deceased` boolean — person is known to be dead - `northDataUrl` string — North data web page for this person - `relatedCompanies` Relations — recursive - `filings` Filing[] — external source-specific IDs - … - `blocked` boolean — person data should not be publicly on the Internet because of a request for privacy protection - `lastUpdateTime` string, date-time — last time this person was updated - `description` string — human readable short summary - `roles` Role[], required — description of the type of the relation - `date` string, date — date - `name` string, required — description (depending on the current language settings) - `detail` string — depending on role and country - `demotion` boolean — true if the relation ends at the given date - `announce` boolean — true if the relation might be preliminary - `type` string, required — internal identifier (for possible values, see Appendix F of the API User Guide) - `group` 'Succession' | 'Control' | 'Merger' | 'Personal' | 'Other' | 'Interest', required — internal group identifier - `dir` 'None' | 'Source' | 'Target' | 'Bi' — Direction. The exact interpretation depends of the value of the field "group". See the API User Guide for details. - `sharesPercent` number, double — shares in percent - `sharesNominal` object — nominal shares - … - `filings` Filing[] — external source-specific IDs - `type` string — filing type - `name` string — complete string - `source` string — Source identifier, for a complete list see [Source reference](https://www.northdata.com/_coverage#sources) - `city` string — city (only for German insolvency filings) - `id` string, required — external ID (e.g., 36w IN 3284/16 for insolvency filings) - `flags` Flag[] — risk flags associated with the company - `name` string, required — name of the flag - `definition` string, required — criteria for setting the flag - `level` string, required — red represents high risk, yellow represents medium risk - `explanation` string — reasoning behind the set flag - `overallRiskLevel` string — green for lowest, yellow for medium, red for high overall risk - `blocked` boolean — company data should not be publicly on the Internet because of a request for privacy protection - `lastUpdateTime` string, date-time — last time this company was updated - `structure` PublicationStructure — result of the structural analysis of a publication - `topics` Topic[] — topics of the publication - `name` string, required — textual description - `value` string — accompanying value (e.g., €100.000,-) - `type` string, required — internal identificator for the topic (for possible values, see Appendix E of the user's guide) - `mentionedCompanies` Relations — list of related companies / persons - `items` Relation[], required - `company` Company — All data for a particular company - `id` string, required — internal company id (do not store this id in an external database, it may change over time) - `name` CompanyName, required - `name` string, required — name of a company - `legalForm` string — legal form (for example: A/S, AG, AG & Co. KG, AöR, Co. KG, d.o.o., e. K., e. V., eG, EWIV, gAG, GbR, gGmbH, GmbH, GmbH & Co. KG, gSE, gUG, Inh., InvAG, KG, KGaA, KGaA & Co. KG, Ltd., Ltd. & Co. KG, OHG, PartGG, plc, REITG, S.L., SCE, SCE, SCE mbH, SE, SE & Co. KG, Stiftung & Co. KG, UG, UG & Co. KG, VVaG) - `rawName` string — May provide the raw name found in register sources before applying normalizations and spelling fixes - `address` Address, required - `street` string — street and house number - `extra` string — extra address information (such as c/o) - `postalCode` string — postal code - `city` string, required — city - `state` string — state - `country` string, required — two-letter ISO country code - `lat` number, double — geo coordinates, latitude part - `lng` number, double — geo coordinates, longitude part - `formattedValue` string — the whole address in one human readable string - `register` Register — register entry information (e.g., Amtsgericht Hamburg HRB 9999) - `country` string — register country (two-letter ISO code) - `city` string — city of the register court (e.g. Hamburg). Empty for most countries. - `id` string, required — ID of the register filing (e.g. HRB 9999) - `uniqueKey` string — unique numerical key for repeatably unique identification of the register entry - `lei` string — International Legal Entity Identifier (LEI) - `euId` string — European Unique Identifier (EUID) - `elfCode` string — current entity legal form code according to ISO 20275 - `subject` string — subject according to register filing (also called corporate object, purpose, Unternehmensgegenstand), possibly translated - `originalSubject` string — subject according to register filing (also called corporate object, purpose, Unternehmensgegenstand), in the original language - `originalSubjectLang` string — original language of the subject - `proxyPolicy` string — rules for representation by legal representatives (e.g., signatory authority) - `segmentCodes` object — each property (naics, isic, nace, wz, uksic) contains a list of segment codes in respective standard classification - `northDataUrl` string — North data web page for this company - `terminated` boolean — company has been terminated - `status` 'active' | 'liquidation' | 'terminated' — current status of the company, where liquidation is the intermediate state before the final removal from the register (=terminated) - `history` CompanyHistory - `names` CompanyNameHistoryItem[] — name history of a company - … - `addresses` AddressHistoryItem[] — adress history of a company - … - `registers` RegisterHistoryItem[] — register entry history of a company - … - `financials` Financials[] — historical financial data - … - `mktgTechIndicators` Financials[] — historical financial data - … - `capital` Financials — financial data - `date` string, date, required — reference date - `formattedDate` string, required — date formatted as a string (depending on the language settings) - `consolidated` boolean, required — true if the financial data refer to a consolidated balance (Konzernabschluss) - `source` FinancialsSource — source of financial data - … - `items` Financial[], required — list of financial numbers (maybe empty. If empty, see note for the reason) - … - `note` FinancialsNote — additional explanation of financials (or of their absence) - … - `financials` Financials — financial data - `date` string, date, required — reference date - `formattedDate` string, required — date formatted as a string (depending on the language settings) - `consolidated` boolean, required — true if the financial data refer to a consolidated balance (Konzernabschluss) - `source` FinancialsSource — source of financial data - … - `items` Financial[], required — list of financial numbers (maybe empty. If empty, see note for the reason) - … - `note` FinancialsNote — additional explanation of financials (or of their absence) - … - `mktgTechIndicators` Financials — financial data - `date` string, date, required — reference date - `formattedDate` string, required — date formatted as a string (depending on the language settings) - `consolidated` boolean, required — true if the financial data refer to a consolidated balance (Konzernabschluss) - `source` FinancialsSource — source of financial data - … - `items` Financial[], required — list of financial numbers (maybe empty. If empty, see note for the reason) - … - `note` FinancialsNote — additional explanation of financials (or of their absence) - … - `oflagsIndicators` Financials — financial data - `date` string, date, required — reference date - `formattedDate` string, required — date formatted as a string (depending on the language settings) - `consolidated` boolean, required — true if the financial data refer to a consolidated balance (Konzernabschluss) - `source` FinancialsSource — source of financial data - … - `items` Financial[], required — list of financial numbers (maybe empty. If empty, see note for the reason) - … - `note` FinancialsNote — additional explanation of financials (or of their absence) - … - `events` Events — list of events - `items` Event[], required — the list of events - … - `extras` Extras[] — extra data provided by 3rd parties - `sourceName` string — name of the source - `sourceUrl` string — url of the source - `items` Extra[] — extra data items in this set - … - `sheets` Sheet[] — company's financial sheets (such as balance and earnings sheets) - `columnHeaders` SheetColumnHeader[], required — list of column headers - … - `rows` SheetRow[], required — list of rows - … - `type` 'balance' | 'earnings' | 'cashflow', required — the kind of financial data reported in this sheet - `consolidated` boolean, required — true if the financial is consolidated (including dependent companies) or not (excluding) - `reporting` 'HGB' | 'IFRS' | 'GAAP' — the reporting standard used - `unit` string — unit or currency (EUR, % or empty) - `relatedCompanies` Relations — recursive - `relatedPersons` Relations — recursive - `filings` Filing[] — external source-specific IDs - `type` string — filing type - `name` string — complete string - `source` string — Source identifier, for a complete list see [Source reference](https://www.northdata.com/_coverage#sources) - `city` string — city (only for German insolvency filings) - `id` string, required — external ID (e.g., 36w IN 3284/16 for insolvency filings) - `flags` Flag[] — risk flags associated with the company - `name` string, required — name of the flag - `definition` string, required — criteria for setting the flag - `level` string, required — red represents high risk, yellow represents medium risk - `explanation` string — reasoning behind the set flag - `overallRiskLevel` string — green for lowest, yellow for medium, red for high overall risk - `blocked` boolean — company data should not be publicly on the Internet because of a request for privacy protection - `lastUpdateTime` string, date-time — last time this company was updated - `person` Person - `id` string, required — internal person id (do not store this id in an external database, it may change over time) - `name` PersonName, required - `firstName` string — first name(s) - `lastName` string, required — last name - `title` string — title - `address` Address - `street` string — street and house number - `extra` string — extra address information (such as c/o) - `postalCode` string — postal code - `city` string, required — city - `state` string — state - `country` string, required — two-letter ISO country code - `lat` number, double — geo coordinates, latitude part - `lng` number, double — geo coordinates, longitude part - `formattedValue` string — the whole address in one human readable string - `birthDate` string, date — Birth date - `birthYear` integer — Sometimes only the birth years is known, but not the exact date - `birthMonth` integer — Sometimes only birth year and month are known, but not the exact date - `deceased` boolean — person is known to be dead - `northDataUrl` string — North data web page for this person - `relatedCompanies` Relations — recursive - `filings` Filing[] — external source-specific IDs - `type` string — filing type - `name` string — complete string - `source` string — Source identifier, for a complete list see [Source reference](https://www.northdata.com/_coverage#sources) - `city` string — city (only for German insolvency filings) - `id` string, required — external ID (e.g., 36w IN 3284/16 for insolvency filings) - `blocked` boolean — person data should not be publicly on the Internet because of a request for privacy protection - `lastUpdateTime` string, date-time — last time this person was updated - `description` string — human readable short summary - `roles` Role[], required — description of the type of the relation - `date` string, date — date - `name` string, required — description (depending on the current language settings) - `detail` string — depending on role and country - `demotion` boolean — true if the relation ends at the given date - `announce` boolean — true if the relation might be preliminary - `type` string, required — internal identifier (for possible values, see Appendix F of the API User Guide) - `group` 'Succession' | 'Control' | 'Merger' | 'Personal' | 'Other' | 'Interest', required — internal group identifier - `dir` 'None' | 'Source' | 'Target' | 'Bi' — Direction. The exact interpretation depends of the value of the field "group". See the API User Guide for details. - `sharesPercent` number, double — shares in percent - `sharesNominal` object — nominal shares - `value` number, double, required — actual value - `unit` string, required — unit or currency (EUR, % or empty) - `mentionedPersons` Relations — list of related companies / persons - `items` Relation[], required - `company` Company — All data for a particular company - `id` string, required — internal company id (do not store this id in an external database, it may change over time) - `name` CompanyName, required - `name` string, required — name of a company - `legalForm` string — legal form (for example: A/S, AG, AG & Co. KG, AöR, Co. KG, d.o.o., e. K., e. V., eG, EWIV, gAG, GbR, gGmbH, GmbH, GmbH & Co. KG, gSE, gUG, Inh., InvAG, KG, KGaA, KGaA & Co. KG, Ltd., Ltd. & Co. KG, OHG, PartGG, plc, REITG, S.L., SCE, SCE, SCE mbH, SE, SE & Co. KG, Stiftung & Co. KG, UG, UG & Co. KG, VVaG) - `rawName` string — May provide the raw name found in register sources before applying normalizations and spelling fixes - `address` Address, required - `street` string — street and house number - `extra` string — extra address information (such as c/o) - `postalCode` string — postal code - `city` string, required — city - `state` string — state - `country` string, required — two-letter ISO country code - `lat` number, double — geo coordinates, latitude part - `lng` number, double — geo coordinates, longitude part - `formattedValue` string — the whole address in one human readable string - `register` Register — register entry information (e.g., Amtsgericht Hamburg HRB 9999) - `country` string — register country (two-letter ISO code) - `city` string — city of the register court (e.g. Hamburg). Empty for most countries. - `id` string, required — ID of the register filing (e.g. HRB 9999) - `uniqueKey` string — unique numerical key for repeatably unique identification of the register entry - `lei` string — International Legal Entity Identifier (LEI) - `euId` string — European Unique Identifier (EUID) - `elfCode` string — current entity legal form code according to ISO 20275 - `subject` string — subject according to register filing (also called corporate object, purpose, Unternehmensgegenstand), possibly translated - `originalSubject` string — subject according to register filing (also called corporate object, purpose, Unternehmensgegenstand), in the original language - `originalSubjectLang` string — original language of the subject - `proxyPolicy` string — rules for representation by legal representatives (e.g., signatory authority) - `segmentCodes` object — each property (naics, isic, nace, wz, uksic) contains a list of segment codes in respective standard classification - `northDataUrl` string — North data web page for this company - `terminated` boolean — company has been terminated - `status` 'active' | 'liquidation' | 'terminated' — current status of the company, where liquidation is the intermediate state before the final removal from the register (=terminated) - `history` CompanyHistory - `names` CompanyNameHistoryItem[] — name history of a company - … - `addresses` AddressHistoryItem[] — adress history of a company - … - `registers` RegisterHistoryItem[] — register entry history of a company - … - `financials` Financials[] — historical financial data - … - `mktgTechIndicators` Financials[] — historical financial data - … - `capital` Financials — financial data - `date` string, date, required — reference date - `formattedDate` string, required — date formatted as a string (depending on the language settings) - `consolidated` boolean, required — true if the financial data refer to a consolidated balance (Konzernabschluss) - `source` FinancialsSource — source of financial data - … - `items` Financial[], required — list of financial numbers (maybe empty. If empty, see note for the reason) - … - `note` FinancialsNote — additional explanation of financials (or of their absence) - … - `financials` Financials — financial data - `date` string, date, required — reference date - `formattedDate` string, required — date formatted as a string (depending on the language settings) - `consolidated` boolean, required — true if the financial data refer to a consolidated balance (Konzernabschluss) - `source` FinancialsSource — source of financial data - … - `items` Financial[], required — list of financial numbers (maybe empty. If empty, see note for the reason) - … - `note` FinancialsNote — additional explanation of financials (or of their absence) - … - `mktgTechIndicators` Financials — financial data - `date` string, date, required — reference date - `formattedDate` string, required — date formatted as a string (depending on the language settings) - `consolidated` boolean, required — true if the financial data refer to a consolidated balance (Konzernabschluss) - `source` FinancialsSource — source of financial data - … - `items` Financial[], required — list of financial numbers (maybe empty. If empty, see note for the reason) - … - `note` FinancialsNote — additional explanation of financials (or of their absence) - … - `oflagsIndicators` Financials — financial data - `date` string, date, required — reference date - `formattedDate` string, required — date formatted as a string (depending on the language settings) - `consolidated` boolean, required — true if the financial data refer to a consolidated balance (Konzernabschluss) - `source` FinancialsSource — source of financial data - … - `items` Financial[], required — list of financial numbers (maybe empty. If empty, see note for the reason) - … - `note` FinancialsNote — additional explanation of financials (or of their absence) - … - `events` Events — list of events - `items` Event[], required — the list of events - … - `extras` Extras[] — extra data provided by 3rd parties - `sourceName` string — name of the source - `sourceUrl` string — url of the source - `items` Extra[] — extra data items in this set - … - `sheets` Sheet[] — company's financial sheets (such as balance and earnings sheets) - `columnHeaders` SheetColumnHeader[], required — list of column headers - … - `rows` SheetRow[], required — list of rows - … - `type` 'balance' | 'earnings' | 'cashflow', required — the kind of financial data reported in this sheet - `consolidated` boolean, required — true if the financial is consolidated (including dependent companies) or not (excluding) - `reporting` 'HGB' | 'IFRS' | 'GAAP' — the reporting standard used - `unit` string — unit or currency (EUR, % or empty) - `relatedCompanies` Relations — recursive - `relatedPersons` Relations — recursive - `filings` Filing[] — external source-specific IDs - `type` string — filing type - `name` string — complete string - `source` string — Source identifier, for a complete list see [Source reference](https://www.northdata.com/_coverage#sources) - `city` string — city (only for German insolvency filings) - `id` string, required — external ID (e.g., 36w IN 3284/16 for insolvency filings) - `flags` Flag[] — risk flags associated with the company - `name` string, required — name of the flag - `definition` string, required — criteria for setting the flag - `level` string, required — red represents high risk, yellow represents medium risk - `explanation` string — reasoning behind the set flag - `overallRiskLevel` string — green for lowest, yellow for medium, red for high overall risk - `blocked` boolean — company data should not be publicly on the Internet because of a request for privacy protection - `lastUpdateTime` string, date-time — last time this company was updated - `person` Person - `id` string, required — internal person id (do not store this id in an external database, it may change over time) - `name` PersonName, required - `firstName` string — first name(s) - `lastName` string, required — last name - `title` string — title - `address` Address - `street` string — street and house number - `extra` string — extra address information (such as c/o) - `postalCode` string — postal code - `city` string, required — city - `state` string — state - `country` string, required — two-letter ISO country code - `lat` number, double — geo coordinates, latitude part - `lng` number, double — geo coordinates, longitude part - `formattedValue` string — the whole address in one human readable string - `birthDate` string, date — Birth date - `birthYear` integer — Sometimes only the birth years is known, but not the exact date - `birthMonth` integer — Sometimes only birth year and month are known, but not the exact date - `deceased` boolean — person is known to be dead - `northDataUrl` string — North data web page for this person - `relatedCompanies` Relations — recursive - `filings` Filing[] — external source-specific IDs - `type` string — filing type - `name` string — complete string - `source` string — Source identifier, for a complete list see [Source reference](https://www.northdata.com/_coverage#sources) - `city` string — city (only for German insolvency filings) - `id` string, required — external ID (e.g., 36w IN 3284/16 for insolvency filings) - `blocked` boolean — person data should not be publicly on the Internet because of a request for privacy protection - `lastUpdateTime` string, date-time — last time this person was updated - `description` string — human readable short summary - `roles` Role[], required — description of the type of the relation - `date` string, date — date - `name` string, required — description (depending on the current language settings) - `detail` string — depending on role and country - `demotion` boolean — true if the relation ends at the given date - `announce` boolean — true if the relation might be preliminary - `type` string, required — internal identifier (for possible values, see Appendix F of the API User Guide) - `group` 'Succession' | 'Control' | 'Merger' | 'Personal' | 'Other' | 'Interest', required — internal group identifier - `dir` 'None' | 'Source' | 'Target' | 'Bi' — Direction. The exact interpretation depends of the value of the field "group". See the API User Guide for details. - `sharesPercent` number, double — shares in percent - `sharesNominal` object — nominal shares - `value` number, double, required — actual value - `unit` string, required — unit or currency (EUR, % or empty) - `filings` Filing[] — external filing IDs (e.g. insolvency filing IDs) - `type` string — filing type - `name` string — complete string - `source` string — Source identifier, for a complete list see [Source reference](https://www.northdata.com/_coverage#sources) - `city` string — city (only for German insolvency filings) - `id` string, required — external ID (e.g., 36w IN 3284/16 for insolvency filings) - `attachments` Attachment[] — additional binary content such as images or PDF - `name` string, required — name of attachment - `url` string, required — url to download from (link will be valid for 3 days) - `contentType` string, required — mime type - `blocked` boolean — publication data should not be publicly on the Internet because of a request for privacy protection - `internal` object — additional data used for internal purposes ## Changes - **2025-03-06** `6b1737e201a4` — 2 info - added the new optional `query` request parameter `maxPublicationDate` - added the new optional `query` request parameter `minPublicationDate` - **2024-09-17** `2b60156c0a4b` — 1 info - added the new optional `query` request parameter `id` - **2024-07-03** `bc60f5dcc9e4` — 1 warning - deleted the `query` request parameter `id` - **2024-06-28** `c686177c523b` — 1 info - added the new optional `query` request parameter `id` - **2024-01-17** `fb1771f55c6a` — 3 warning - deleted the `query` request parameter `id` - deleted the `query` request parameter `maxPublicationDate` - deleted the `query` request parameter `minPublicationDate` [Change history](https://skmtc.dev/northdata/apis/north-data-api/changes/pub/v1/publications/get.md) --- [API](https://skmtc.dev/northdata/apis/north-data-api.md) · [All operations](https://skmtc.dev/northdata/apis/north-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/northdata/north-data-api/revisions/c27900c57920/schema)