# 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
