[![Build Status](](
[![Coverage Status](](
[![Latest Version](](

# ExFootball

Simple Elixir client for API v2

## Installation

If [available in Hex](, the package can be installed
by adding `ex_football` to your list of dependencies in `mix.exs`:

def deps do
    {:ex_football, "~> 0.2.0"}

Documentation can be generated with [ExDoc](
and published on [HexDocs]( Once published, the docs can
be found at [](

## Usage
Get all competitions
> ExFootball.fetch("api_token", "competitions")

Get upcoming matches for Premier League
> ExFootball.fetch("api_token", "competitions", "matches", [id: "PL", status: "SCHEDULED"])

Get all matches of the Champions League
> ExFootball.fetch("api_token", "competitions", "matches", [id: "CL"])

## Contribution
Clone repository
> git clone
> cd ex_football
> mix deps.get

Create `secret.exs` file in the /config directory, don't forget to add this file to gitignore:
use Mix.Config

config :ex_football, api_token: "football_data_api_token"

Run test
mix test