# Making requests

This page explains how to make requests to Linked API, including available endpoints, authorization process, response structure, and common errors.

## Endpoints

`https://api.linkedapi.io/workflows` – for [executing workflows](/docs/executing-workflows).

`https://api.linkedapi.io/conversations/poll` – for [polling conversations](/docs/working-with-conversations).

`https://api.linkedapi.io/stats/actions` – for checking [API usage statistics](/docs/checking-api-usage-statistics).

`https://api.linkedapi.io/admin/*` – for [managing your account](/docs/admin-overview).

## Authorization

Requests to all endpoints must include **2 authorization headers**:

- `linked-api-token` – your main token that enables overall Linked API access.
- `identification-token` – unique token specific to each managed LinkedIn account.

You can obtain these tokens through [our platform](https://app.linkedapi.io/), as demonstrated below:

![](/images/docs/tokens.webp)

## Response structure

All responses in Linked API have the following structure:

1. **For successful requests:**

```json
{
  "success": true,
  "result": { /* Endpoint specific result */ }
}
```

2. **For requests with errors:**

```json
{
  "success": false,
  "error": { /* Common or endpoint specific error */ }
}
```

## Common errors

Below is a list of common errors relevant to all endpoints. Additionally, some endpoints have their own specific errors, so check the related documentation pages.

### linkedApiTokenRequired

```json
{
  "success": false,
  "error": {
    "type": "linkedApiTokenRequired",
    "message": "'linked-api-token' is missing in request headers."
  }
}
```

### invalidLinkedApiToken

```json
{
  "success": false,
  "error": {
    "type": "invalidLinkedApiToken",
    "message": "The provided 'linked-api-token' is invalid."
  }
}
```

### identificationTokenRequired

```json
{
  "success": false,
  "error": {
    "type": "identificationTokenRequired",
    "message": "'identification-token' is missing in request headers."
  }
}
```

### invalidIdentificationToken

```json
{
  "success": false,
  "error": {
    "type": "invalidIdentificationToken",
    "message": "The provided 'identification-token' is invalid."
  }
}
```

### subscriptionRequired

```json
{
  "success": false,
  "error": {
    "type": "subscriptionRequired",
    "message": "No purchased subscription seats available for this LinkedIn account."
  }
}
```

> 💡 Add additional seats, renew the subscription for existing seats, or check for any payment issues on the [platform](https://app.linkedapi.io/).

### tooManyRequests

```json
{
  "success": false,
  "error": {
    "type": "tooManyRequests",
    "message": "Too many requests. Please try again later."
  }
}
```