bir1-nextjs v2.0.2

BIR1 - GUS REGON client

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

Install

npm i bir1

Usage

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'
}
*/

API

constructor

• new Bir(options?)

Parameters

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

▸ login(): Promise<void>

Returns

Promise<void>

search

▸ search(query): Promise<any>

Parameters

Returns

Promise<any>

report

▸ report(query): Promise<any>

Parameters

See BIR1 original documentation for more report types.

Returns

Promise<any>

value

▸ value(value): Promise<string>

Parameters

Returns

Promise<string>