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

# Fetch Merchants

> Get all the merchants from your chargeblast account. Response is paginated. The `name` field is set during onboarding of the merchant and corresponds to the individual name of the merchant for multi-merchant accounts (usually associated with the DBA or billing descriptor).

Returns all merchants for your Chargeblast account. The response is **paginated** using the `page` and `per` query parameters.

Each merchant in the response includes a **name** and **id**. The `name` is set during onboarding and, for multi-merchant accounts, corresponds to the individual merchant name (typically the DBA or billing descriptor). The merchant **id** returned here is the same value as the `merchantId` in the [webhook alert payload](/api-reference/webhooks/setup#body)—use it to associate incoming alerts with the correct merchant.


## OpenAPI

````yaml get /api/v2/merchants
openapi: 3.0.1
info:
  title: Chargeblast API
  version: 0.1.0
servers:
  - url: https://api.chargeblast.com
security: []
tags:
  - name: Credit Requests
  - name: Sync Data
  - name: Alerts
  - name: Disputes
  - name: Enrollment
paths:
  /api/v2/merchants:
    get:
      tags:
        - Enrollment
      summary: Fetch Merchants
      description: >-
        Get all the merchants from your chargeblast account. Response is
        paginated. The `name` field is set during onboarding of the merchant and
        corresponds to the individual name of the merchant for multi-merchant
        accounts (usually associated with the DBA or billing descriptor).
      operationId: merchants
      parameters:
        - name: X-API-Key
          required: true
          in: header
          schema:
            type: string
          description: Your API key. Sent in the `X-API-Key` header.
        - name: page
          required: false
          in: query
          schema:
            format: int64
            nullable: true
            type: integer
          description: The starting page of the request. Default value of 1.
        - in: query
          required: false
          schema:
            format: int64
            nullable: true
            type: integer
          description: How many merchants to return per page. Default value of 10.
          name: per
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EmbedMerchantResponseDTO'
              example:
                page: 1
                total: 1
                merchants:
                  - name: sandbox-merchant-1
                    id: cb_xxxxxxxxxxxxx
          description: OK
components:
  schemas:
    EmbedMerchantResponseDTO:
      required:
        - merchants
        - page
        - total
      type: object
      properties:
        page:
          type: integer
          format: int64
          description: The current page number.
        total:
          type: integer
          format: int64
          description: The total number of merchants.
        merchants:
          type: array
          items:
            $ref: '#/components/schemas/MerchantListItem'
          description: The list of merchants for the current page.
    MerchantListItem:
      type: object
      required:
        - id
        - name
      properties:
        id:
          type: string
          description: >-
            The unique Chargeblast identifier for the merchant (e.g.
            cb_xxxxxxxxxxxxx).
        name:
          type: string
          description: >-
            Set during onboarding of the merchant. For multi-merchant accounts,
            this is the individual merchant name, usually associated with the
            DBA or billing descriptor.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.