### Get CEIDG Activity Report (XML)

Source: https://context7.com/karszo-pp/gus-regon-uslugabir/llms.txt

Retrieves detailed business activity information for natural persons registered in CEIDG using the BIR12OsFizycznaDzialalnoscCeidg report. Requires a REGON number and provides data on business name, addresses, and registration details.

```xml
<!-- Request CEIDG Activity Report -->
<ns:DanePobierzPelnyRaport>
  <ns:pRegon>123456789</ns:pRegon>
  <ns:pNazwaRaportu>BIR12OsFizycznaDzialalnoscCeidg</ns:pNazwaRaportu>
</ns:DanePobierzPelnyRaport>

<!-- Response Structure (based on BIR12OsFizycznaDzialalnoscCeidg.xsd) -->
<root>
  <dane>
    <fiz_regon9>123456789</fiz_regon9>
    <fiz_nazwa>JAN KOWALSKI FIRMA USLUGOWA</fiz_nazwa>
    <fiz_nazwaSkrocona>JK FIRMA</fiz_nazwaSkrocona>
    <fiz_dataPowstania>2010-05-15</fiz_dataPowstania>
    <fiz_dataRozpoczeciaDzialalnosci>2010-06-01</fiz_dataRozpoczeciaDzialalnosci>
    <fiz_dataWpisuDzialalnosciDoRegon>2010-05-20</fiz_dataWpisuDzialalnosciDoRegon>
    <fiz_dataZawieszeniaDzialalnosci></fiz_dataZawieszeniaDzialalnosci>
    <fiz_dataWznowieniaDzialalnosci></fiz_dataWznowieniaDzialalnosci>
    <fiz_dataZaistnieniaZmianyDzialalnosci>2023-02-15</fiz_dataZaistnieniaZmianyDzialalnosci>
    <fiz_dataZakonczeniaDzialalnosci></fiz_dataZakonczeniaDzialalnosci>
    <fiz_dataSkresleniaDzialalnosciZRegon></fiz_dataSkresleniaDzialalnosciZRegon>
    <!-- Address fields -->
    <fiz_adSiedzKraj_Symbol>PL</fiz_adSiedzKraj_Symbol>
    <fiz_adSiedzWojewodztwo_Symbol>14</fiz_adSiedzWojewodztwo_Symbol>
    <fiz_adSiedzPowiat_Symbol>65</fiz_adSiedzPowiat_Symbol>
    <fiz_adSiedzGmina_Symbol>018</fiz_adSiedzGmina_Symbol>
    <fiz_adSiedzKodPocztowy>00-001</fiz_adSiedzKodPocztowy>
    <fiz_adSiedzMiejscowosc_Nazwa>Warszawa</fiz_adSiedzMiejscowosc_Nazwa>
    <fiz_adSiedzUlica_Nazwa>ul. Marszalkowska</fiz_adSiedzUlica_Nazwa>
    <fiz_adSiedzNumerNieruchomosci>100</fiz_adSiedzNumerNieruchomosci>
    <fiz_adSiedzNumerLokalu>5</fiz_adSiedzNumerLokalu>
    <fiz_adresEmail>kontakt@firma.pl</fiz_adresEmail>
    <fiz_adresStronyinternetowej>www.firma.pl</fiz_adresStronyinternetowej>
    <!-- CEIDG registration info -->
    <fizC_dataWpisuDoRejestruEwidencji>2010-05-15</fizC_dataWpisuDoRejestruEwidencji>
    <fizC_numerWRejestrzeEwidencji>123456</fizC_numerWRejestrzeEwidencji>
    <fizC_OrganRejestrowy_Symbol>094100000</fizC_OrganRejestrowy_Symbol>
    <fizC_OrganRejestrowy_Nazwa>MINISTER GOSPODARKI</fizC_OrganRejestrowy_Nazwa>
    <fizC_RodzajRejestru_Symbol>151</fizC_RodzajRejestru_Symbol>
    <fizC_RodzajRejestru_Nazwa>CENTRALNA EWIDENCJA I INFORMACJA O DZIALALNOSCI GOSPODARCZEJ</fizC_RodzajRejestru_Nazwa>
    <fizC_NiePodjetoDzialalnosci>false</fizC_NiePodjetoDzialalnosci>
  </dane>
</root>
```

--------------------------------

### Get Civil Partnership Partners Report (XML)

Source: https://context7.com/karszo-pp/gus-regon-uslugabir/llms.txt

Requests and displays information about partners of a civil law partnership. It includes the request format and example response structures for both successful data retrieval and error scenarios (entity not a civil partnership, or no partners found).

