# Viex

[![Build Status](https://semaphoreci.com/api/v1/marceldegraaf/viex/branches/master/shields_badge.svg)](https://semaphoreci.com/marceldegraaf/viex)
[![Coverage Status](https://coveralls.io/repos/github/marceldegraaf/viex/badge.svg?branch=master)](https://coveralls.io/github/marceldegraaf/viex?branch=master)
[![Hex.pm](https://img.shields.io/hexpm/v/viex.svg)](https://hex.pm/packages/viex)
[![Hex.pm](https://img.shields.io/hexpm/l/viex.svg)](https://hex.pm/packages/viex)

Elixir package to validate European VAT numbers with the
[VIES](http://ec.europa.eu/taxation_customs/vies/) service.

## Installation

Add `viex` to your list of dependencies in `mix.exs`:

```elixir
def deps do
  [{:viex, "~> 0.1.0"}]
end
```

## Usage

Use `Viex.lookup/1` to look up a European VAT number. Returns a `Viex.Response`
struct containing the company name, address, and a `valid` key that is either
`true` or `false`.

    iex(1)> Viex.lookup("NL854265259B01")
    %Viex.Response{address: "PRINS BERNHARDPLEIN 00200\n1097JB AMSTERDAM", company: "GITHUB B.V.",
      valid: true}

Use `Viex.valid?/1` to check the validity of a European VAT number. Returns a
boolean.

    iex(1)> Viex.valid?("NL854265259B01")
    true