# currents api

`currents api` is a CLI command for fetching data from Currents [API](https://app.gitbook.com/o/-MT4mUcrnbXWgd1xvl_x/s/lcxad7NaXT7D2V6owvHN/ "mention") the data is returned in JSON format.

### Usage

{% hint style="info" %}
The command requires the `--project-id` and [`--api-key`](https://docs.currents.dev/resources/reporters/currents-cmd/broken-reference) from Currents to authenticate the request and provide the required data. Alternatively, you can set the `CURRENTS_PROJECT_ID` and `CURRENTS_API_KEY` environment variables.
{% endhint %}

Obtain run data using the [ci-build-id](https://docs.currents.dev/guides/parallelization-guide/ci-build-id "mention") by running the following command:

```bash
npx currents api get-run --ci-build-id <ci-build-id> --output path/to/save/run.json
```

Obtain the last completed run details, filtered by `--branch` and/or `--tag`

```bash
npx currents api get-run --branch <branch> --tag <tag-1,tag-2,...tag-n>
```