```xml
<!-- Request Civil Partnership Partners -->
<ns:DanePobierzPelnyRaport>
  <ns:pRegon>012345678</ns:pRegon>
  <ns:pNazwaRaportu>BIR12OsPrawnaSpCywilnaWspolnicy</ns:pNazwaRaportu>
</ns:DanePobierzPelnyRaport>

<!-- Response Structure (based on BIR12OsPrawnaSpCywilnaWspolnicy.xsd) -->
<root>
  <dane>
    <wspolsc_regonWspolnikSpolki>111111111</wspolsc_regonWspolnikSpolki>
    <wspolsc_imiePierwsze>JAN</wspolsc_imiePierwsze>
    <wspolsc_imieDrugie>ADAM</wspolsc_imieDrugie>
    <wspolsc_nazwisko>KOWALSKI</wspolsc_nazwisko>
    <wspolsc_firmaNazwa></wspolsc_firmaNazwa>
  </dane>
  <dane>
    <wspolsc_regonWspolnikSpolki>222222222</wspolsc_regonWspolnikSpolki>
    <wspolsc_imiePierwsze>ANNA</wspolsc_imiePierwsze>
    <wspolsc_imieDrugie></wspolsc_imieDrugie>
    <wspolsc_nazwisko>NOWAK</wspolsc_nazwisko>
    <wspolsc_firmaNazwa></wspolsc_firmaNazwa>
  </dane>
  <dane>
    <wspolsc_regonWspolnikSpolki>333333333</wspolsc_regonWspolnikSpolki>
    <wspolsc_imiePierwsze></wspolsc_imiePierwsze>
    <wspolsc_imieDrugie></wspolsc_imieDrugie>
    <wspolsc_nazwisko></wspolsc_nazwisko>
    <wspolsc_firmaNazwa>SPÓLKA XYZ SP. Z O.O.</wspolsc_firmaNazwa>
  </dane>
</root>

<!-- Error Response - Entity is not a civil partnership (Error 21) -->
<root>
  <dane>
    <ErrorCode>21</ErrorCode>
    <pRegon>999999999</pRegon>
    <DatabaseSearchResultPl>Podmiot nie jest spolka cywilna</DatabaseSearchResultPl>
    <DatabaseSearchResultEn>The entity is not a civil law partnership</DatabaseSearchResultEn>
  </dane>
</root>

<!-- Error Response - No partners found (Error 22) -->
<root>
  <dane>
    <ErrorCode>22</ErrorCode>
    <pRegon>002003735</pRegon>
    <DatabaseSearchResultPl>W rejestrze REGON brak jest wprowadzonych wspolnikow dla tej SC</DatabaseSearchResultPl>
    <DatabaseSearchResultEn>In the REGON register there are no entered partners on this SC</DatabaseSearchResultEn>
  </dane>
</root>
```

--------------------------------

### POST /wsBIR/UslugaBIRzewnPubl.svc - Get Full Report

Source: https://context7.com/karszo-pp/gus-regon-uslugabir/llms.txt

Retrieves detailed information about an entity using its REGON number and a specific report type. Different report types are available for legal persons (P), natural persons (F), and local units (LP, LF).

```APIDOC
## POST /wsBIR/UslugaBIRzewnPubl.svc - Get Full Report

### Description
Retrieves detailed information about an entity using its REGON number and a specific report type. Different report types are available for legal persons (P), natural persons (F), and local units (LP, LF).

### Method
POST

### Endpoint
https://wyszukiwarkaregon.stat.gov.pl/wsBIR/UslugaBIRzewnPubl.svc

### Headers
- **Content-Type** (string) - Required - `application/soap+xml; charset=utf-8`
- **sid** (string) - Required - Session ID obtained from authentication.

### Request Body
- **pRegon** (string) - Required - The REGON number of the entity.
- **pNazwaRaportu** (string) - Required - The name of the report to retrieve. Examples include `BIR12OsPrawna` (Legal person full data), `BIR12OsFizycznaDaneOgolne` (Natural person general data), `BIR12JednLokalnaOsPrawnej` (Local unit details - legal person).

### Request Example
```xml
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope"
               xmlns:ns="http://CIS/BIR/PUBL/2014/07">
  <soap:Header xmlns:wsa="http://www.w3.org/2005/08/addressing">
    <wsa:To>https://wyszukiwarkaregon.stat.gov.pl/wsBIR/UslugaBIRzewnPubl.svc</wsa:To>
    <wsa:Action>http://CIS/BIR/PUBL/2014/07/IUslugaBIRzewnPubl/DanePobierzPelnyRaport</wsa:Action>
  </soap:Header>
  <soap:Body>
    <ns:DanePobierzPelnyRaport>
      <ns:pRegon>012100010</ns:pRegon>
      <ns:pNazwaRaportu>BIR12OsPrawna</ns:pNazwaRaportu>
    </ns:DanePobierzPelnyRaport>
  </soap:Body>
</soap:Envelope>
```

### Response
#### Success Response (200)
- **DanePobierzPelnyRaportResult** (string) - Contains the report data in XML format, wrapped in CDATA.

#### Response Example
```xml
<DanePobierzPelnyRaportResponse xmlns="http://CIS/BIR/PUBL/2014/07">
  <DanePobierzPelnyRaportResult><![CDATA[
    <root>
      <dane>
        <praw_regon9>012100010</praw_regon9>
        <praw_nip>5261040828</praw_nip>
        <praw_nazwa>GLOWNY URZAD STATYSTYCZNY</praw_nazwa>
        <praw_nazwaSkrocona>GUS</praw_nazwaSkrocona>
        <praw_dataPowstania>1975-12-16</praw_dataPowstania>
        <praw_adSiedzKraj_Symbol>PL</praw_adSiedzKraj_Symbol>
        <praw_adSiedzWojewodztwo_Symbol>14</praw_adSiedzWojewodztwo_Symbol>
        <praw_adSiedzPowiat_Symbol>65</praw_adSiedzPowiat_Symbol>
        <praw_adSiedzGmina_Symbol>018</praw_adSiedzGmina_Symbol>
        <praw_adSiedzKodPocztowy>00-925</praw_adSiedzKodPocztowy>
        <praw_adSiedzMiejscowosc_Nazwa>Warszawa</praw_adSiedzMiejscowosc_Nazwa>
        <praw_adSiedzUlica_Nazwa>ul. Test-Krucza</praw_adSiedzUlica_Nazwa>
        <praw_adSiedzNumerNieruchomosci>208</praw_adSiedzNumerNieruchomosci>
        <praw_numerTelefonu>226083000</praw_numerTelefonu>
        <praw_adresEmail>dane@stat.gov.pl</praw_adresEmail>
        <praw_adresStronyinternetowej>www.stat.gov.pl</praw_adresStronyinternetowej>
        <praw_podstawowaFormaPrawna_Symbol>2</praw_podstawowaFormaPrawna_Symbol>
        <praw_szczegolnaFormaPrawna_Symbol>01</praw_szczegolnaFormaPrawna_Symbol>
        <praw_formaWlasnosci_Symbol>111</praw_formaWlasnosci_Symbol>
        <praw_liczbaJednLokalnych>16</praw_liczbaJednLokalnych>
      </dane>
    </root>
  ]]></DanePobierzPelnyRaportResult>
</DanePobierzPelnyRaportResponse>
```
```

--------------------------------

### Get Natural Person General Data (XML)

Source: https://context7.com/karszo-pp/gus-regon-uslugabir/llms.txt

Requests general information about a natural person (sole proprietor) using the BIR12OsFizycznaDaneOgolne report. Requires a REGON number as input and returns various personal and registration details.

```xml
<!-- Request Natural Person General Data -->
<ns:DanePobierzPelnyRaport>
  <ns:pRegon>123456789</ns:pRegon>
  <ns:pNazwaRaportu>BIR12OsFizycznaDaneOgolne</ns:pNazwaRaportu>
</ns:DanePobierzPelnyRaport>

<!-- Response Structure (based on BIR12OsFizycznaDaneOgolne.xsd) -->
<root>
  <dane>
    <fiz_regon9>123456789</fiz_regon9>
    <fiz_nip>9876543210</fiz_nip>
    <fiz_statusNip></fiz_statusNip>           <!-- Empty, "Uchylony", or "Uniewazniowy" -->
    <fiz_nazwisko>KOWALSKI</fiz_nazwisko>
    <fiz_imie1>JAN</fiz_imie1>
    <fiz_imie2>ADAM</fiz_imie2>
    <fiz_dataWpisuPodmiotuDoRegon>2010-05-15</fiz_dataWpisuPodmiotuDoRegon>
    <fiz_dataZaistnieniaZmiany>2023-01-10</fiz_dataZaistnieniaZmiany>
    <fiz_dataSkresleniaPodmiotuZRegon></fiz_dataSkresleniaPodmiotuZRegon>
    <fiz_podstawowaFormaPrawna_Symbol>9</fiz_podstawowaFormaPrawna_Symbol>
    <fiz_szczegolnaFormaPrawna_Symbol>99</fiz_szczegolnaFormaPrawna_Symbol>
    <fiz_formaFinansowania_Symbol>2</fiz_formaFinansowania_Symbol>
    <fiz_formaWlasnosci_Symbol>214</fiz_formaWlasnosci_Symbol>
    <fiz_podstawowaFormaPrawna_Nazwa>OSOBA FIZYCZNA</fiz_podstawowaFormaPrawna_Nazwa>
    <fiz_szczegolnaFormaPrawna_Nazwa>OSOBY FIZYCZNE PROWADZACE DZIALALNOSC</fiz_szczegolnaFormaPrawna_Nazwa>
    <fiz_formaFinansowania_Nazwa>POZOSTALE</fiz_formaFinansowania_Nazwa>
    <fiz_formaWlasnosci_Nazwa>WLASNOSC PRYWATNA KRAJOWA</fiz_formaWlasnosci_Nazwa>
    <!-- Activity type flags (1 = has activity, 0 = no activity) -->
    <fiz_dzialalnoscCeidg>1</fiz_dzialalnoscCeidg>
    <fiz_dzialalnoscRolnicza>0</fiz_dzialalnoscRolnicza>
    <fiz_dzialalnoscPozostala>0</fiz_dzialalnoscPozostala>
    <fiz_dzialalnoscSkreslonaDo20141108>0</fiz_dzialalnoscSkreslonaDo20141108>
    <fiz_liczbaJednLokalnych>2</fiz_liczbaJednLokalnych>
  </dane>
</root>
```

