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

# List delivery methods

> The global list a listing's `delivery_method` is picked from. A
category may narrow it — the schema's `requirements.delivery_types[]`
says which keys it accepts.




## OpenAPI

````yaml /openapi.yaml get /v1/offers/delivery-methods
openapi: 3.1.0
info:
  title: MoonUP Seller API
  version: 1.0.0
  summary: List and manage your offers from your own tools.
  description: |
    Everything a seller's bot needs to keep a catalogue of listings up to date:
    read what a category expects, create a listing, restock it, pause it,
    archive it.

    This is the public surface. The cabinet's own screens — payouts, disputes,
    account settings — are not part of it and an API key does not reach them.

    ## Authentication

    Create a key in the cabinet under **Seller → API keys**. It is shown once.
    Send it on every request:

    ```
    Authorization: Bearer moonup_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
    ```

    There is nothing to exchange it for — no short-lived token sits in between.
    HTTPS only. Keep the key in an environment variable or your CI's secret
    store, never in a repository.

    A key may be pinned to a list of addresses when you create it (up to 16
    addresses or subnets). An empty list means any address.

    ## Creating a listing

    Categories do not ask for the same things. An accounts listing needs a
    picture and a price; a currency listing needs a product and a stock; a
    gift-card listing may only be delivered instantly, with an activation code.

    Rather than describing that in prose that would go stale, every category
    answers for itself:

        GET /v1/offers/games/{game}/categories/{category_slug}/schema

    `attributes[]` is the category's own field list, and `requirements` is what
    the body of `POST /v1/offers` must carry for it. Both come from the code
    that validates the create call, so what you are told is what you are held
    to.

    A full pass looks like this:

    1. `GET /v1/offers/games` — pick a game, keep its `slug`.
    2. `GET /v1/offers/games/{game}/categories` — pick a category.
    3. `GET /v1/offers/games/{game}/categories/{category_slug}/schema` — read
       `requirements` and `attributes`.
    4. `POST /v1/offers/images/upload-url`, then PUT the bytes to the URL it
       returns. Repeat per picture, collect the public URLs.
    5. `POST /v1/offers` — the listing is created as a `draft`.
    6. `POST /v1/offers/{id}/submit` — it goes to moderation, then active.

    ## Rate limits

    | | Budget |
    |---|---|
    | Reads | 500 requests per minute |
    | Writes | 250 requests per minute |
    | Writes to one offer | 5 per minute and 10 per hour |

    Going over answers `429`. It is temporary: wait and retry, the key stays
    valid. Up to 5 keys per account — create the second one ahead of time so
    you can rotate without downtime.

    ## Errors

    Every failure answers with the same body, a stable snake_case code:

    ```json
    { "error": "seller_instructions_required" }
    ```

    Branch on `error`, not on the message — there is no message.
servers:
  - url: https://api.moonup.gg
    description: Production
security:
  - api_key: []
tags:
  - name: Catalog
    description: |
      What can be listed, and what each category asks for. Public: these read
      without a key, so you can explore before you have one.
  - name: Offers
    description: Your own listings — create, edit, restock, pause, archive.
paths:
  /v1/offers/delivery-methods:
    get:
      tags:
        - Catalog
      summary: List delivery methods
      description: |
        The global list a listing's `delivery_method` is picked from. A
        category may narrow it — the schema's `requirements.delivery_types[]`
        says which keys it accepts.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  delivery_methods:
                    type: array
                    items:
                      $ref: '#/components/schemas/DeliveryMethod'
      security: []
components:
  schemas:
    DeliveryMethod:
      type: object
      properties:
        key:
          type: string
          examples:
            - activation_code
        label:
          type: string
        description:
          type: string
        version:
          type: integer
        buyer_fields:
          type: array
          description: >-
            What the buyer is asked for at checkout. You collect nothing
            yourself.
          items:
            $ref: '#/components/schemas/SchemaField'
    SchemaField:
      type: object
      description: One field of a category's attribute schema.
      properties:
        key:
          type: string
        label:
          type: string
        type:
          type: string
          enum:
            - string
            - number
            - boolean
            - enum
            - reference
            - password
        required:
          type: boolean
        filterable:
          type: boolean
        multiple:
          type: boolean
          description: The value is then an array of what `type` describes.
        enum_values:
          type: array
          items:
            type: string
          description: Allowed values, for `enum`.
        catalog_key:
          type: string
          description: |
            For `reference` — which catalog to read the allowed ids from, at
            `GET /v1/offers/games/{game_id}/catalog/{attribute_key}`. Equal to
            `key` when absent.
        min:
          type: number
        max:
          type: number
      required:
        - key
        - label
        - type
        - required
        - filterable
  securitySchemes:
    api_key:
      type: http
      scheme: bearer
      description: Your API key, from the cabinet under **Seller → API keys**.

````