> ## Documentation Index
> Fetch the complete documentation index at: https://meilisearch-6b28dec2-add-render-template-route.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Postman collection for Meilisearch

> Import Meilisearch's OpenAPI specification into Postman to test and debug the API with a ready-made collection.

Postman is a platform that lets you create, organize, and reuse HTTP requests. You can import the Meilisearch OpenAPI specification directly into Postman to get a complete, up-to-date collection of all API routes.

If you don't have Postman already, you can [download it here](https://www.postman.com/downloads/). It's free and available on many OS distributions.

## Prerequisites

Download the Meilisearch OpenAPI specification file from the [latest Meilisearch release on GitHub](https://github.com/meilisearch/meilisearch/releases/latest). Scroll down to the **Assets** section of the release and download `meilisearch-openapi.json`. Save it somewhere on your computer.

## Import the OpenAPI specification

Click the three-dot menu (**...**) at the top of the sidebar, then select **Import**.

<Frame>
  <img src="https://mintcdn.com/meilisearch-6b28dec2-add-render-template-route/_I18oBqFwdlOiFw5/assets/images/postman/import_menu.png?fit=max&auto=format&n=_I18oBqFwdlOiFw5&q=85&s=86e52fefcaf63eeea907a5e978a514f0" alt="The three-dot menu in the Postman sidebar with the 'Import' option highlighted" width="3024" height="1964" data-path="assets/images/postman/import_menu.png" />
</Frame>

In the import dialog, drag and drop the OpenAPI specification file or click **files** to select it from your computer.

<Frame>
  <img src="https://mintcdn.com/meilisearch-6b28dec2-add-render-template-route/_I18oBqFwdlOiFw5/assets/images/postman/import_dialog.png?fit=max&auto=format&n=_I18oBqFwdlOiFw5&q=85&s=5fb3c3d6b6ba1dda7afa2e5631d53d41" alt="The Postman import dialog with a drop zone for files" width="3024" height="1964" data-path="assets/images/postman/import_dialog.png" />
</Frame>

Postman detects the file format and asks how to import it. Select **Postman Collection** to create a collection with all Meilisearch API routes, then click **Import**.

<Frame>
  <img src="https://mintcdn.com/meilisearch-6b28dec2-add-render-template-route/_I18oBqFwdlOiFw5/assets/images/postman/import_postman_collection.png?fit=max&auto=format&n=_I18oBqFwdlOiFw5&q=85&s=9a44076d6ef0fcf4e75fe44d2baa3821" alt="The import specification dialog with 'Postman Collection' selected" width="3024" height="1964" data-path="assets/images/postman/import_postman_collection.png" />
</Frame>

<Note>
  You can also select **OpenAPI 3.1 Specification with a Postman Collection** if you want to keep the raw specification alongside the collection.

  <Frame>
    <img src="https://mintcdn.com/meilisearch-6b28dec2-add-render-template-route/_I18oBqFwdlOiFw5/assets/images/postman/import_openapi.png?fit=max&auto=format&n=_I18oBqFwdlOiFw5&q=85&s=39807cbc178303018e8b8162ce69d1ed" alt="The import specification dialog with 'OpenAPI 3.1 Specification with a Postman Collection' selected" width="3024" height="1964" data-path="assets/images/postman/import_openapi.png" />
  </Frame>
</Note>

## Configure authentication

After importing, you need to configure your API key so Postman can authenticate requests to your Meilisearch instance.

Individual requests use **Bearer Token** authentication. You can verify this by selecting any request and checking the **Authorization** tab. The token field references `{{bearerToken}}`, which Postman resolves from your global variables.

<Frame>
  <img src="https://mintcdn.com/meilisearch-6b28dec2-add-render-template-route/_I18oBqFwdlOiFw5/assets/images/postman/collection_overview.png?fit=max&auto=format&n=_I18oBqFwdlOiFw5&q=85&s=b0fed4ae1986ce2994afb4b3b87d7705" alt="The Postman collection showing all Meilisearch API routes with the Authorization tab open and Bearer Token configured" width="3024" height="1964" data-path="assets/images/postman/collection_overview.png" />
</Frame>

## Start using the collection

You can now select any route from the sidebar, adjust parameters as needed, and click **Send** to make requests to your Meilisearch instance.
