# support.supper.commerce.listListings

> 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.commerce.listListings)
- [Documentation](https://lexicon.garden/lexicon/did:plc:mcsqdltevtjpu26xthzzmm2l/support.supper.commerce.listListings/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:mcsqdltevtjpu26xthzzmm2l/support.supper.commerce.listListings/examples)

## Definitions

### `support.supper.commerce.listListings#commissionView`

**Type**: `object`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `accessAudience` | `string` | No |  |
| `archived` | `boolean` | Yes |  |
| `cid` | `string` (cid) | Yes | CID of the exact commission record generation returned in this view. |
| `createdAt` | `string` (datetime) | No |  |
| `creator` | `string` (did) | Yes | Author repo DID; commissions are creator-owned. |
| `indexedAt` | `string` (datetime) | Yes | When the AppView indexed this record. |
| `kind` | `string` | No |  |
| `product` | `ref` → `com.atproto.repo.strongRef` | Yes | Canonical money.atmosphere.product strongRef. Resolve title, description, image, currency, and prices through this record. |
| `publishAt` | `string` (datetime) | No |  |
| `slotLimit` | `integer` | No | Public per-commission open-request cap hint. NOT scarce-inventory truth; the AppView never enforces availability. |
| `uri` | `string` (at-uri) | Yes | AT URI of the indexed support.supper.commission record. |

### `support.supper.commerce.listListings`

**Type**: `query`

List a creator's public Supper commerce records across repos: support.supper.membership.program programs, support.supper.membership.tier sidecars, and support.supper.commission offers. Only records authored by the named creator's own repo (creatorVerified) are returned. Public read; membership outputs carry their portable ATM program or tier identity and Supper presentation fields, while catalog product and price data resolve through those ATM records. Outputs never carry processor ids, member lists, or private inventory counts.

#### Parameters

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `creator` | `string` (did) | Yes | DID of the creator whose public commerce records to list. |
| `cursor` | `string` | No | Opaque cursor from a previous response. |
| `includeArchived` | `boolean` | No | When true, include archived listings. Defaults to false. |
| `kind` | `string` | No | Optional filter restricting results to a single listing kind. |
| `limit` | `integer` | No |  |

#### Output

**Encoding**: `application/json`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `cursor` | `string` | No |  |
| `listings` | `array` | Yes |  |

### `support.supper.commerce.listListings#membershipView`

**Type**: `object`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `archived` | `boolean` | Yes |  |
| `cid` | `string` (cid) | Yes | CID of the exact membership record generation returned in this view. |
| `createdAt` | `string` (datetime) | No |  |
| `creator` | `string` (did) | Yes |  |
| `indexedAt` | `string` (datetime) | Yes | When the AppView indexed this record. |
| `mode` | `string` | No |  |
| `program` | `ref` → `com.atproto.repo.strongRef` | Yes | App-neutral money.atmosphere.membership.program strongRef from the creator's repo. |
| `uri` | `string` (at-uri) | Yes | AT URI of the indexed support.supper.membership.program record. |

### `support.supper.commerce.listListings#tierView`

**Type**: `object`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `archived` | `boolean` | Yes |  |
| `badgeLabel` | `string` | No | Public badge label only. Badge ownership is verified from active recurring payment state, not by this display field. |
| `cid` | `string` (cid) | Yes | CID of the exact membership-tier record generation returned in this view. |
| `createdAt` | `string` (datetime) | No |  |
| `creator` | `string` (did) | Yes |  |
| `indexedAt` | `string` (datetime) | Yes | When the AppView indexed this record. |
| `membership` | `ref` → `com.atproto.repo.strongRef` | Yes | The parent support.supper.membership.program record. |
| `membershipTier` | `ref` → `com.atproto.repo.strongRef` | Yes | App-neutral money.atmosphere.membership.tier strongRef from the creator's repo. |
| `uri` | `string` (at-uri) | Yes | AT URI of the indexed support.supper.membership.tier record. |

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "commissionView": {
      "properties": {
        "accessAudience": {
          "knownValues": [
            "everyone",
            "monthly-supporters"
          ],
          "maxLength": 32,
          "type": "string"
        },
        "archived": {
          "type": "boolean"
        },
        "cid": {
          "description": "CID of the exact commission record generation returned in this view.",
          "format": "cid",
          "type": "string"
        },
        "createdAt": {
          "format": "datetime",
          "type": "string"
        },
        "creator": {
          "description": "Author repo DID; commissions are creator-owned.",
          "format": "did",
          "type": "string"
        },
        "indexedAt": {
          "description": "When the AppView indexed this record.",
          "format": "datetime",
          "type": "string"
        },
        "kind": {
          "knownValues": [
            "digital",
            "physical",
            "service"
          ],
          "maxLength": 32,
          "type": "string"
        },
        "product": {
          "description": "Canonical money.atmosphere.product strongRef. Resolve title, description, image, currency, and prices through this record.",
          "ref": "com.atproto.repo.strongRef",
          "type": "ref"
        },
        "publishAt": {
          "format": "datetime",
          "type": "string"
        },
        "slotLimit": {
          "description": "Public per-commission open-request cap hint. NOT scarce-inventory truth; the AppView never enforces availability.",
          "minimum": 0,
          "type": "integer"
        },
        "uri": {
          "description": "AT URI of the indexed support.supper.commission record.",
          "format": "at-uri",
          "type": "string"
        }
      },
      "required": [
        "uri",
        "cid",
        "creator",
        "product",
        "archived",
        "indexedAt"
      ],
      "type": "object"
    },
    "main": {
      "description": "List a creator's public Supper commerce records across repos: support.supper.membership.program programs, support.supper.membership.tier sidecars, and support.supper.commission offers. Only records authored by the named creator's own repo (creatorVerified) are returned. Public read; membership outputs carry their portable ATM program or tier identity and Supper presentation fields, while catalog product and price data resolve through those ATM records. Outputs never carry processor ids, member lists, or private inventory counts.",
      "output": {
        "encoding": "application/json",
        "schema": {
          "properties": {
            "cursor": {
              "maxLength": 4096,
              "type": "string"
            },
            "listings": {
              "items": {
                "closed": false,
                "refs": [
                  "#membershipView",
                  "#tierView",
                  "#commissionView"
                ],
                "type": "union"
              },
              "type": "array"
            }
          },
          "required": [
            "listings"
          ],
          "type": "object"
        }
      },
      "parameters": {
        "properties": {
          "creator": {
            "description": "DID of the creator whose public commerce records to list.",
            "format": "did",
            "type": "string"
          },
          "cursor": {
            "description": "Opaque cursor from a previous response.",
            "maxLength": 4096,
            "type": "string"
          },
          "includeArchived": {
            "default": false,
            "description": "When true, include archived listings. Defaults to false.",
            "type": "boolean"
          },
          "kind": {
            "description": "Optional filter restricting results to a single listing kind.",
            "knownValues": [
              "membership",
              "tier",
              "commission"
            ],
            "maxLength": 32,
            "type": "string"
          },
          "limit": {
            "default": 50,
            "maximum": 100,
            "minimum": 1,
            "type": "integer"
          }
        },
        "required": [
          "creator"
        ],
        "type": "params"
      },
      "type": "query"
    },
    "membershipView": {
      "properties": {
        "archived": {
          "type": "boolean"
        },
        "cid": {
          "description": "CID of the exact membership record generation returned in this view.",
          "format": "cid",
          "type": "string"
        },
        "createdAt": {
          "format": "datetime",
          "type": "string"
        },
        "creator": {
          "format": "did",
          "type": "string"
        },
        "indexedAt": {
          "description": "When the AppView indexed this record.",
          "format": "datetime",
          "type": "string"
        },
        "mode": {
          "knownValues": [
            "monthly-tips",
            "tiers",
            "off"
          ],
          "maxLength": 32,
          "type": "string"
        },
        "program": {
          "description": "App-neutral money.atmosphere.membership.program strongRef from the creator's repo.",
          "ref": "com.atproto.repo.strongRef",
          "type": "ref"
        },
        "uri": {
          "description": "AT URI of the indexed support.supper.membership.program record.",
          "format": "at-uri",
          "type": "string"
        }
      },
      "required": [
        "uri",
        "cid",
        "creator",
        "program",
        "archived",
        "indexedAt"
      ],
      "type": "object"
    },
    "tierView": {
      "properties": {
        "archived": {
          "type": "boolean"
        },
        "badgeLabel": {
          "description": "Public badge label only. Badge ownership is verified from active recurring payment state, not by this display field.",
          "maxGraphemes": 80,
          "maxLength": 800,
          "type": "string"
        },
        "cid": {
          "description": "CID of the exact membership-tier record generation returned in this view.",
          "format": "cid",
          "type": "string"
        },
        "createdAt": {
          "format": "datetime",
          "type": "string"
        },
        "creator": {
          "format": "did",
          "type": "string"
        },
        "indexedAt": {
          "description": "When the AppView indexed this record.",
          "format": "datetime",
          "type": "string"
        },
        "membership": {
          "description": "The parent support.supper.membership.program record.",
          "ref": "com.atproto.repo.strongRef",
          "type": "ref"
        },
        "membershipTier": {
          "description": "App-neutral money.atmosphere.membership.tier strongRef from the creator's repo.",
          "ref": "com.atproto.repo.strongRef",
          "type": "ref"
        },
        "uri": {
          "description": "AT URI of the indexed support.supper.membership.tier record.",
          "format": "at-uri",
          "type": "string"
        }
      },
      "required": [
        "uri",
        "cid",
        "creator",
        "membership",
        "membershipTier",
        "archived",
        "indexedAt"
      ],
      "type": "object"
    }
  },
  "id": "support.supper.commerce.listListings",
  "lexicon": 1
}
```