# Make your first Request

\
Get your token

1. Before you can use any of the APIs, you need to log in to your Laigo account or, if you don’t have one, [create a new one.](https://app.laigo.io/register/HxB4EQdYUxJYEAcKUQFUAgNSTlFUVgcVVVYIAhgHBVAESAFUUVMAVVNXAFIEUhsfQHFGBFgKE1xjEUJcVxdHYwAED11AbBg=)
2. For creating the token, please visit our [platform](https://app.laigo.io/) and go to Administration- API Keys page to create and copy your client credentials.

<figure><img src="https://1698119796-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnvGf9sv8CkPYJeH3XSuP%2Fuploads%2FnZDVJZ8gRLJD3ny7CMNJ%2Fimage.png?alt=media&#x26;token=02997d2c-9aeb-4984-9d98-75d417597ae2" alt=""><figcaption></figcaption></figure>

3. Once you logged in, then you can start to create your client secret and client id by selecting the API page on the left sidebar of the dashboard.

<figure><img src="https://1698119796-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnvGf9sv8CkPYJeH3XSuP%2Fuploads%2FfV5rjnogtc4ge1IV4OoT%2Fimage.png?alt=media&#x26;token=bc16e764-4629-4edc-b880-17b60b74e87a" alt=""><figcaption></figcaption></figure>

3. For generating your client\_id and client\_secret you must fill the 'API Client Friendly Name' then click on the button ‘Generate’. The credentials that you can use for creating a token are now available.

<figure><img src="https://1698119796-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnvGf9sv8CkPYJeH3XSuP%2Fuploads%2FfV5rjnogtc4ge1IV4OoT%2Fimage.png?alt=media&#x26;token=bc16e764-4629-4edc-b880-17b60b74e87a" alt=""><figcaption></figcaption></figure>

5. Create an access token. To request access tokens, an application must make a POST request with the following multipart form data to the token URI: **grant\_type=client\_credentials**.

The application must pass basic HTTP auth credentials using the **client\_id** as the user and **client\_secret** as the password access tokens are obtained by calling the **<https://account.laigo.io/realms/SmartTools/protocol/openid-connect/token>** endpoint, and the required secrets are available in the API tab for your need.

**Create an access token**

***

<mark style="color:green;">`POST`</mark> `https://account.laigo.io/realms/SmartTools/protocol/openid-connect/token`

#### Query Parameters

| Name                                             | Type   | Description                                                 |
| ------------------------------------------------ | ------ | ----------------------------------------------------------- |
| client\_id<mark style="color:red;">\*</mark>     | String | The ClientId that has been generated for this function.     |
| client\_secret<mark style="color:red;">\*</mark> | String | The ClientSecret that has been generated for this function. |
| grant\_type<mark style="color:red;">\*</mark>    | String | Here you put your client credentials                        |

{% tabs %}
{% tab title="200: OK OK" %}

{% endtab %}

{% tab title="400: Bad Request Bad Request" %}

{% endtab %}

{% tab title="401: Unauthorized Unauthorized" %}

{% endtab %}

{% tab title="404: Not Found Not Found" %}

{% endtab %}
{% endtabs %}

***

**Get your sample code**

{% tabs %}
{% tab title="cURL" %}

```
curl -X POST "https://account.laigo.io/realms/SmartTools/protocol/openid-connect/token" \
     -d "client_id=<clientId>" \
     -d "client_secret=<clientSecret>" \
     -d "grant_type=client_credentials"
```

{% endtab %}

{% tab title="C#" %}

```csharp
string tokenUrl = "https://account.laigo.io/realms/SmartTools/protocol/openid-connect/token";
using (HttpClient client = new HttpClient())
{
    var formData = new List<KeyValuePair<string, string>>
            {
                new KeyValuePair<string, string>("client_id", "<client_id>"),
                new KeyValuePair<string, string>("client_secret", "<client_secret>"),
                new KeyValuePair<string, string>("grant_type", "client_credentials")
            };

    var response = await client.PostAsync(tokenUrl, new FormUrlEncodedContent(formData));
    string responseContent = await response.Content.ReadAsStringAsync();

    Console.WriteLine(responseContent);
}
```

{% endtab %}

{% tab title="Python" %}

```python
import requests

token_url = 'https://account.laigo.io/realms/SmartTools/protocol/openid-connect/token'
data = {'client_id': '<clientId>', 'client_secret': '<clientSecret>', 'grant_type': 'client_credentials'}

result = requests.post(token_url, data = data)
print(result.text)
```

{% endtab %}
{% endtabs %}

### Expected response

```
{
   "access_token":"USVb1nGO9kwQlhNRRnI4iWVy2UV5j7M6h7",
   "expires_in":300,
   "refresh_expires_in":0,
   "token_type":"Bearer",
   "not-before-policy":0,
   "scope":"smarttools:accounting smarttools:consumption"
}
```

## Uploading a new document

Once your access tokens are obtained by following the steps shown above the required secrets are available in the API tab for your task.\
**In our example we will show how to use the API call to the smartICR tool.** \
First you have to make a POST request to the following route, since you are uploading a new document.

## Upload file to smartICR

<mark style="color:green;">`POST`</mark> `https://use.laigo.io/api/FileUpload/v1/Upload/smartICR`

#### Query Parameters

| Name                                            | Type   | Description                                                                                                                                                                 |
| ----------------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| email<mark style="color:red;">\*</mark>         | String | If you want to sent the result to your email, you can define the destination email with this parameter                                                                      |
| outputFormats<mark style="color:red;">\*</mark> | String | As output format you can choose PDF and/ TEXT (e.g. outputFormats=PDF,TEXT)                                                                                                 |
| languageHint                                    | String | If you prefer the detection in a special language, you can force to use a language. Default Language is English. For choosing a Language, use the ISO-Langauge Code – 639-1 |

#### Headers

| Name                                          | Type   | Description                                                      |
| --------------------------------------------- | ------ | ---------------------------------------------------------------- |
| accessToken<mark style="color:red;">\*</mark> | String | A JWT issued to your application by the Laigo identity provider. |

#### Request Body

| Name                                   | Type   | Description            |
| -------------------------------------- | ------ | ---------------------- |
| file<mark style="color:red;">\*</mark> | String | The file for uploading |

{% tabs %}
{% tab title="201: Created Response result will be the job id" %}

{% endtab %}
{% endtabs %}