--------------------------------

### SOAP Request to Get Full Entity Report (XML)

Source: https://context7.com/karszo-pp/gus-regon-uslugabir/llms.txt

This snippet demonstrates the SOAP request structure to retrieve a full report for a legal entity using its REGON number. It requires a valid session ID and specifies the target action and report type. The response contains the entity's detailed information within a CDATA section.

```xml
<!-- SOAP Request - Get Legal Person Full Report -->
POST https://wyszukiwarkaregon.stat.gov.pl/wsBIR/UslugaBIRzewnPubl.svc HTTP/1.1
Content-Type: application/soap+xml; charset=utf-8
sid: abcd1234567890sessionid

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope"
               xmlns:ns="http://CIS/BIR/PUBL/2014/07">
  <soap:Header xmlns:wsa="http://www.w3.org/2005/08/addressing">
    <wsa:To>https://wyszukiwarkaregon.stat.gov.pl/wsBIR/UslugaBIRzewnPubl.svc</wsa:To>
    <wsa:Action>http://CIS/BIR/PUBL/2014/07/IUslugaBIRzewnPubl/DanePobierzPelnyRaport</wsa:Action>
  </soap:Header>
  <soap:Body>
    <ns:DanePobierzPelnyRaport>
      <ns:pRegon>012100010</ns:pRegon>
      <ns:pNazwaRaportu>BIR12OsPrawna</ns:pNazwaRaportu>
    </ns:DanePobierzPelnyRaport>
  </soap:Body>
</soap:Envelope>

<!-- Available Report Types (BIR 1.2):
     Entity Type Reports:
     - BIR12OsPrawna                    - Legal person full data
     - BIR12OsFizycznaDaneOgolne        - Natural person general data
     - BIR12OsFizycznaDzialalnoscCeidg  - Natural person CEIDG activity
     - BIR12OsFizycznaDzialalnoscRolnicza - Natural person agricultural activity
     - BIR12OsFizycznaDzialalnoscPozostala - Natural person other activity
     - BIR12TypPodmiotu                 - Entity type identifier

     PKD (Business Activity) Reports:
     - BIR12OsPrawnaPkd                 - Legal person PKD codes
     - BIR12OsFizycznaPkd               - Natural person PKD codes
     - BIR12JednLokalnaOsFizycznejPkd   - Local unit PKD (natural person)
     - BIR12JednLokalnaOsPrawnejPkd     - Local unit PKD (legal person)

     Local Units Reports:
     - BIR12OsPrawnaListaJednLokalnych  - Legal person local units list
     - BIR12OsFizycznaListaJednLokalnych - Natural person local units list
     - BIR12JednLokalnaOsFizycznej      - Local unit details (natural person)
     - BIR12JednLokalnaOsPrawnej        - Local unit details (legal person)

     Partnership Reports:
     - BIR12OsPrawnaSpCywilnaWspolnicy  - Civil partnership partners
-->

<!-- Response for BIR12OsPrawna (Legal Person) -->
<DanePobierzPelnyRaportResponse xmlns="http://CIS/BIR/PUBL/2014/07">
  <DanePobierzPelnyRaportResult><![CDATA[
    <root>
      <dane>
        <praw_regon9>012100010</praw_regon9>
        <praw_nip>5261040828</praw_nip>
        <praw_statusNip></praw_statusNip>
        <praw_nazwa>GLOWNY URZAD STATYSTYCZNY</praw_nazwa>
        <praw_nazwaSkrocona>GUS</praw_nazwaSkrocona>
        <praw_numerWRejestrzeEwidencji></praw_numerWRejestrzeEwidencji>
        <praw_dataWpisuDoRejestruEwidencji></praw_dataWpisuDoRejestruEwidencji>
        <praw_dataPowstania>1975-12-16</praw_dataPowstania>
        <praw_dataRozpoczeciaDzialalnosci>1975-12-16</praw_dataRozpoczeciaDzialalnosci>
        <praw_dataWpisuDoRegon>1999-09-01</praw_dataWpisuDoRegon>
        <praw_dataZawieszeniaDzialalnosci></praw_dataZawieszeniaDzialalnosci>
        <praw_dataWznowieniaDzialalnosci></praw_dataWznowieniaDzialalnosci>
        <praw_dataZakonczeniaDzialalnosci></praw_dataZakonczeniaDzialalnosci>
        <praw_adSiedzKraj_Symbol>PL</praw_adSiedzKraj_Symbol>
        <praw_adSiedzWojewodztwo_Symbol>14</praw_adSiedzWojewodztwo_Symbol>
        <praw_adSiedzPowiat_Symbol>65</praw_adSiedzPowiat_Symbol>
        <praw_adSiedzGmina_Symbol>018</praw_adSiedzGmina_Symbol>
        <praw_adSiedzKodPocztowy>00-925</praw_adSiedzKodPocztowy>
        <praw_adSiedzMiejscowosc_Nazwa>Warszawa</praw_adSiedzMiejscowosc_Nazwa>
        <praw_adSiedzUlica_Nazwa>ul. Test-Krucza</praw_adSiedzUlica_Nazwa>
        <praw_adSiedzNumerNieruchomosci>208</praw_adSiedzNumerNieruchomosci>
        <praw_numerTelefonu>226083000</praw_numerTelefonu>
        <praw_adresEmail>dane@stat.gov.pl</praw_adresEmail>
        <praw_adresStronyinternetowej>www.stat.gov.pl</praw_adresStronyinternetowej>
        <praw_podstawowaFormaPrawna_Symbol>2</praw_podstawowaFormaPrawna_Symbol>
        <praw_szczegolnaFormaPrawna_Symbol>01</praw_szczegolnaFormaPrawna_Symbol>
        <praw_formaWlasnosci_Symbol>111</praw_formaWlasnosci_Symbol>
        <praw_liczbaJednLokalnych>16</praw_liczbaJednLokalnych>
      </dane>
    </root>
  ]]></DanePobierzPelnyRaportResult>
</DanePobierzPelnyRaportResponse>
```

