> For the complete documentation index, see [llms.txt](https://docs.tailer.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tailer.ai/tailer-api/getting-started-1.md).

# Getting started

## :closed\_lock\_with\_key: Generate a JWT token from Google credentials

{% file src="/files/-MMPqHLj\_iOmdwtbCl8v" %}
Google JWT generator
{% endfile %}

To generate a Google JWT token:

1. Download and unzip the ZIP file above.\
   You get a Python file named "google-jwt-generator.py".
2. Generate a Google JSON credentials file (see [Generate JSON credentials](/getting-started/set-up-google-cloud-platform.md#generate-json-credentials)).
3. Run the following script using Python:

   ```
   python3 google-jwt-generator.py your-credentials.json
   ```
4. You can save the token in a shell variable:

   ```
   TAILER_API_JWT=`python3 google-jwt-generator.py your-credentials.json`
   ```

## :digit\_one: Send a first request to the Tailer API

To communicate with the Tailer API, you can use the cURL CLI.

Here is an example of request allowing you to check the status of a Tables to Tables data operation run:

```bash
TAILER_API_JWT=`python3 google-jwt-generator.py your-credentials.json` \
&& curl --request POST \
--http2 \
--header "content-type:application/json" \
--header "Authorization: Bearer ${TAILER_API_JWT}" \
--data '{"action": "check_run_status",
         "account": "000099",
         "environment": "DEV",
         "configuration_type": "table-to-table",
         "configuration_id": "000099_iowa_liquor_prepare_pda_DEV",
         "job_id": "gbq-to-gbq|000099_iowa_liquor_prepare_pda_DEV",
         "run_id": "20201230-112837-0a795c70-2557-4a60-ba16-788aa2bea179"}' \
"https://tailer-api-nqonovswsq-ew.a.run.app/v1/dag/status"
```

### Use your Tailer identity instead

You can use the identity provided when you installed your tailer-sdk:

```bash
tailer auth get-token | awk '/User token :/ {print $4}'
```

You can use this to get your JWT token:

```bash
TAILER_API_JWT=`tailer auth get-token | awk '/User token :/ {print $4}'` \
&& curl --request POST \
--http2 \
--header "content-type:application/json" \
--header "Authorization: Bearer ${TAILER_API_JWT}" \
--data '{"action": "check_run_status",
         "account": "000099",
         "environment": "DEV",
         "configuration_type": "table-to-table",
         "configuration_id": "000099_iowa_liquor_prepare_pda_DEV",
         "job_id": "gbq-to-gbq|000099_iowa_liquor_prepare_pda_DEV",
         "run_id": "20201230-112837-0a795c70-2557-4a60-ba16-788aa2bea179"}' \
"https://tailer-api-nqonovswsq-ew.a.run.app/v1/dag/status"
```