This package is deprecated. Please consider using the bir1 package as a recommended alternative.

Simple node.js client library to Statistics Poland (GUS) information about companies api REGON

npm i bir1

import Bir from 'bir1'

const bir = new Bir()
await bir.login()
console.log(await bir.search({ nip: '5261040567' }))

/*
output: 

{
  regon: '011417295',
  nip: '5261040567',
  statusNip: null,
  nazwa: 'T-MOBILE POLSKA SPÓŁKA AKCYJNA',
  wojewodztwo: 'MAZOWIECKIE',
  powiat: 'Warszawa',
  gmina: 'Mokotów',
  miejscowosc: 'Warszawa',
  kodPocztowy: '02-674',
  ulica: 'ul. Marynarska',
  nrNieruchomosci: '12',
  nrLokalu: null,
  typ: 'P',
  silosID: '6',
  dataZakonczeniaDzialalnosci: null,
  miejscowoscPoczty: 'Warszawa'
}
*/

• new Bir(options?)

Note: by default it connects to non production GUS database using public default key. In order to connect to production database with current company data provide a key granted by GUS.

▸ login(): Promise<void>

Promise<void>

▸ search(query): Promise<any>

Promise<any>

▸ report(query): Promise<any>

See BIR1 original documentation for more report types.

Promise<any>

▸ value(value): Promise<string>

Promise<string>