--------------------------------

### Get Entity Type Identifier (XML)

Source: https://context7.com/karszo-pp/gus-regon-uslugabir/llms.txt

Retrieves the entity type code for a given REGON number. This code is crucial for determining the appropriate report types to use for fetching detailed information about the entity. The response structure and possible entity type values are provided.

```xml
<!-- Request Entity Type -->
<ns:DanePobierzPelnyRaport>
  <ns:pRegon>012100010</ns:pRegon>
  <ns:pNazwaRaportu>BIR12TypPodmiotu</ns:pNazwaRaportu>
</ns:DanePobierzPelnyRaport>

<!-- Response Structure (based on BIR12TypPodmiotu.xsd) -->
<root>
  <dane>
    <Typ>P</Typ>
  </dane>
</root>

<!-- Entity Type Values:
     P  - Legal Person (Osoba Prawna) - use BIR12OsPrawna* reports
     F  - Natural Person (Osoba Fizyczna) - use BIR12OsFizyczna* reports
     LP - Local Unit of Legal Person - use BIR12JednLokalnaOsPrawnej* reports
     LF - Local Unit of Natural Person - use BIR12JednLokalnaOsFizycznej* reports
-->
```

--------------------------------

### Authentication Login (Zaloguj)

Source: https://context7.com/karszo-pp/gus-regon-uslugabir/llms.txt

Authenticates the client with the GUS REGON BIR service and obtains a session ID (SID). This SID is mandatory for all subsequent API calls.

```APIDOC
## POST /wsBIR/UslugaBIRzewnPubl.svc - Zaloguj

### Description
Authenticates the client and obtains a session ID (SID) required for all subsequent API calls. The session must be established before making any data queries to the REGON service.

### Method
POST

### Endpoint
https://wyszukiwarkaregon.stat.gov.pl/wsBIR/UslugaBIRzewnPubl.svc

### Parameters
#### Request Body
- **pKluczUzytkownika** (string) - Required - Your API key for authentication.

### Request Example
```xml
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope"
               xmlns:ns="http://CIS/BIR/PUBL/2014/07">
  <soap:Header xmlns:wsa="http://www.w3.org/2005/08/addressing">
    <wsa:To>https://wyszukiwarkaregon.stat.gov.pl/wsBIR/UslugaBIRzewnPubl.svc</wsa:To>
    <wsa:Action>http://CIS/BIR/PUBL/2014/07/IUslugaBIRzewnPubl/Zaloguj</wsa:Action>
  </soap:Header>
  <soap:Body>
    <ns:Zaloguj>
      <ns:pKluczUzytkownika>your-api-key-here</ns:pKluczUzytkownika>
    </ns:Zaloguj>
  </soap:Body>
