---
title: "Making your first request"
slug: "making-your-first-request"
updated: 2025-07-27T18:50:57Z
published: 2025-11-23T16:40:38Z
canonical: "apidocs.document360.com/making-your-first-request"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.document360.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Making your first request

This article guides you through sending your first authenticated API request using one of the following methods:

---

## Option 1: Using Swagger

Swagger UI provides an interactive, browser-based interface to test all available endpoints in real time.

**Steps:**

1. Open Document360’s APIs in the [Swagger UI](https://apihub.document360.io/).
2. Click **Authorize**.
3. Paste your API token in the `api_token` field and click **Authorize**.
4. Navigate to any endpoint, enter the required values, and click **Execute**.
5. View the response directly within the browser.

For detailed steps, read the article on [**How to use Swagger**](https://apidocs.document360.com/apidocs/how-to-use-swagger).

---

## Option 2: Using Postman

Postman allows you to import the Document360 API collection and make requests from a graphical interface. This is recommended for testing and team collaboration.

**Steps:**

1. Log in to [Postman](https://www.postman.com/) and click **Import**.
2. Choose the **Link** option and paste the following URL: `https://apihub.document360.io/swagger/v2/swagger.json`
3. Click **Continue**, then **Import**.
4. Set the base URL and authorization token in the environment or headers.
5. Send a request to any available endpoint.

For detailed instructions, read the article on [**How to use Postman**](/v2-api/apidocs/getting-started-with-postman).

---

## Option 3: Using curl (command line)

If you prefer using the command line, you can make API requests with `curl`.

**Example: List all team accounts**

```bash
curl --request GET "https://apihub.document360.io/v2/teams" \
  --header "Authorization: Bearer YOUR_API_TOKEN"
```

> [!NOTE]
> NOTE
> 
> Depending on your Document360 server, you may have to use `https://apihub.us.document360.io/` or `https://apihub.eu.document360.io/`.

Replace `YOUR_API_TOKEN` with your actual token generated from the portal.

> [!NOTE]
> NOTE
> 
> Use double quotes (`"`) instead of single quotes (`'`) when running curl commands in **Windows OS** using **Command Prompt** or **PowerShell** in to avoid errors.

---

### Authentication

All API requests must include an **Authorization header** as shown below:

```makefile
Authorization: Bearer YOUR_API_TOKEN
```

You will use this token regardless of the tool:

- In **curl**, pass it as a request header.
- In **Postman**, enter it in the Authorization tab or as a header.
- In **Swagger**, use the **Authorize** button and paste it into the `api_token` field.

To generate an API token:

1. Go to the Document360 portal.
2. Navigate to **Settings** **()** > **Knowledge base portal** > **API tokens** .
3. Create or copy an existing token.

For detailed steps, see the article on [**Generating an API token**](/v2-api/apidocs/api-token).

---

### What’s Next?

After making your first request, you can explore further:

- [List all articles](/v2-api/apidocs/project-version-articles)
- [Create and publish an article](/v2-api/apidocs/how-to-create-and-publish-an-article)
- [View the full API Reference](/v2-api/apidocs/introduction-2)