Metadata-Version: 2.4
Name: sepa-check
Version: 0.1.0
Summary: CLI for the free SEPA pain.001 validator API at checksepa.com
Author-email: Bobook Limited <info@bobook.club>
License-Expression: MIT
Project-URL: Homepage, https://checksepa.com
Project-URL: Documentation, https://checksepa.com/docs
Project-URL: Repository, https://github.com/wenboteng/sepa-validator
Project-URL: API waitlist, https://checksepa.com/api-waitlist
Project-URL: Changelog, https://checksepa.com/changelog
Keywords: sepa,pain.001,iso20022,validator,iban,xml,credit-transfer
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
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: Topic :: Office/Business :: Financial
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.31
Dynamic: license-file

# sepa-check

Command-line client for the free, keyless SEPA pain.001 validator API.

```bash
pip install sepa-check
sepa-check pain001.xml
sepa-check pain001.xml --json
```

Until the package is on PyPI, install it from a checkout:

```bash
pip install ./cli
```

`FILE` is a SEPA XML document. The command posts it as multipart field `file` to `https://checksepa.com/v1/validate`. Python 3.9+. The only dependency is `requests`.

No API key. Free limit: 30 validations per IP per hour, 200 per UTC day, 2 MB maximum. HTTP 429 carries `Retry-After`. Higher limits and API keys: https://checksepa.com/api-waitlist

Human output lists each finding with its code, path, and line. `--json` prints `valid`, `format`, `version`, `errors`, and `warnings`.

| Exit | Meaning |
| --- | --- |
| 0 | `valid` was true |
| 1 | the file is invalid |
| 2 | usage error, unreadable file, or the API could not be reached |

Docs: https://checksepa.com/docs · OpenAPI: https://checksepa.com/openapi.json

MIT. Copyright (c) 2026 Bobook Limited.
