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

# List Merchants

> List all merchants for the authenticated user

Get a list of all merchants associated with the authenticated user.

<ResponseField name="success" type="boolean">
  Indicates if the request was successful
</ResponseField>

<ResponseField name="data.merchants" type="array">
  Array of merchant objects
</ResponseField>

<ResponseField name="data.merchants[].id" type="string">
  Merchant UUID
</ResponseField>

<ResponseField name="data.merchants[].name" type="string">
  Merchant name
</ResponseField>

<ResponseField name="data.merchants[].domain" type="string">
  Merchant domain
</ResponseField>

<ResponseField name="data.merchants[].isVerified" type="boolean">
  Whether the domain is verified
</ResponseField>

<ResponseField name="data.merchants[].createdAt" type="string">
  Creation timestamp
</ResponseField>

## Example Request

```bash theme={null}
curl -X GET https://api.transaction.gg/merchant/list \
  -H "Authorization: Bearer jwt_token"
```

## Example Response

```json theme={null}
{
  "success": true,
  "data": {
    "merchants": [
      {
        "id": "merchant_uuid",
        "name": "My Store",
        "domain": "mystore.com",
        "isVerified": false,
        "createdAt": "2024-01-01T00:00:00Z"
      }
    ]
  }
}
```

## Error Responses

<ResponseExample name="Unauthorized">
  ```json theme={null}
  {
    "success": false,
    "error": {
      "status": 401,
      "code": "UNAUTHORISED",
      "message": "Invalid or missing authentication"
    },
    "data": null
  }
  ```
</ResponseExample>