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

# Fetch Instances

> Returns the instance with the name informed in the parameter, or all the instances if empty.



## OpenAPI

````yaml openapi-v2 GET /instance/fetchInstances
openapi: 3.0.3
info:
  title: Evolution API
  version: 2.1.1
servers:
  - url: https://{server-url}
    variables:
      server-url:
        default: evolution-example
        description: The URL of your EvolutionAPI server
    description: Your instance domain
security: []
paths:
  /instance/fetchInstances:
    get:
      tags:
        - Instance Controller
      summary: Fetch Instances
      description: >-
        Returns the instance with the name informed in the parameter, or all the
        instances if empty.
      operationId: fetchInstances
      parameters:
        - name: instanceName
          description: Name of the instance to be fetched
          in: query
          schema:
            type: string
        - name: instanceId
          description: ID of the instance to be fetched
          in: query
          schema:
            type: string
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                    description: The HTTP status of the response
                  error:
                    type: string
                    description: The error message indicating the type of error
                  response:
                    type: object
                    properties:
                      message:
                        type: array
                        items:
                          type: string
                        description: List of detailed error messages
                example:
                  - instance:
                      instanceName: example-name
                      instanceId: 421a4121-a3d9-40cc-a8db-c3a1df353126
                      owner: 553198296801@s.whatsapp.net
                      profileName: Guilherme Gomes
                      profilePictureUrl: null
                      profileStatus: This is the profile status.
                      status: open
                      serverUrl: https://example.evolution-api.com
                      apikey: B3844804-481D-47A4-B69C-F14B4206EB56
                      integration:
                        integration: WHATSAPP-BAILEYS
                        webhook_wa_business: >-
                          https://example.evolution-api.com/webhook/whatsapp/db5e11d3-ded5-4d91-b3fb-48272688f206
                  - instance:
                      instanceName: teste-docs
                      instanceId: af6c5b7c-ee27-4f94-9ea8-192393746ddd
                      status: close
                      serverUrl: https://example.evolution-api.com
                      apikey: '123456'
                      integration:
                        token: '123456'
                        webhook_wa_business: >-
                          https://example.evolution-api.com/webhook/whatsapp/teste-docs
                required:
                  - message
      deprecated: false
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: apikey
      description: Your authorization key header

````