# API Policy

This page describes the policies governing changes to the BankID Antifraud API.

## Schema evolution

The event schema may change over time. Here's how we handle changes:

### Non-breaking changes

Additional fields may be added to the schema _without prior notice_ and your integration should _gracefully handle unknown_ fields.

### Breaking changes

For breaking changes such as removal of _required_ fields:

1. A new event type will be created (`*.v1` -> `*.v2`)
2. Recipients will be notified
3. The previous event type will be maintained long enough for recipients to migrate to the new event type

### Reporting issues

If you encounter incorrect messages, please contact us for troubleshooting.
Include event `id` and the time of delivery.