</soap:Envelope>
```

### Response
#### Success Response (200)
- **ZalogujResult** (string) - The obtained session ID (SID).

#### Response Example
```xml
<s:Envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope">
  <s:Body>
    <ZalogujResponse xmlns="http://CIS/BIR/PUBL/2014/07">
      <ZalogujResult>abcd1234567890sessionid</ZalogujResult>
    </ZalogujResponse>
  </s:Body>
</s:Envelope>
```
```

--------------------------------

### Search GUS REGON BIR API Entities (SOAP)

Source: https://context7.com/karszo-pp/gus-regon-uslugabir/llms.txt

Searches for Polish business entities using identifiers like REGON, NIP, or KRS. Requires an active session ID obtained from the 'Zaloguj' method. Returns basic entity information for up to 100 matching records.

```xml
<!-- SOAP Request - Search by NIP (Tax ID) -->
POST https://wyszukiwarkaregon.stat.gov.pl/wsBIR/UslugaBIRzewnPubl.svc HTTP/1.1
Content-Type: application/soap+xml; charset=utf-8
sid: abcd1234567890sessionid

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope"
               xmlns:ns="http://CIS/BIR/PUBL/2014/07"
               xmlns:dat="http://CIS/BIR/PUBL/2014/07/DataContract">
  <soap:Header xmlns:wsa="http://www.w3.org/2005/08/addressing">
    <wsa:To>https://wyszukiwarkaregon.stat.gov.pl/wsBIR/UslugaBIRzewnPubl.svc</wsa:To>
    <wsa:Action>http://CIS/BIR/PUBL/2014/07/IUslugaBIRzewnPubl/DaneSzukajPodmioty</wsa:Action>
  </soap:Header>
  <soap:Body>
    <ns:DaneSzukajPodmioty>
      <ns:pParametryWyszukiwania>
        <dat:Nip>5261040828</dat:Nip>
      </ns:pParametryWyszukiwania>
    </ns:DaneSzukajPodmioty>
  </soap:Body>
</soap:Envelope>

<!-- Search by REGON -->
<ns:pParametryWyszukiwania>
  <dat:Regon>012100010</dat:Regon>
</ns:pParametryWyszukiwania>

<!-- Search by multiple REGONs (comma-separated, max 100) -->
<ns:pParametryWyszukiwania>
  <dat:Regony9zn>012100010,000331501,001130884</dat:Regony9zn>
</ns:pParametryWyszukiwania>

<!-- Search by KRS -->
<ns:pParametryWyszukiwania>
  <dat:Krs>0000028860</dat:Krs>
</ns:pParametryWyszukiwania>

<!-- SOAP Response -->
<DaneSzukajPodmiotyResponse xmlns="http://CIS/BIR/PUBL/2014/07">
  <DaneSzukajPodmiotyResult><![CDATA[
    <root>
      <dane>
        <Regon>012100010</Regon>
        <Nip>5261040828</Nip>
        <StatusNip></StatusNip>
        <Nazwa>GLOWNY URZAD STATYSTYCZNY</Nazwa>
        <Wojewodztwo>MAZOWIECKIE</Wojewodztwo>
        <Powiat>m. st. Warszawa</Powiat>
        <Gmina>Srodmiescie</Gmina>
        <Miejscowosc>Warszawa</Miejscowosc>
        <KodPocztowy>00-925</KodPocztowy>
        <Ulica>ul. Test-Krucza</Ulica>
        <NrNieruchomosci>208</NrNieruchomosci>
        <Typ>P</Typ>
        <SilosID>6</SilosID>
        <DataZakonczeniaDzialalnosci></DataZakonczeniaDzialalnosci>
        <MiejscowoscPoczty>Warszawa</MiejscowoscPoczty>
      </dane>
    </root>
  ]]></DaneSzukajPodmiotyResult>
</DaneSzukajPodmiotyResponse>
```

--------------------------------

### Authenticate with GUS REGON BIR API (SOAP)

Source: https://context7.com/karszo-pp/gus-regon-uslugabir/llms.txt

Authenticates with the GUS REGON BIR API to obtain a session ID (SID). This is a prerequisite for all subsequent API calls. The request includes the API key, and the response contains the session ID.

