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

# Merchant invoices

> Read store invoices (orders) with a Bearer API key.

Invoices in Join Markt are the paid/checkout records already stored as orders. There is no separate invoice table. `invoiceId` equals the order’s public `orderId`; the path also accepts the internal row id.

```http theme={null}
GET /api/merchant/v1/stores/{storeId}/invoices
GET /api/merchant/v1/stores/{storeId}/invoices/{invoiceId}
```

Scope: `invoice:read` · ceiling `viewOrders`

Query matches [merchant orders](/api/merchant-orders): `limit`, `cursor`, `status`, `from`, `to`.

```json theme={null}
{
  "invoices": [
    {
      "id": "clxyz...",
      "invoiceId": "ORD-1001",
      "orderId": "ORD-1001",
      "status": "completed",
      "price": 9.99,
      "customerEmail": "buyer@example.com"
    }
  ],
  "limit": 50,
  "hasMore": false,
  "nextCursor": null
}
```

IP, user-agent, and payment-provider secrets are never returned.

## Related

* [Merchant orders](/api/merchant-orders)
* [API keys](/developers/api-keys)


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