Metadata-Version: 2.4
Name: vericorp
Version: 1.0.0
Summary: Python SDK for the VeriCorp API — European company verification
Project-URL: Homepage, https://github.com/vericorptest-collab/vericorp-python
Project-URL: Documentation, https://rapidapi.com/vericorp/api/vericorp-api
Author: VeriCorp
License-Expression: MIT
Keywords: api,company,europe,tax-id,validation,vat,vies
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Typing :: Typed
Requires-Python: >=3.9
Requires-Dist: httpx>=0.24
Requires-Dist: pydantic>=2.0
Description-Content-Type: text/markdown

# VeriCorp Python SDK

Python SDK for the [VeriCorp API](https://rapidapi.com/vericorp/api/vericorp-api) — European company verification.

## Install

```bash
pip install vericorp
```

## Quick Start

```python
from vericorp import VeriCorp

client = VeriCorp("your-rapidapi-key")

# Look up a company
company = client.lookup("PT502011378")
print(company.name)       # UNIVERSIDADE DO MINHO
print(company.address)    # Address(street='LG DO PACO', city='BRAGA', ...)

# Validate a VAT number
result = client.validate("DE811871080")
print(result.vat_valid)   # True

# List supported countries
countries = client.countries()
print(countries.total)    # 29
```

## Async

```python
from vericorp import AsyncVeriCorp

async with AsyncVeriCorp("your-rapidapi-key") as client:
    company = await client.lookup("DK10150817")
    print(company.name)
```

## Methods

| Method | Description |
|--------|-------------|
| `lookup(tax_id)` | Look up company by tax ID |
| `lookup_gb(company_number)` | Look up UK company by number |
| `validate(tax_id)` | Validate a VAT number |
| `batch(tax_ids)` | Batch lookup (max 10) |
| `countries()` | List supported countries |
| `health()` | API health check |

## Error Handling

```python
from vericorp.errors import InvalidTaxIdError, NotFoundError, RateLimitError

try:
    company = client.lookup("INVALID")
except InvalidTaxIdError:
    print("Bad tax ID format")
except NotFoundError:
    print("Company not found")
except RateLimitError as e:
    print(f"Rate limited, retry after {e.retry_after}s")
```

## License

MIT
