API danych firmy

{
  "message": "Invalid JSON body.",
  "errors": {
    "body": ["Malformed JSON: Syntax error"]
  }
}

{
  "error": "Missing API token",
  "code":  "UNAUTHORIZED"
}

{
  "error": "Malformed token format",
  "code":  "UNAUTHORIZED"
}

{
  "message": "The route api/v1/companies/unknown could not be found."
}

{
  "message": "The email field must be a valid email address. (and 1 more error)",
  "errors": {
    "email": [
      "The email field must be a valid email address."
    ],
    "name": [
      "The name field is required."
    ]
  }
}

{
  "message": "Too Many Attempts."
}

{
  "message": "Server Error"
}

POST /api/v1/auth/register

curl -X POST https://api.entiway.com/api/v1/auth/register \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "email":                 "[email protected]",
    "name":                  "my-integration",
    "password":             "YourPassword123",
    "password_confirmation": "YourPassword123"
  }'

{
  "user_ref":   "3XPT7SS5VG3B",
  "email":      "[email protected]",
  "message":    "Registration successful. Check your email to initialize your account.",
  "expires_at": "2026-03-18T10:48:59+00:00"
}

POST /api/v1/auth/init

curl -X POST https://api.entiway.com/api/v1/auth/init \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "token": "6d6c675fcebf98fdbeed11055f98fada..."
  }'

{
  "user_ref":      "3XPT7SS5VG3B",
  "email":         "[email protected]",
  "master_token":  "sk_live_5a4a9438c8b8d46836b2dd70bc95d0ee...",
  "token_ref":     "O752ABABBLBE",
  "message":       "Account initialized successfully. Save your Master Token securely - you will not see it again!"
}

POST /api/v1/auth/recover

curl -X POST https://api.entiway.com/api/v1/auth/recover \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "email":    "[email protected]",
    "password": "YourPassword123"
  }'

{
  "message":    "If an account with this email exists, a recovery email has been sent.",
  "expires_at": "2026-03-27T09:15:20+00:00"
}

{
  "message": "Recovery confirmation failed",
  "errors":  { "email": ["The email field is required."] }
}

POST /api/v1/tokens

curl -X POST https://api.entiway.com/api/v1/tokens \
  -H "Authorization: Bearer sk_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-integration",
    "expires_in_days": 90
  }'

{
  "success": true,
  "data": {
    "token_ref":  "NAHZ4GW2C26H",
    "name":       "my-integration",
    "expires_at": "2026-06-24T11:10:57+00:00",
    "is_active":  true,
    "plaintext":  "sk_api_4b06f7ebafdd3b3cde52712e12de4a5d...",
    "warning":    "Save this token now - it will never be shown again!"
  },
  "meta": {
    "timestamp": "2026-03-24T11:10:57+00:00"
  }
}

GET /api/v1/tokens

curl https://api.entiway.com/api/v1/tokens \
  -H "Authorization: Bearer sk_live_xxxx" \
  -H "Accept: application/json"

GET /api/v1/tokens/{token_ref}

curl https://api.entiway.com/api/v1/tokens/{token_ref} \
  -H "Authorization: Bearer sk_live_xxxx" \
  -H "Accept: application/json"

PUT /api/v1/tokens/{token_ref}

curl -X PUT https://api.entiway.com/api/v1/tokens/{token_ref} \
  -H "Authorization: Bearer sk_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{ "name": "production-name-change" }'

DELETE /api/v1/tokens/{token_ref}

curl -X DELETE https://api.entiway.com/api/v1/tokens/{token_ref} \
  -H "Authorization: Bearer sk_live_xxxx" \
  -H "Accept: application/json"

POST /api/v1/tokens/verify

curl -X POST https://api.entiway.com/api/v1/tokens/verify \
  -H "Authorization: Bearer sk_api_xxxx" \
  -H "Accept: application/json"

POST /api/v1/tokens/{token_ref}/rotate

curl -X POST https://api.entiway.com/api/v1/tokens/{token_ref}/rotate \
  -H "Authorization: Bearer sk_live_xxxx" \
  -H "Accept: application/json"

GET /api/v1/wallet

curl https://api.entiway.com/api/v1/wallet \
  -H "Authorization: Bearer sk_api_xxxx" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json"

{
  "status": "success",
  "data": {
    "balance":         99845,
    "total_purchased": 100000
  }
}

POST /api/v1/wallet/topup

curl -X POST https://api.entiway.com/api/v1/wallet/topup \
  -H "Authorization: Bearer sk_api_xxxx" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{ "package_slug": "pack_10k" }'

{
  "status": "success",
  "data": {
    "checkout_url": "https://app.entiway.com/checkout-pay?_ptxn=txn_01kkxrrc...",
    "package":      "pack_10k",
    "credits":      10000
  }
}

GET /api/v1/wallet/transactions?page=1

curl "https://api.entiway.com/api/v1/wallet/transactions?page=1" \
  -H "Authorization: Bearer sk_api_xxxx" \
  -H "Accept: application/json"

{
  "status": "success",
  "data": [
    {
      "type":          "deposit",
      "amount":        "10000.00",
      "balance_after": "10200.00",
      "description":   "Wallet top-up (Paddle)",
      "created_at":    "2026-03-30T08:40:05.000000Z"
    },
    {
      "type":          "start",
      "amount":        "200.00",
      "balance_after": "200.00",
      "description":   "Welcome bonus credits",
      "created_at":    "2026-03-30T06:55:25.000000Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page":    1,
    "per_page":     20,
    "total":        2,
    "next_page":    null,
    "prev_page":    null
  }
}

GET /api/v1/companies/search

curl "https://api.entiway.com/api/v1/companies/search?activity_start_from=2026-02-01&activity_start_to=2026-03-01" \
  -H "Authorization: Bearer sk_api_xxxx" \
  -H "Accept: application/json"

{
  "status": "success",
  "data": {
    "total":        25483,
    "per_page":     20,
    "current_page": 1,
    "last_page":    1275,
    "results": [
      {
        "identifiers": [
          { "type": "NIP",    "value": "9876540016" },
          { "type": "REGON9", "value": "987600000" }
        ],
        "name":           "MALOWANIE I SZKLENIE JAN PRZYKŁADOWY",
        "city":           "Nowy Sącz",
        "voivodeship":    "małopolskie",
        "activity_start": "2026-02-14",
        "activity_main":  "4334Z",
        "status":         "ACTIVE",
        "contacts": [
          { "type": "phone", "value": "123456789" }
        ]
      }
    ]
  }
}

POST /api/v1/companies/snapshot

curl -X POST https://api.entiway.com/api/v1/companies/snapshot \
  -H "Authorization: Bearer sk_api_xxxx" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "identifier_type": "REGON9",
    "identifier_value": "123400000"
  }'

{
  "status": "success",
  "data": {
    "identity": {
      "identifiers": [
        { "type": "NIP",    "value": "1234560007" },
        { "type": "REGON9", "value": "123400000"  }
      ],
      "company_type": "physical_person",
      "country_code": "PL"
    },
    "profiles": [
      {
        "name":       "Gabinet Fizjoterapii Anna Przykładowa",
        "status":     "ACTIVE",
        "legal_form": "jdg",
        "address": {
          "street":      "ul. Słoneczna",
          "building":    "5",
          "apartment":   "2",
          "city":        "Wrocław",
          "postal_code": "50-001",
          "voivodeship": "dolnośląskie",
          "county":      "m. Wrocław",
          "commune":     "Wrocław",
          "country_code": "PL"
        },
        "units": [
          {
            "identifier": "12340000000017",
            "name":       "Gabinet Fizjoterapii Anna Przykładowa – Filia",
            "address":   { /* same structure as above */ },
            "dates": [
              { "type": "establishment",  "date": "2024-03-01" },
              { "type": "activity_start", "date": "2024-03-01" }
            ]
          }
        ],
        "contacts": [
          { "type": "phone", "value": "123456789" }
        ],
        "activities": [
          { "code": "8690A", "name": "DZIAŁALNOŚĆ FIZJOTERAPEUTYCZNA", "is_primary": true }
        ],
        "dates": [
          { "type": "establishment",                       "date": "2020-01-02" },
          { "type": "activity_start",                      "date": "2020-01-02" },
          { "type": "data_of_entry_in_the_REGON_register", "date": "2020-01-02" }
        ],
        "websites": []
      }
    ],
    "persons": [
      { "full_name": "ANNA MARIA PRZYKŁADOWA", "role": "owner" }
    ]
  },
  "meta": {
    "fetched_at": "2026-10-25T12:00:00+00:00"
  }
}

POST /api/v1/companies/snapshot

  -d '{
    "identifier_type":  "KRS",
    "identifier_value": "0000000003",
    "include": ["capital", "shareholders", "proceedings", "filings", "predecessors"]
  }'

{
  "status": "success",
  "data": {
    "identity": { /* core as above */ },
    "profiles": [ /* core as above */ ],
    "persons":  [ /* core as above */ ],
    "krs": {
      "capital": { "type": "share_capital", "amount": "50000.00", "currency": "PLN" },
      "shareholders": [
        { "holder_type": "company", "name": "PRZYKŁAD HOLDING SP. Z O.O.", "krs": "0000000001", "regon": "987600000",
          "shares_count": 80, "shares_value": "40000.00", "currency": "PLN", "holds_all_shares": false, "since": "2021-03-01" },
        { "holder_type": "person", "name": "J** P*********", "krs": null, "regon": null,
          "shares_count": 20, "shares_value": "10000.00", "currency": "PLN", "holds_all_shares": false, "since": "2019-06-12" }
      ],
      "proceedings": [
        { "type": "TAX_ARREARS", "since": "2025-11-04", "organ": null, "signature": null, "amount": "12500.00", "currency": "PLN" }
      ],
      "filings": [
        { "type": "annual_financial_statement", "consolidated": false, "period_from": "2025-01-01", "period_to": "2025-12-31", "filing_date": "2026-06-28" },
        { "type": "approval_resolution",        "consolidated": false, "period_from": "2025-01-01", "period_to": "2025-12-31", "filing_date": null }
      ],
      "predecessors": []
    }
  },
  "meta": {
    "fetched_at": "2026-10-25T12:00:00+00:00",
    "include": ["capital", "shareholders", "proceedings", "filings", "predecessors"],
    "include_not_applicable": false
  }
}

POST /api/v1/companies/add

curl -X POST https://api.entiway.com/api/v1/companies/add \
  -H "Authorization: Bearer sk_api_xxxx" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "country_code":     "PL",
    "identifier_type":  "REGON9",
    "identifier_value": ["123400000", "987600000", "123400017"]
  }'

{
  "success": true,
  "message": "Accepted for processing."
}

GET /api/v1/companies/watched

curl "https://api.entiway.com/api/v1/companies/watched?page=1" \
  -H "Authorization: Bearer sk_api_xxxx" \
  -H "Accept: application/json"

{
  "success": true,
  "data": [
    {
      "primary_identifier": "123400000",
      "name":               "Gabinet Fizjoterapii Anna Przykładowa",
      "watched_since":      "2026-03-24",
      "last_event_at":      null,
      "watched_events":     0
    },
    {
      "primary_identifier": "987600000",
      "name":               "MALOWANIE I SZKLENIE JAN PRZYKŁADOWY",
      "watched_since":      "2026-03-18",
      "last_event_at":      "2026-04-02",
      "watched_events":     6
    }
  ],
  "meta": {
    "total":        38,
    "per_page":     20,
    "current_page": 1,
    "last_page":    2
  }
}

DELETE /api/v1/companies/watched

curl -X DELETE https://api.entiway.com/api/v1/companies/watched \
  -H "Authorization: Bearer sk_api_xxxx" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "country_code":     "PL",
    "identifier_type":  "REGON9",
    "identifier_value": ["123400000"]
  }'

{
  "success": true,
  "data": {
    "removed":     ["123400000"],
    "not_found":   [],
    "not_watched": []
  },
  "meta": {
    "total":       1,
    "removed":     1,
    "not_found":   0,
    "not_watched": 0,
    "removed_at":  "2026-03-24T15:18:25+00:00"
  }
}

GET /api/v1/companies/events

curl "https://api.entiway.com/api/v1/companies/events?identifier_type=NIP&identifier_value=1234560007" \
  -H "Authorization: Bearer sk_api_xxxx" \
  -H "Accept: application/json"

{
  "status": "success",
  "data": {
    "events": [
      {
        "event_type": "COMPANY_NAME_CHANGED",
        "old_value":  "Jan Przykładowy",
        "new_value":  "Jan Przykładowy wspólnik spółki cywilnej PRZYKŁAD S.C.",
        "event_date": "2025-10-06",
        "severity":   "info"
      },
      {
        "event_type": "COMPANY_CLOSED_DATE",
        "old_value":  null,
        "new_value":  "2026-02-28",
        "event_date": "2025-10-06",
        "severity":   "critical"
      }
    ]
  },
  "meta": {
    "total":        8,
    "per_page":     20,
    "current_page": 1,
    "last_page":    1,
    "fetched_at":   "2026-03-24T15:20:44+00:00"
  }
}

GET /api/v1/watchlist/events

curl "https://api.entiway.com/api/v1/watchlist/events?from_date=2026-03-01&to_date=2026-03-24" \
  -H "Authorization: Bearer sk_api_xxxx" \
  -H "Accept: application/json"

{
  "status": "success",
  "data": [
    {
      "primary_identifier": "987600000",
      "name":               "MALOWANIE I SZKLENIE JAN PRZYKŁADOWY",
      "event_type":         "COMPANY_START_DATE_CHANGE",
      "old_value":          "2026-02-25",
      "new_value":          "2026-03-02",
      "event_date":         "2026-03-02",
      "severity":           "notice"
    }
  ],
  "meta": {
    "total":        170,
    "per_page":     20,
    "current_page": 1,
    "last_page":    9,
    "fetched_at":   "2026-03-24T15:55:25+00:00"
  }
}

GET /api/v1/watchlist/alerts

# global
curl "https://api.entiway.com/api/v1/watchlist/alerts" \
  -H "Authorization: Bearer sk_api_xxxx" \
  -H "Accept: application/json"

# per company
curl "https://api.entiway.com/api/v1/watchlist/alerts?identifier_type=NIP&identifier_value=1234560007" \
  -H "Authorization: Bearer sk_api_xxxx" \
  -H "Accept: application/json"

{
  "success": true,
  "data": {
    "updated": 0,
    "settings": {
      "source":              "global",
      "alerts_enabled":      true,
      "alert_min_severity":  "warning",
      "alert_event_classes": null,
      "alert_categories":    null,
      "notify_via_email":    true
    }
  }
}

PATCH /api/v1/watchlist/alerts

curl -X PATCH "https://api.entiway.com/api/v1/watchlist/alerts" \
  -H "Authorization: Bearer sk_api_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "alert_min_severity": "warning",
    "alerts_enabled":     true,
    "notify_via_email":   true
  }'

PATCH /api/v1/watchlist/alerts

curl -X PATCH "https://api.entiway.com/api/v1/watchlist/alerts" \
  -H "Authorization: Bearer sk_api_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "alert_min_severity":  "high",
    "alerts_enabled":      true,
    "notify_via_email":    true,
    "alert_event_classes": ["risk", "anomaly"],
    "identifier_type":     "NIP",
    "identifier_value":    "1234560007"
  }'

{
  "success": true,
  "data": {
    "updated": 1,
    "settings": {
      "source":              "company_override",
      "alerts_enabled":      true,
      "alert_min_severity":  "high",
      "alert_event_classes": ["risk", "anomaly"],
      "alert_categories":    null,
      "notify_via_email":    true
    }
  }
}

{
  "success": false,
  "message": "Company not found on your watchlist."
}