Localization

BillOver API supports multiple languages through the Accept-Language header.

Supported Languages

Usage

Add the Accept-Language header to your API requests to receive responses in your preferred language.

Accept-Language: tr

Example Request

curl -X GET \
  https://api.billover.com/v1/invoices/ \
  -H 'Api-Key: YOUR_API_KEY' \
  -H 'Accept-Language: de'

Default Language

If no Accept-Language header is provided or if the requested language is not supported, the API will default to English (en).

Response Examples

English (Default)

{
    "error": "Invoice not found",
    "code": "NOT_FOUND"
}

German

{
    "error": "Rechnung nicht gefunden",
    "code": "NOT_FOUND"
}

Turkish

{
    "error": "Fatura bulunamadı",
    "code": "NOT_FOUND"
}

Best Practices

1. Always specify the Accept-Language header if you need localized responses
2. Handle the default English responses as a fallback
3. Cache the error messages in your application for better performance
4. Use the error codes rather than the messages for programmatic error handling