Making your first request

  • Updated on Jun 12, 2025
  • 1 minute(s) read
  • Janeera D A
  • Pradeep Srinivasan
  • Manoharan Soundarraj
 Prev Next

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.

  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.

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. Open Postman 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.

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

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

Replace YOUR_API_TOKEN with your actual token generated from the portal.

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:

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.

What’s Next?

After making your first request, you can explore further: