# support.supper.payment.queryPayments

> Published by [supper.support](https://lexicon.garden/identity/did:plc:mcsqdltevtjpu26xthzzmm2l)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:mcsqdltevtjpu26xthzzmm2l/support.supper.payment.queryPayments)
- [Documentation](https://lexicon.garden/lexicon/did:plc:mcsqdltevtjpu26xthzzmm2l/support.supper.payment.queryPayments/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:mcsqdltevtjpu26xthzzmm2l/support.supper.payment.queryPayments/examples)

## Definitions

### `support.supper.payment.queryPayments`

**Type**: `query`

Return a bounded public view of up to 50 attested payment record bodies for a specific payer and recipient pair, with optional broker and entitlement filters. This unauthenticated view is not personalized. Absence from this bounded broker lookup is not exhaustive historical evidence and must never be treated as settlement or non-settlement proof; use exact broker verification for payment truth.

#### Parameters

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `brokers` | `array` | No | Optional broker DID filters. |
| `entitlements` | `array` | No | Optional entitlement AT-URI filters. |
| `limit` | `integer` | No | Maximum number of results to return from the broker's bounded first window. |
| `payer` | `string` (at-identifier) | Yes | Required payer account identifier. |
| `paymentType` | `string` (nsid) | No | Optional full payment record NSID to filter by. |
| `recipient` | `string` (at-identifier) | Yes | Required recipient account identifier. |

#### Output

**Encoding**: `application/json`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `payments` | `array` | Yes |  |

### `support.supper.payment.queryPayments#paymentView`

**Type**: `object`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `record` | `union` | Yes | The attested payment record body returned by the selected broker's bounded network.attested.payment.lookup view. Always present; presence or absence in this view is not settlement proof. |
| `ref` | `ref` → `com.atproto.repo.strongRef` | No | Optional versioned reference to the payment record. Present only when the broker supplies a resolvable record URI/CID; the launch ATM lookup returns bare record bodies, so this is usually absent. |

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "Return a bounded public view of up to 50 attested payment record bodies for a specific payer and recipient pair, with optional broker and entitlement filters. This unauthenticated view is not personalized. Absence from this bounded broker lookup is not exhaustive historical evidence and must never be treated as settlement or non-settlement proof; use exact broker verification for payment truth.",
      "output": {
        "encoding": "application/json",
        "schema": {
          "properties": {
            "payments": {
              "items": {
                "ref": "#paymentView",
                "type": "ref"
              },
              "type": "array"
            }
          },
          "required": [
            "payments"
          ],
          "type": "object"
        }
      },
      "parameters": {
        "properties": {
          "brokers": {
            "description": "Optional broker DID filters.",
            "items": {
              "format": "did",
              "type": "string"
            },
            "maxLength": 10,
            "type": "array"
          },
          "entitlements": {
            "description": "Optional entitlement AT-URI filters.",
            "items": {
              "format": "at-uri",
              "type": "string"
            },
            "maxLength": 50,
            "type": "array"
          },
          "limit": {
            "default": 50,
            "description": "Maximum number of results to return from the broker's bounded first window.",
            "maximum": 50,
            "minimum": 1,
            "type": "integer"
          },
          "payer": {
            "description": "Required payer account identifier.",
            "format": "at-identifier",
            "type": "string"
          },
          "paymentType": {
            "description": "Optional full payment record NSID to filter by.",
            "format": "nsid",
            "knownValues": [
              "network.attested.payment.oneTime",
              "network.attested.payment.recurring",
              "network.attested.payment.scheduled"
            ],
            "type": "string"
          },
          "recipient": {
            "description": "Required recipient account identifier.",
            "format": "at-identifier",
            "type": "string"
          }
        },
        "required": [
          "payer",
          "recipient"
        ],
        "type": "params"
      },
      "type": "query"
    },
    "paymentView": {
      "properties": {
        "record": {
          "closed": false,
          "description": "The attested payment record body returned by the selected broker's bounded network.attested.payment.lookup view. Always present; presence or absence in this view is not settlement proof.",
          "refs": [
            "network.attested.payment.oneTime",
            "network.attested.payment.recurring",
            "network.attested.payment.scheduled"
          ],
          "type": "union"
        },
        "ref": {
          "description": "Optional versioned reference to the payment record. Present only when the broker supplies a resolvable record URI/CID; the launch ATM lookup returns bare record bodies, so this is usually absent.",
          "ref": "com.atproto.repo.strongRef",
          "type": "ref"
        }
      },
      "required": [
        "record"
      ],
      "type": "object"
    }
  },
  "id": "support.supper.payment.queryPayments",
  "lexicon": 1
}
```