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

# List payments

> Read merchant payment configurations.

Returns every non-deleted payment configured for the authenticated merchant, including `INACTIVE` rows. Use this to map Fire spark payment ids before calling [Get payment](https://firespark.cloud/docs/integrations-api/payments/\[id]/get) or [Upsert payments](https://firespark.cloud/docs/integrations-api/payments/put.md).

> [!NOTE]
>
> Requires an access token with the `payments:read` scope. See
> [Token](https://firespark.cloud/docs/integrations-api/oauth/token/post.md) to obtain a token.

## Request

```bash theme={null}
curl "https://firespark.cloud/api/integrations/v1/payments" \
  -H "Authorization: Bearer ACCESS_TOKEN"
```

## Response

The response wraps an array of payment objects in `data`. `private_key` and `webhook_signature` are omitted from `config`. The object shape matches [Get payment](https://firespark.cloud/docs/integrations-api/payments/\[id]/get).

## Error responses

| Status | Description |
| - | - |
| `401` | Missing or invalid access token |
| `403` | Token does not include `payments:read` |


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