nipdata.pl — Dokumentacja REST API

curl -H "Authorization: Bearer <TWOJ_TOKEN>" \
     https://api.nipdata.pl/v1/company/5252344078

data.name                  // nazwa firmy
data.regon                 // REGON
data.address.city          // miasto
data.vat.status            // "czynny" | "zwolniony" | "niezarejestrowany"
data.vat.bank_accounts     // ["IBAN1", "IBAN2", ...]
data.vat.request_id        // dowód weryfikacji MF — zachowaj w logu compliance

https://api.nipdata.pl/v1/company/{nip}
└────────────────────┘ └┘ └─────┘ └─┘
        host           v1   res    id

Authorization: Bearer <TWOJ_TOKEN>

Authorization: Bearer <TWOJ_TOKEN>
Accept: application/json

curl -H "Authorization: Bearer <TWOJ_TOKEN>" \
     https://api.nipdata.pl/v1/company/5252344078

{
  "nip": "5252344078",
  "regon": "140182840",
  "krs": "0000240611",
  "name": "GOOGLE POLAND SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ",
  "legal_form": "Osoba prawna",
  "legal_form_code": "OSP",
  "address": {
    "street": "Rondo Ignacego Daszyńskiego",
    "building_no": "2C",
    "apartment_no": null,
    "postal_code": "00-843",
    "city": "Warszawa",
    "voivodeship": "MAZOWIECKIE",
    "country": "PL"
  },
  "pkd": [],
  "registration_date": "2005-10-06",
  "status": "aktywna",
  "vat": {
    "status": "czynny",
    "bank_accounts": [
      "93103015080000000504162006",
      "37103015080000000504162044",
      "34103015080000000504162001"
    ],
    "request_id": "bZMVJ-976hcnb",
    "checked_for_date": "2026-05-04"
  },
  "sources": ["gus", "biala_lista"],
  "fetched_at": "2026-05-04T12:38:12.035845Z",
  "cache_hit": false
}

curl https://api.nipdata.pl/v1/health

{ "status": "ok" }

curl https://api.nipdata.pl/v1/ready

{
  "status": "ok",
  "db": true,
  "adapters": {
    "gus": true,
    "biala_lista": true,
    "vies": false,
    "krs": false,
    "ceidg": false
  },
  "environment": "production",
  "gus_environment": "production"
}

{ "version": "0.2.0", "api_version": "v1" }

{
  nip:                string                  // wymagane, 10 cyfr
  regon:              string | null           // 9 lub 14 cyfr
  krs:                string | null           // 10 cyfr (z wiodącymi zerami)
  name:               string | null           // pełna nazwa firmy (z GUS lub BL)
  short_name:         string | null           // krótka nazwa — puste w MVP
  legal_form:         string | null           // np. "Osoba prawna"
  legal_form_code:    string | null           // "OSP" | "JDG" | "JL_P" | "JL_F"

  address: {
    street:           string | null
    building_no:      string | null
    apartment_no:     string | null
    postal_code:      string | null           // format "00-843"
    city:             string | null
    voivodeship:      string | null           // np. "MAZOWIECKIE"
    country:          string                   // domyślnie "PL"
  } | null

  pkd: [                                       // puste w MVP, dorzucone w kolejnej iteracji
    {
      code:           string                   // np. "73.11.Z"
      description:    string
      is_main:        boolean
    }
  ]

  registration_date:  string | null            // format ISO "YYYY-MM-DD"
  suspension_date:    string | null
  dissolution_date:   string | null
  status:             string | null            // "aktywna" | "zakończona"

  vat: {
    status:           "czynny" | "zwolniony" | "niezarejestrowany"   // wymagane
    bank_accounts:    string[]                 // lista IBAN-ów (26 cyfr)
    request_id:       string | null            // dowód weryfikacji MF (KLUCZOWE — zapisz!)
    checked_for_date: string                   // wymagane, format "YYYY-MM-DD"
  } | null

  vies_valid:         boolean | null           // Faza 1+ (VAT-UE)
  vies_checked_at:    string | null            // ISO timestamp

  krs_info: {                                  // Faza 1+ (KRS API)
    krs:              string
    legal_form:       string | null
    capital_grosze:   number | null
    board:            BoardMember[]
    partners:         Partner[]
    representation_rules: string | null
  } | null

  ceidg_active:       boolean | null           // Faza 1+

  sources:            string[]                 // wymagane, np. ["gus", "biala_lista"]
  fetched_at:         string                   // wymagane, ISO timestamp UTC
  cache_hit:          boolean                  // wymagane, czy dane z cache
}

{ name: string, surname: string, function: string, appointed_at: string | null, revoked_at: string | null }

