API Rejestr WL

Rejestr Podatników VAT
Contact Info: WykazPodatnikow@mf.gov.pl
Version: 1.4.0
Apache 2.0
http://www.apache.org/licenses/LICENSE-2.0.html

Access

Methods

[ Jump to Models ]

Table of Contents

Default

Default

Up 
get /api/search/bank-account/{bank-account}
(bankAccount?date)
Wyszukiwanie podmiotow po numerze konta

Path parameters

bank-account (required)
Path Parameter — Numer rachunku bankowego

Query parameters

date (required)
Query Parameter — format: date

Return type

EntityListResponse

Example data

Content-Type: application/json
{
  "result" : {
    "subjects" : [ {
      "authorizedClerks" : [ ],
      "regon" : "regon",
      "restorationDate" : "2019-02-21",
      "workingAddress" : "ul/ Prosta 49 00-838 Warszawa",
      "hasVirtualAccounts" : true,
      "statusVat" : "Zwolniony",
      "krs" : "0000636771",
      "restorationBasis" : "Ustawa o podatku od towarów i usług art. 96",
      "accountNumbers" : [ "90249000050247256316596736", "90249000050247256316596736" ],
      "registrationDenialBasis" : "Ustawa o podatku od towarów i usług art. 96",
      "nip" : "1111111111",
      "removalDate" : "2019-02-21",
      "partners" : [ ],
      "name" : "ABC Jan Nowak",
      "registrationLegalDate" : "2018-02-21",
      "removalBasis" : "Ustawa o podatku od towarów i usług Art. 97",
      "pesel" : "22222222222",
      "representatives" : [ {
        "firstName" : "Jan",
        "lastName" : "Nowak",
        "nip" : "1111111111",
        "companyName" : "Nazwa firmy"
      }, {
        "firstName" : "Jan",
        "lastName" : "Nowak",
        "nip" : "1111111111",
        "companyName" : "Nazwa firmy"
      } ],
      "residenceAddress" : "ul/ Chmielna 85/87 00-805 Warszawa",
      "registrationDenialDate" : "2019-02-21"
    }, {
      "authorizedClerks" : [ ],
      "regon" : "regon",
      "restorationDate" : "2019-02-21",
      "workingAddress" : "ul/ Prosta 49 00-838 Warszawa",
      "hasVirtualAccounts" : true,
      "statusVat" : "Zwolniony",
      "krs" : "0000636771",
      "restorationBasis" : "Ustawa o podatku od towarów i usług art. 96",
      "accountNumbers" : [ "90249000050247256316596736", "90249000050247256316596736" ],
      "registrationDenialBasis" : "Ustawa o podatku od towarów i usług art. 96",
      "nip" : "1111111111",
      "removalDate" : "2019-02-21",
      "partners" : [ ],
      "name" : "ABC Jan Nowak",
      "registrationLegalDate" : "2018-02-21",
      "removalBasis" : "Ustawa o podatku od towarów i usług Art. 97",
      "pesel" : "22222222222",
      "representatives" : [ {
        "firstName" : "Jan",
        "lastName" : "Nowak",
        "nip" : "1111111111",
        "companyName" : "Nazwa firmy"
      }, {
        "firstName" : "Jan",
        "lastName" : "Nowak",
        "nip" : "1111111111",
        "companyName" : "Nazwa firmy"
      } ],
      "residenceAddress" : "ul/ Chmielna 85/87 00-805 Warszawa",
      "registrationDenialDate" : "2019-02-21"
    } ],
  "requestDateTime": "19-11-2019 14:58:49",
  "requestId" : "d2n10-84df1a1"
  }
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Lista podmiotow, które spełnily warunki wyszukiwania EntityListResponse

400

niepoprawny parametr na wejściu Exception
Up 
get /api/search/bank-accounts/{bank-accounts}
(bankAccounts?date)
Wyszukiwanie podmiotow po numerach kont

Path parameters

bank-accounts (required)
Path Parameter — Lista maksymalnie 30 numerow rachunkow bankowych rozdzielonych przecinkami

Query parameters

date (required)
Query Parameter — format: date

Return type

EntityListResponse

Example data

Content-Type: application/json
{
  "result" : {
    "subjects" : [ {
      "authorizedClerks" : [ ],
      "regon" : "regon",
      "restorationDate" : "2019-02-21",
      "workingAddress" : "ul/ Prosta 49 00-838 Warszawa",
      "hasVirtualAccounts" : true,
      "statusVat" : "Zwolniony",
      "krs" : "0000636771",
      "restorationBasis" : "Ustawa o podatku od towarów i usług art. 96",
      "accountNumbers" : [ "90249000050247256316596736", "90249000050247256316596736" ],
      "registrationDenialBasis" : "Ustawa o podatku od towarów i usług art. 96",
      "nip" : "1111111111",
      "removalDate" : "2019-02-21",
      "partners" : [ ],
      "name" : "ABC Jan Nowak",
      "registrationLegalDate" : "2018-02-21",
      "removalBasis" : "Ustawa o podatku od towarów i usług Art. 97",
      "pesel" : "22222222222",
      "representatives" : [ {
        "firstName" : "Jan",
        "lastName" : "Nowak",
        "nip" : "1111111111",
        "companyName" : "Nazwa firmy"
      }, {
        "firstName" : "Jan",
        "lastName" : "Nowak",
        "nip" : "1111111111",
        "companyName" : "Nazwa firmy"
      } ],
      "residenceAddress" : "ul/ Chmielna 85/87 00-805 Warszawa",
      "registrationDenialDate" : "2019-02-21"
    }, {
      "authorizedClerks" : [ ],
      "regon" : "regon",
      "restorationDate" : "2019-02-21",
      "workingAddress" : "ul/ Prosta 49 00-838 Warszawa",
      "hasVirtualAccounts" : true,
      "statusVat" : "Zwolniony",
      "krs" : "0000636771",
      "restorationBasis" : "Ustawa o podatku od towarów i usług art. 96",
      "accountNumbers" : [ "90249000050247256316596736", "90249000050247256316596736" ],
      "registrationDenialBasis" : "Ustawa o podatku od towarów i usług art. 96",
      "nip" : "1111111111",
      "removalDate" : "2019-02-21",
      "partners" : [ ],
      "name" : "ABC Jan Nowak",
      "registrationLegalDate" : "2018-02-21",
      "removalBasis" : "Ustawa o podatku od towarów i usług Art. 97",
      "pesel" : "22222222222",
      "representatives" : [ {
        "firstName" : "Jan",
        "lastName" : "Nowak",
        "nip" : "1111111111",
        "companyName" : "Nazwa firmy"
      }, {
        "firstName" : "Jan",
        "lastName" : "Nowak",
        "nip" : "1111111111",
        "companyName" : "Nazwa firmy"
      } ],
      "residenceAddress" : "ul/ Chmielna 85/87 00-805 Warszawa",
      "registrationDenialDate" : "2019-02-21"
    } ],
    "requestDateTime": "19-11-2019 14:58:49",
    "requestId" : "d2n10-84df1a1"
  }
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Lista podmiotow, które spelnily warunki wyszukiwania EntityListResponse

400

niepoprawny parametr na wejściu Exception
Up 
get /api/check/nip/{nip}/bank-account/{bank-account}
(checkNip)
Sprawdzenie pojedynczego podmiotu po nip i numerze konta

Path parameters

nip (required)
Path Parameter — Nip
bank-account (required)
Path Parameter — Numer rachunku bankowego

Query parameters

date (required)
Query Parameter — format: date

Return type

EntityCheckResponse

Example data

Content-Type: application/json
{
  "result" : {
    "accountAssigned" : "TAK",
    "requestDateTime": "19-11-2019 14:58:49",
    "requestId" : "d2n10-84df1a1"
  }
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Informacja, że dany rachunek jest przypisany do podmiotu EntityCheckResponse

400

niepoprawny parametr na wejściu Exception
Up 
get /api/check/regon/{regon}/bank-account/{bank-account}
(checkRegon)
Sprawdzenie pojedynczego podmiotu po regon i numerze konta

Path parameters

regon (required)
Path Parameter — Regon
bank-account (required)
Path Parameter — Numer rachunku bankowego

Query parameters

date (required)
Query Parameter — format: date

Return type

EntityCheckResponse

Example data

Content-Type: application/json
{
  "result" : {
    "accountAssigned" : "TAK",
    "requestDateTime": "19-11-2019 14:58:49",
    "requestId" : "d2n10-84df1a1"
  }
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Informacja, że dany rachunek jest przypisany do podmiotu EntityCheckResponse

400

niepoprawny parametr na wejściu Exception
Up 
get /api/search/nip/{nip}
(nip?date)
Wyszukiwanie pojedynczego podmiotu po nip

Path parameters

nip (required)
Path Parameter — Nip

Query parameters

date (required)
Query Parameter — format: date

Return type

EntityResponse

Example data

Content-Type: application/json
{
  "result" : {
    "subject" : {
      "authorizedClerks" : [ ],
      "regon" : "regon",
      "restorationDate" : "2019-02-21",
      "workingAddress" : "ul/ Prosta 49 00-838 Warszawa",
      "hasVirtualAccounts" : true,
      "statusVat" : "Zwolniony",
      "krs" : "0000636771",
      "restorationBasis" : "Ustawa o podatku od towarów i usług art. 96",
      "accountNumbers" : [ "90249000050247256316596736", "90249000050247256316596736" ],
      "registrationDenialBasis" : "Ustawa o podatku od towarów i usług art. 96",
      "nip" : "1111111111",
      "removalDate" : "2019-02-21",
      "partners" : [ ],
      "name" : "ABC Jan Nowak",
      "registrationLegalDate" : "2018-02-21",
      "removalBasis" : "Ustawa o podatku od towarów i usług Art. 97",
      "pesel" : "22222222222",
      "representatives" : [ {
        "firstName" : "Jan",
        "lastName" : "Nowak",
        "nip" : "1111111111",
        "companyName" : "Nazwa firmy"
      }, {
        "firstName" : "Jan",
        "lastName" : "Nowak",
        "nip" : "1111111111",
        "companyName" : "Nazwa firmy"
      } ],
      "residenceAddress" : "ul/ Chmielna 85/87 00-805 Warszawa",
      "registrationDenialDate" : "2019-02-21"
    },
    "requestDateTime": "19-11-2019 14:58:49",
    "requestId" : "d2n10-84df1a1"
  }
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Pojedynczy podmiot, który spełnił warunki wyszukiwania EntityResponse

400

niepoprawny parametr na wejściu Exception
Up 
get /api/search/nips/{nips}
(nips?date)
Wyszukiwanie podmiotow po numerach nip

Path parameters

nips (required)
Path Parameter — Lista maksymalnie 30 numerow NIP rozdzielonych przecinkami

Query parameters

date (required)
Query Parameter — format: date

Return type

EntityListResponse

Example data

Content-Type: application/json
{
  "result" : {
    "subjects" : [ {
      "authorizedClerks" : [ ],
      "regon" : "regon",
      "restorationDate" : "2019-02-21",
      "workingAddress" : "ul/ Prosta 49 00-838 Warszawa",
      "hasVirtualAccounts" : true,
      "statusVat" : "Zwolniony",
      "krs" : "0000636771",
      "restorationBasis" : "Ustawa o podatku od towarów i usług art. 96",
      "accountNumbers" : [ "90249000050247256316596736", "90249000050247256316596736" ],
      "registrationDenialBasis" : "Ustawa o podatku od towarów i usług art. 96",
      "nip" : "1111111111",
      "removalDate" : "2019-02-21",
      "partners" : [ ],
      "name" : "ABC Jan Nowak",
      "registrationLegalDate" : "2018-02-21",
      "removalBasis" : "Ustawa o podatku od towarów i usług Art. 97",
      "pesel" : "22222222222",
      "representatives" : [ {
        "firstName" : "Jan",
        "lastName" : "Nowak",
        "nip" : "1111111111",
        "companyName" : "Nazwa firmy"
      }, {
        "firstName" : "Jan",
        "lastName" : "Nowak",
        "nip" : "1111111111",
        "companyName" : "Nazwa firmy"
      } ],
      "residenceAddress" : "ul/ Chmielna 85/87 00-805 Warszawa",
      "registrationDenialDate" : "2019-02-21"
    }, {
      "authorizedClerks" : [ ],
      "regon" : "regon",
      "restorationDate" : "2019-02-21",
      "workingAddress" : "ul/ Prosta 49 00-838 Warszawa",
      "hasVirtualAccounts" : true,
      "statusVat" : "Zwolniony",
      "krs" : "0000636771",
      "restorationBasis" : "Ustawa o podatku od towarów i usług art. 96",
      "accountNumbers" : [ "90249000050247256316596736", "90249000050247256316596736" ],
      "registrationDenialBasis" : "Ustawa o podatku od towarów i usług art. 96",
      "nip" : "1111111111",
      "removalDate" : "2019-02-21",
      "partners" : [ ],
      "name" : "ABC Jan Nowak",
      "registrationLegalDate" : "2018-02-21",
      "removalBasis" : "Ustawa o podatku od towarów i usług Art. 97",
      "pesel" : "22222222222",
      "representatives" : [ {
        "firstName" : "Jan",
        "lastName" : "Nowak",
        "nip" : "1111111111",
        "companyName" : "Nazwa firmy"
      }, {
        "firstName" : "Jan",
        "lastName" : "Nowak",
        "nip" : "1111111111",
        "companyName" : "Nazwa firmy"
      } ],
      "residenceAddress" : "ul/ Chmielna 85/87 00-805 Warszawa",
      "registrationDenialDate" : "2019-02-21"
    } ],
    "requestDateTime": "19-11-2019 14:58:49",
    "requestId" : "d2n10-84df1a1"
  }
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Lista podmiotów, które spełniły warunki wyszukiwania EntityListResponse

400

niepoprawny parametr na wejściu Exception
Up 
get /api/search/regon/{regon}
(regon?date)
Wyszukiwanie pojedynczego podmiotu po regon

Path parameters

regon (required)
Path Parameter — Regon

Query parameters

date (required)
Query Parameter — format: date

Return type

EntityResponse

Example data

Content-Type: application/json
{
  "result" : {
    "subject" : {
      "authorizedClerks" : [ ],
      "regon" : "regon",
      "restorationDate" : "2019-02-21",
      "workingAddress" : "ul/ Prosta 49 00-838 Warszawa",
      "hasVirtualAccounts" : true,
      "statusVat" : "Zwolniony",
      "krs" : "0000636771",
      "restorationBasis" : "Ustawa o podatku od towarów i usług art. 96",
      "accountNumbers" : [ "90249000050247256316596736", "90249000050247256316596736" ],
      "registrationDenialBasis" : "Ustawa o podatku od towarów i usług art. 96",
      "nip" : "1111111111",
      "removalDate" : "2019-02-21",
      "partners" : [ ],
      "name" : "ABC Jan Nowak",
      "registrationLegalDate" : "2018-02-21",
      "removalBasis" : "Ustawa o podatku od towarów i usług Art. 97",
      "pesel" : "22222222222",
      "representatives" : [ {
        "firstName" : "Jan",
        "lastName" : "Nowak",
        "nip" : "1111111111",
        "companyName" : "Nazwa firmy"
      }, {
        "firstName" : "Jan",
        "lastName" : "Nowak",
        "nip" : "1111111111",
        "companyName" : "Nazwa firmy"
      } ],
      "residenceAddress" : "ul/ Chmielna 85/87 00-805 Warszawa",
      "registrationDenialDate" : "2019-02-21"
    },
    "requestDateTime": "19-11-2019 14:58:49",
    "requestId" : "d2n10-84df1a1"
  }
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Pojedynczy podmiot, który spełnił warunki wyszukiwania EntityResponse

400

niepoprawny parametr na wejściu Exception
Up 
get /api/search/regons/{regons}
(regons?date)
Wyszukiwanie podmiotow po numerach regon

Path parameters

regons (required)
Path Parameter — Regon

Query parameters

date (required)
Query Parameter — format: date

Return type

EntityListResponse

Example data

Content-Type: application/json
{
  "result" : {
    "subjects" : [ {
      "authorizedClerks" : [ ],
      "regon" : "regon",
      "restorationDate" : "2019-02-21",
      "workingAddress" : "ul/ Prosta 49 00-838 Warszawa",
      "hasVirtualAccounts" : true,
      "statusVat" : "Zwolniony",
      "krs" : "0000636771",
      "restorationBasis" : "Ustawa o podatku od towarów i usług art. 96",
      "accountNumbers" : [ "90249000050247256316596736", "90249000050247256316596736" ],
      "registrationDenialBasis" : "Ustawa o podatku od towarów i usług art. 96",
      "nip" : "1111111111",
      "removalDate" : "2019-02-21",
      "partners" : [ ],
      "name" : "ABC Jan Nowak",
      "registrationLegalDate" : "2018-02-21",
      "removalBasis" : "Ustawa o podatku od towarów i usług Art. 97",
      "pesel" : "22222222222",
      "representatives" : [ {
        "firstName" : "Jan",
        "lastName" : "Nowak",
        "nip" : "1111111111",
        "companyName" : "Nazwa firmy"
      }, {
        "firstName" : "Jan",
        "lastName" : "Nowak",
        "nip" : "1111111111",
        "companyName" : "Nazwa firmy"
      } ],
      "residenceAddress" : "ul/ Chmielna 85/87 00-805 Warszawa",
      "registrationDenialDate" : "2019-02-21"
    }, {
      "authorizedClerks" : [ ],
      "regon" : "regon",
      "restorationDate" : "2019-02-21",
      "workingAddress" : "ul/ Prosta 49 00-838 Warszawa",
      "hasVirtualAccounts" : true,
      "statusVat" : "Zwolniony",
      "krs" : "0000636771",
      "restorationBasis" : "Ustawa o podatku od towarów i usług art. 96",
      "accountNumbers" : [ "90249000050247256316596736", "90249000050247256316596736" ],
      "registrationDenialBasis" : "Ustawa o podatku od towarów i usług art. 96",
      "nip" : "1111111111",
      "removalDate" : "2019-02-21",
      "partners" : [ ],
      "name" : "ABC Jan Nowak",
      "registrationLegalDate" : "2018-02-21",
      "removalBasis" : "Ustawa o podatku od towarów i usług Art. 97",
      "pesel" : "22222222222",
      "representatives" : [ {
        "firstName" : "Jan",
        "lastName" : "Nowak",
        "nip" : "1111111111",
        "companyName" : "Nazwa firmy"
      }, {
        "firstName" : "Jan",
        "lastName" : "Nowak",
        "nip" : "1111111111",
        "companyName" : "Nazwa firmy"
      } ],
      "residenceAddress" : "ul/ Chmielna 85/87 00-805 Warszawa",
      "registrationDenialDate" : "2019-02-21"
    } ],
    "requestDateTime": "19-11-2019 14:58:49",
    "requestId" : "d2n10-84df1a1"
  }
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Lista podmiotów, które spełniły warunki wyszukiwania EntityListResponse

400

niepoprawny parametr na wejściu Exception

Models

[ Jump to Methods ]

Table of Contents

  1. Entity
  2. EntityCheck
  3. EntityCheckResponse
  4. EntityItem
  5. EntityList
  6. EntityListResponse
  7. EntityPerson
  8. EntityResponse
  9. Exception
  10. Pesel

Entity Up

name
String Firma (nazwa) lub imię i nazwisko
example: ABC Jan Nowak
nip (optional)
String
example: 1111111111
statusVat (optional)
String Status podatnika VAT.
Enum:
Czynny
Zwolniony
Niezarejestrowany
example: Zwolniony
regon (optional)
String Numer identyfikacyjny REGON
pesel (optional)
Pesel
krs (optional)
String numer KRS jeżeli został nadany
example: 0000636771
residenceAddress (optional)
String Adres siedziby
example: ul/ Chmielna 85/87 00-805 Warszawa
workingAddress (optional)
String Adres stałego miejsca prowadzenia działalności lub adres miejsca zamieszkania w przypadku braku adresu stałego miejsca prowadzenia działalności
example: ul/ Prosta 49 00-838 Warszawa
representatives (optional)
array[EntityPerson] Imiona i nazwiska osób wchodzących w skład organu uprawnionego do reprezentowania podmiotu oraz ich numery NIP i/lub PESEL
authorizedClerks (optional)
array[EntityPerson] Imiona i nazwiska prokurentów oraz ich numery NIP i/lub PESEL
partners (optional)
array[EntityPerson] Imiona i nazwiska lub firmę (nazwa) wspólnika oraz jego numeryNIP i/lub PESEL
registrationLegalDate (optional)
date Data rejestracji jako podatnika VAT format: date
example: Wed Feb 21 00:00:00 GMT 2018
registrationDenialDate (optional)
date Data odmowy rejestracji jako podatnika VAT format: date
example: Thu Feb 21 00:00:00 GMT 2019
registrationDenialBasis (optional)
String Podstawa prawna odmowy rejestracji
example: Ustawa o podatku od towarów i usług art. 96
restorationDate (optional)
date Data przywrócenia jako podatnika VAT format: date
example: Thu Feb 21 00:00:00 GMT 2019
restorationBasis (optional)
String Podstawa prawna przywrócenia jako podatnika VAT
example: Ustawa o podatku od towarów i usług art. 96
removalDate (optional)
date Data wykreślenia odmowy rejestracji jako podatnika VAT format: date
example: Thu Feb 21 00:00:00 GMT 2019
removalBasis (optional)
String Podstawa prawna wykreślenia odmowy rejestracji jako podatnika VAT
example: Ustawa o podatku od towarów i usług Art. 97
accountNumbers (optional)
array[String]
hasVirtualAccounts (optional)
Boolean Podmiot posiada maski kont wirtualnych
example: true

EntityCheck Up

accountAssigned (optional)
String Czy rachunek przypisany do podmiotu czynnego
example: TAK
requestId (optional)
String
example: d2n10-84df1a1

EntityCheckResponse Up

result (optional)
EntityCheck

EntityItem Up

subject (optional)
Entity
requestId (optional)
String
example: d2n10-84df1a1

EntityList Up

subjects (optional)
array[Entity] Lista podmiotów
requestId (optional)
String
example: d2n10-84df1a1

EntityListResponse Up

result (optional)
EntityList

EntityPerson Up

companyName (optional)
String
example: Nazwa firmy
firstName (optional)
String
example: Jan
lastName (optional)
String
example: Nowak
pesel (optional)
Pesel
nip (optional)
String
example: 1111111111

EntityResponse Up

result (optional)
EntityItem

Exception Up

message
String
example: error message
code
String
example: WL-101

Pesel Up

numer PESEL jeżeli został nadany