Skip to content
forked from pawel-id/bir1

BIR1 - GUS REGON client to official database of polish companies

Notifications You must be signed in to change notification settings

Jmagnowski/bir1

 
 

Repository files navigation

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

Name Type Notes
options Object
options.key? string production API key

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

Name Type Notes
query Object
query.nip? string
query.regon? string

Returns

Promise<any>


report

report(query): Promise<any>

Parameters

Name Type Notes
query Object
query.regon string
query.report string e.g.: BIR11OsPrawna

See BIR1 original documentation for more report types.

Returns

Promise<any>


value

value(value): Promise<string>

Parameters

Name Type
value string

Returns

Promise<string>

About

BIR1 - GUS REGON client to official database of polish companies

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 71.4%
  • JavaScript 28.6%