{ name: string | null, surname: string | null, company_name: string | null, shares: string | null }

{
  "detail": {
    "error": {
      "code": "<machine_readable_code>",
      "message": "<human_readable_message_pl>"
    }
  }
}

weights = [6, 5, 7, 2, 3, 4, 5, 6, 7]
checksum = sum(NIP[i] * weights[i] for i in 0..8) mod 11
NIP jest poprawny ⟺ checksum != 10 AND checksum == NIP[9]

CREATE TABLE contractor_verifications (
  id              SERIAL PRIMARY KEY,
  contractor_nip  VARCHAR(10) NOT NULL,
  vat_status      VARCHAR(32) NOT NULL,         -- "czynny" / "zwolniony" / "niezarejestrowany"
  vat_request_id  VARCHAR(32),                  -- ← klucz: dowód MF
  bank_accounts   JSONB,                        -- snapshot rachunków na moment weryfikacji
  checked_for_date DATE NOT NULL,
  verified_at     TIMESTAMPTZ DEFAULT NOW(),
  source          VARCHAR(32) DEFAULT 'nipdata.pl'
);

<?php
$nip = '5252344078';
$token = getenv('NIPDATA_TOKEN');

$ch = curl_init("https://api.nipdata.pl/v1/company/{$nip}");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ["Authorization: Bearer {$token}"],
    CURLOPT_TIMEOUT        => 35,
    CURLOPT_CONNECTTIMEOUT => 10,
]);
$body   = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status === 200) {
    $d = json_decode($body, true);
    echo "Firma: {$d['name']}\n";
    echo "REGON: {$d['regon']}\n";
    echo "VAT: {$d['vat']['status']}\n";
    echo "Konta na BL: " . count($d['vat']['bank_accounts']) . "\n";
    echo "request_id (zapisz!): {$d['vat']['request_id']}\n";
} elseif ($status === 404) {
    echo "Brak firmy o tym NIP w GUS/BL\n";
} elseif ($status === 422) {
    echo "Niepoprawny NIP (suma kontrolna)\n";
} else {
    $err = json_decode($body, true);
    echo "Błąd HTTP {$status}: {$err['detail']['error']['message']}\n";
}

import httpx
import os
from typing import Optional

NIPDATA_TOKEN = os.environ["NIPDATA_TOKEN"]


def get_company(nip: str) -> Optional[dict]:
    """Zwraca dane firmy lub None gdy NIP poprawny ale firma nieznana."""
    response = httpx.get(
        f"https://api.nipdata.pl/v1/company/{nip}",
        headers={"Authorization": f"Bearer {NIPDATA_TOKEN}"},
        timeout=35.0,
    )
    if response.status_code == 422:
        raise ValueError(f"Niepoprawny NIP: {nip}")
    if response.status_code == 404:
        return None
    response.raise_for_status()
    return response.json()


# Użycie
data = get_company("5252344078")
if data:
    print(f"Firma: {data['name']}")
    print(f"VAT status: {data['vat']['status']}")
    print(f"Rachunki: {data['vat']['bank_accounts']}")
    print(f"Dowód weryfikacji (request_id): {data['vat']['request_id']}")

import requests, os

resp = requests.get(
    "https://api.nipdata.pl/v1/company/5252344078",
    headers={"Authorization": f"Bearer {os.environ['NIPDATA_TOKEN']}"},
    timeout=35,
)
resp.raise_for_status()
data = resp.json()

const NIPDATA_TOKEN = process.env.NIPDATA_TOKEN;

async function getCompany(nip) {
    const response = await fetch(
        `https://api.nipdata.pl/v1/company/${nip}`,
        {
            headers: { 'Authorization': `Bearer ${NIPDATA_TOKEN}` },
            signal: AbortSignal.timeout(35_000),
        }
    );
    if (response.status === 404) return null;
    if (response.status === 422) throw new Error('Niepoprawny NIP');
    if (!response.ok) throw new Error(`HTTP ${response.status}`);
    return await response.json();
}

const data = await getCompany('5252344078');
console.log(data.name, data.vat.status);

# GET dane firmy
curl -H "Authorization: Bearer $NIPDATA_TOKEN" \
     https://api.nipdata.pl/v1/company/5252344078 | jq

# Health (publiczne)
curl https://api.nipdata.pl/v1/ready | jq

# Test 422 — niepoprawny NIP
curl -i -H "Authorization: Bearer $NIPDATA_TOKEN" \
     https://api.nipdata.pl/v1/company/1234567890

# Test 401 — brak tokenu
curl -i https://api.nipdata.pl/v1/company/5252344078