```xml
<!-- SOAP Request - Login to obtain session -->
POST https://wyszukiwarkaregon.stat.gov.pl/wsBIR/UslugaBIRzewnPubl.svc HTTP/1.1
Content-Type: application/soap+xml; charset=utf-8

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope"
               xmlns:ns="http://CIS/BIR/PUBL/2014/07">
  <soap:Header xmlns:wsa="http://www.w3.org/2005/08/addressing">
    <wsa:To>https://wyszukiwarkaregon.stat.gov.pl/wsBIR/UslugaBIRzewnPubl.svc</wsa:To>
    <wsa:Action>http://CIS/BIR/PUBL/2014/07/IUslugaBIRzewnPubl/Zaloguj</wsa:Action>
  </soap:Header>
  <soap:Body>
    <ns:Zaloguj>
      <ns:pKluczUzytkownika>your-api-key-here</ns:pKluczUzytkownika>
    </ns:Zaloguj>
  </soap:Body>
</soap:Envelope>

<!-- SOAP Response - Session ID returned -->
<s:Envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope">
  <s:Body>
    <ZalogujResponse xmlns="http://CIS/BIR/PUBL/2014/07">
      <ZalogujResult>abcd1234567890sessionid</ZalogujResult>
    </ZalogujResponse>
  </s:Body>
</s:Envelope>
```

--------------------------------

### Search Entities (DaneSzukajPodmioty)

Source: https://context7.com/karszo-pp/gus-regon-uslugabir/llms.txt

Searches for business entities using various identifiers such as REGON, NIP, or KRS. Returns basic information for matching records.

```APIDOC
## POST /wsBIR/UslugaBIRzewnPubl.svc - DaneSzukajPodmioty

### Description
Searches for business entities using various identifiers including REGON (9 or 14 digit), NIP (tax ID), KRS (court registry number), or by name/address combinations. Returns basic entity information for up to 100 matching records.

### Method
POST

### Endpoint
https://wyszukiwarkaregon.stat.gov.pl/wsBIR/UslugaBIRzewnPubl.svc

### Headers
- **sid**: (string) - Required - The session ID obtained from the `Zaloguj` endpoint.

### Parameters
#### Request Body
- **pParametryWyszukiwania** (object) - Required - Object containing search criteria.
  - **Nip** (string) - Optional - Polish Tax Identification Number (NIP).
  - **Regon** (string) - Optional - REGON number (9 or 14 digits).
  - **Regony9zn** (string) - Optional - Comma-separated list of 9-digit REGON numbers (max 100).
  - **Krs** (string) - Optional - Polish National Court Register number (KRS).

### Request Example
```xml
<!-- Search by NIP -->
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope"
               xmlns:ns="http://CIS/BIR/PUBL/2014/07"
               xmlns:dat="http://CIS/BIR/PUBL/2014/07/DataContract">
  <soap:Header xmlns:wsa="http://www.w3.org/2005/08/addressing">
    <wsa:To>https://wyszukiwarkaregon.stat.gov.pl/wsBIR/UslugaBIRzewnPubl.svc</wsa:To>
    <wsa:Action>http://CIS/BIR/PUBL/2014/07/IUslugaBIRzewnPubl/DaneSzukajPodmioty</wsa:Action>
  </soap:Header>
  <soap:Body>
    <ns:DaneSzukajPodmioty>
      <ns:pParametryWyszukiwania>
        <dat:Nip>5261040828</dat:Nip>
      </ns:pParametryWyszukiwania>
    </ns:DaneSzukajPodmioty>
  </soap:Body>
</soap:Envelope>

<!-- Search by REGON -->
<ns:pParametryWyszukiwania>
  <dat:Regon>012100010</dat:Regon>
</ns:pParametryWyszukiwania>

<!-- Search by multiple REGONs -->
<ns:pParametryWyszukiwania>
  <dat:Regony9zn>012100010,000331501,001130884</dat:Regony9zn>
</ns:pParametryWyszukiwania>

<!-- Search by KRS -->
<ns:pParametryWyszukiwania>
  <dat:Krs>0000028860</dat:Krs>
</ns:pParametryWyszukiwania>
```

### Response
#### Success Response (200)
- **DaneSzukajPodmiotyResult** (string) - XML string containing the search results. The structure includes a `root` element with `dane` elements for each matching entity.

#### Response Example
```xml
<DaneSzukajPodmiotyResponse xmlns="http://CIS/BIR/PUBL/2014/07">
  <DaneSzukajPodmiotyResult><![CDATA[
    <root>
      <dane>
        <Regon>012100010</Regon>
        <Nip>5261040828</Nip>
        <StatusNip></StatusNip>
        <Nazwa>GLOWNY URZAD STATYSTYCZNY</Nazwa>
        <Wojewodztwo>MAZOWIECKIE</Wojewodztwo>
        <Powiat>m. st. Warszawa</Powiat>
        <Gmina>Srodmiescie</Gmina>
        <Miejscowosc>Warszawa</Miejscowosc>
        <KodPocztowy>00-925</KodPocztowy>
        <Ulica>ul. Test-Krucza</Ulica>
        <NrNieruchomosci>208</NrNieruchomosci>
        <Typ>P</Typ>
        <SilosID>6</SilosID>
        <DataZakonczeniaDzialalnosci></DataZakonczeniaDzialalnosci>
        <MiejscowoscPoczty>Warszawa</MiejscowoscPoczty>
      </dane>
    </root>
  ]]></DaneSzukajPodmiotyResult>
