import Avatcado, {
  RateLimitError,
  UpstreamError,
  AuthenticationError,
  ValidationError,
  AvatcadoError,
} from "@avatcado/node";

const avatcado = new Avatcado("avat_live_your_api_key");
const { data, error } = await avatcado.vat.validate({ vatNumber: "NL123456789B01" });

if (error) {
  if (error instanceof RateLimitError) {
    console.log(`Retry after ${error.retryAfter} seconds`);
  } else if (error instanceof UpstreamError) {
    console.log(`Retry after ${error.retryAfter} seconds`);
  } else if (error instanceof AuthenticationError) {
    console.log(error.message);
  } else if (error instanceof ValidationError) {
    console.log(error.message);
    console.log(error.details); // Array<{ field, message }> | null
  } else {
    // AvatcadoError base class
    console.log(`${error.code}: ${error.message}`);
    console.log(error.docsUrl);
  }
}

from avatcado import Avatcado, RateLimitError, UpstreamError, AuthenticationError, ValidationError, AvatcadoError

avatcado = Avatcado("avat_live_your_api_key")

try:
    result = avatcado.vat.validate("NL123456789B01")
except RateLimitError as e:
    print(f"Retry after {e.retry_after} seconds")
except UpstreamError as e:
    print(f"Retry after {e.retry_after} seconds")
except AuthenticationError as e:
    print(e.message)
except ValidationError as e:
    print(e.message)
    print(e.details)  # list of dicts or None
except AvatcadoError as e:
    print(f"{e.code}: {e.message}")
    print(e.docs_url)