# Binlist

[![Build Status](](

Binlist is an Elixir client library for [the service](

## Installation

First, add Binlist to your `mix.exs` dependencies:

def deps do
  [ {:binlist, "~> 0.1.0"} ]

Then, update your dependencies:

$ mix deps.get

## Usage

Make a request, specifying the bin number as an integer or string:

{:ok, bin} = Binlist.find(45717360)

And if successful, `bin` is a `%Binlist.Bin{}` struct:

bin.scheme  # "visa"
bin.type    # "debit"
bin.prepaid # false

If an error occurs either of the following are returned:

# For a 404:
{:error, "Bin not found"}

# For a 429:
{:error, "Request limit reached"}

# For any other 4xx or 5xx status:
{:error, "Unknown error", status}

## Contributing

This is my first Elixir library so if you notice something wrong, please open an issue or better yet submit a pull request.

Make a change and then run tests `mix test` to verify your changes. Note that the tests are integration based. sometimes doesn't return a field for one bin but it does for another. Since the library uses structs, if you notice any fields missing please submit an issue along with the bin introducing the field.

## Misc

As this was my first Elixir library, I looked to other projects to see how they were configured so I knew how to distribute on Hex. I liked the code I read in [ex_twilio]( so I used the same approach to parsing a response.