</DaneSzukajPodmiotyResponse>
```
```

--------------------------------

### Error Handling

Source: https://context7.com/karszo-pp/gus-regon-uslugabir/llms.txt

Details on how the API returns error codes and common error scenarios.

```APIDOC
## Error Handling

### Description
The API returns error codes embedded in the response XML when operations fail. Common error codes include search failures, invalid parameters, and data availability issues.

### Common Error Codes
- **4** - No data found for search criteria
- **5** - Invalid or empty report name / invalid identifier
- **7** - Invalid session (re-authenticate required)
- **11** - PKD data not available for entities deleted before 2014-11-08
- **21** - Entity is not a civil law partnership
- **22** - No partners found for civil partnership

### Error Response Example (Error Code 4)
```xml
<DanePobierzPelnyRaportResponse xmlns="http://CIS/BIR/PUBL/2014/07">
  <DanePobierzPelnyRaportResult><![CDATA[
    <root>
      <dane>
        <ErrorCode>4</ErrorCode>
        <ErrorMessagePl>Nie znaleziono wpisu dla podanych kryteriow wyszukiwania.</ErrorMessagePl>
        <ErrorMessageEn>No data found for the specified search criteria.</ErrorMessageEn>
        <pRegon>999999999</pRegon>
        <Typ_podmiotu></Typ_podmiotu>
        <Raport>BIR12OsFizycznaDaneOgolne</Raport>
      </dane>
    </root>
  ]]></DanePobierzPelnyRaportResult>
</DanePobierzPelnyRaportResponse>
```
```

--------------------------------

### Handle API Error Codes in XML Responses

Source: https://context7.com/karszo-pp/gus-regon-uslugabir/llms.txt

This snippet demonstrates how to interpret common error codes returned by the API within the response XML. It covers errors related to search failures, invalid parameters, and data availability issues, providing specific error codes and their meanings.

```xml
<!-- Error Code 4 - No data found for search criteria -->
<DanePobierzPelnyRaportResponse xmlns="http://CIS/BIR/PUBL/2014/07">
  <DanePobierzPelnyRaportResult><![CDATA[
    <root>
      <dane>
        <ErrorCode>4</ErrorCode>
        <ErrorMessagePl>Nie znaleziono wpisu dla podanych kryteriow wyszukiwania.</ErrorMessagePl>
        <ErrorMessageEn>No data found for the specified search criteria.</ErrorMessageEn>
        <pRegon>999999999</pRegon>
        <Typ_podmiotu></Typ_podmiotu>
        <Raport>BIR12OsFizycznaDaneOgolne</Raport>
      </dane>
    </root>
  ]]></DanePobierzPelnyRaportResult>
</DanePobierzPelnyRaportResponse>

<!-- Error Code 5 - Invalid or empty report name -->
<root>
  <dane>
    <ErrorCode>5</ErrorCode>
    <ErrorMessagePl>Nieprawidlowa lub pusta nazwa raportu lub nieprawidlowy identyfikator.</ErrorMessagePl>
    <ErrorMessageEn>Invalid or empty report name or invalid identifier.</ErrorMessageEn>
    <pRegon>99999999900099</pRegon>
    <Typ_podmiotu></Typ_podmiotu>
    <Raport>BIR1.2JednLokalnaOsFizycznej</Raport>
  </dane>
</root>

<!-- Error Code 11 - PKD not available for entities deleted before 2014-11-08 -->
<root>
  <dane>
    <ErrorCode>11</ErrorCode>
    <ErrorMessagePl>Dla podmiotow skreshlonych przed 2014-11-08 dzialalnosci PKD nie sa udostepniane.</ErrorMessagePl>
    <ErrorMessageEn>For entities deleted before 2014-11-08, the PKDs are not made available.</ErrorMessageEn>
    <pRegon>021625560</pRegon>
    <Typ_podmiotu>F</Typ_podmiotu>
    <Raport>BIR12OsFizycznaPkd</Raport>
  </dane>
</root>

<!-- Common Error Codes:
     4  - No data found for search criteria
     5  - Invalid or empty report name / invalid identifier
     7  - Invalid session (re-authenticate required)
     11 - PKD data not available for entities deleted before 2014-11-08
     21 - Entity is not a civil law partnership
     22 - No partners found for civil partnership
-->
```