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

# List a listing's tickets

> > **Requires scope** `store:read` · **Minimum role** viewer

[Scopes and roles](https://docs.dueflow.co/api-reference/scopes)



## OpenAPI

````yaml /openapi.json get /v1/store/listings/{listingId}/tickets
openapi: 3.1.0
info:
  title: Dueflow API
  version: 1.0.0
  description: >-
    Read and write your organization's Dueflow data. Authenticate with a
    personal access token or an organization service token as a bearer
    credential; cookies are ignored. Every endpoint is also a tool on the
    Dueflow MCP server at https://api.dueflow.co/mcp, which accepts the same
    bearer tokens or an OAuth connection from ChatGPT and Claude.


    Timestamps in responses are RFC 3339, UTC, millisecond precision
    (`2026-01-31T17:04:05.123Z`). Timestamps you send are RFC 3339: send UTC
    (`Z`); some filters, such as `updatedSince`, also accept an offset.


    Responses may gain fields at any time; ignore the ones you don't know. Every
    failure answers with the `Error` envelope; branch on its `code`.
  termsOfService: https://dueflow.co/terms
  contact:
    name: Dueflow support
    email: hello@dueflow.co
    url: https://docs.dueflow.co
servers:
  - url: https://api.dueflow.co
    description: Production
security:
  - bearerAuth: []
paths:
  /v1/store/listings/{listingId}/tickets:
    get:
      tags:
        - Store
      summary: List a listing's tickets
      description: |-
        > **Requires scope** `store:read` · **Minimum role** viewer

        [Scopes and roles](https://docs.dueflow.co/api-reference/scopes)
      operationId: getStoreListingsByListingIdTickets
      parameters:
        - name: limit
          in: query
          required: false
          schema:
            default: 50
            type: integer
            minimum: 1
            maximum: 100
        - name: cursor
          in: query
          required: false
          schema:
            type: string
        - name: updatedSince
          in: query
          required: false
          schema:
            type: string
            format: date-time
        - name: listingId
          in: path
          required: true
          schema:
            type: string
        - name: status
          in: query
          required: false
          schema:
            type: string
            enum:
              - valid
              - void
        - name: checkedIn
          in: query
          required: false
          schema:
            type: string
            enum:
              - 'true'
              - 'false'
      responses:
        '200':
          description: Success
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimit-Limit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimit-Remaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimit-Reset'
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        listingId:
                          type: string
                        orderId:
                          type: string
                        memberId:
                          type:
                            - string
                            - 'null'
                          description: >-
                            The member the ticket was bought as; null for a
                            guest
                        itemName:
                          type: string
                        seq:
                          description: This ticket's number within its order line, from 1
                          type: integer
                          minimum: -9007199254740991
                          maximum: 9007199254740991
                        quantity:
                          description: 'Tickets on the order line: the N in "1 of N"'
                          type: integer
                          minimum: -9007199254740991
                          maximum: 9007199254740991
                        status:
                          type: string
                          enum:
                            - valid
                            - void
                        checkedInAt:
                          type:
                            - string
                            - 'null'
                          format: date-time
                          description: >-
                            Timestamp: RFC 3339, UTC, millisecond precision
                            (`2026-01-31T17:04:05.123Z`).
                        voidedAt:
                          type:
                            - string
                            - 'null'
                          format: date-time
                          description: >-
                            Timestamp: RFC 3339, UTC, millisecond precision
                            (`2026-01-31T17:04:05.123Z`).
                        voidReason:
                          type:
                            - string
                            - 'null'
                          enum:
                            - refund
                            - manual
                            - null
                        codeLast4:
                          description: Last four characters of the ticket's code
                          type: string
                        createdAt:
                          type: string
                          format: date-time
                          description: >-
                            Timestamp: RFC 3339, UTC, millisecond precision
                            (`2026-01-31T17:04:05.123Z`).
                        updatedAt:
                          type: string
                          format: date-time
                          description: >-
                            Timestamp: RFC 3339, UTC, millisecond precision
                            (`2026-01-31T17:04:05.123Z`).
                      required:
                        - id
                        - listingId
                        - orderId
                        - memberId
                        - itemName
                        - seq
                        - quantity
                        - status
                        - checkedInAt
                        - voidedAt
                        - voidReason
                        - codeLast4
                        - createdAt
                        - updatedAt
                  hasMore:
                    type: boolean
                  nextCursor:
                    type:
                      - string
                      - 'null'
                required:
                  - data
                  - hasMore
                  - nextCursor
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
        default:
          $ref: '#/components/responses/UnexpectedError'
      security:
        - bearerAuth:
            - store:read
components:
  headers:
    X-Request-Id:
      description: >-
        Identifies the request; quote it to support. Also in the error body as
        `requestId`.
      schema:
        type: string
    RateLimit-Limit:
      description: Requests the token's budget for this kind of request allows per window.
      schema:
        type: integer
    RateLimit-Remaining:
      description: Requests left in the current window.
      schema:
        type: integer
    RateLimit-Reset:
      description: Seconds until the window resets.
      schema:
        type: integer
    Retry-After:
      description: Seconds to wait before retrying.
      schema:
        type: integer
  responses:
    BadRequest:
      description: >-
        Invalid input: a parameter or body field fails validation (`param` names
        it), the body isn't JSON, or a business rule refused the request.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/X-Request-Id'
        RateLimit-Limit:
          $ref: '#/components/headers/RateLimit-Limit'
        RateLimit-Remaining:
          $ref: '#/components/headers/RateLimit-Remaining'
        RateLimit-Reset:
          $ref: '#/components/headers/RateLimit-Reset'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: Missing, malformed, expired or revoked token.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/X-Request-Id'
        RateLimit-Limit:
          $ref: '#/components/headers/RateLimit-Limit'
        RateLimit-Remaining:
          $ref: '#/components/headers/RateLimit-Remaining'
        RateLimit-Reset:
          $ref: '#/components/headers/RateLimit-Reset'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: The token lacks a required scope.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/X-Request-Id'
        RateLimit-Limit:
          $ref: '#/components/headers/RateLimit-Limit'
        RateLimit-Remaining:
          $ref: '#/components/headers/RateLimit-Remaining'
        RateLimit-Reset:
          $ref: '#/components/headers/RateLimit-Reset'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: No such resource, or the token's organization can't see it.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/X-Request-Id'
        RateLimit-Limit:
          $ref: '#/components/headers/RateLimit-Limit'
        RateLimit-Remaining:
          $ref: '#/components/headers/RateLimit-Remaining'
        RateLimit-Reset:
          $ref: '#/components/headers/RateLimit-Reset'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    RateLimited:
      description: Rate limited; see the `Retry-After` header.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/X-Request-Id'
        RateLimit-Limit:
          $ref: '#/components/headers/RateLimit-Limit'
        RateLimit-Remaining:
          $ref: '#/components/headers/RateLimit-Remaining'
        RateLimit-Reset:
          $ref: '#/components/headers/RateLimit-Reset'
        Retry-After:
          $ref: '#/components/headers/Retry-After'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    UnexpectedError:
      description: >-
        Any other failure, such as `internal_error` (500), as the `Error`
        envelope. A failure in front of the API (a gateway timeout, a request
        too large) may instead be plain text.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/X-Request-Id'
        RateLimit-Limit:
          $ref: '#/components/headers/RateLimit-Limit'
        RateLimit-Remaining:
          $ref: '#/components/headers/RateLimit-Remaining'
        RateLimit-Reset:
          $ref: '#/components/headers/RateLimit-Reset'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
        text/plain:
          schema:
            type: string
  schemas:
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              description: >-
                A stable, machine-readable reason. One of `invalid_request`
                (400), `invalid_token` (401), `insufficient_scope` (403),
                `step_up_required` (403), `ai_consent_required` (403),
                `not_found` (404), `method_not_allowed` (405), `conflict` (409),
                `sync_expired` (410), `rate_limited` (429), `internal_error`
                (500), `provider_error` (502). New codes may be added; treat an
                unknown one by its HTTP status.
              type: string
            message:
              type: string
            param:
              type: string
            requiredScopes:
              type: array
              items:
                type: string
            requestId:
              type: string
            docsUrl:
              type: string
          required:
            - code
            - message
            - requestId
            - docsUrl
      required:
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        A Dueflow access token: `dfp_` (personal) or `dfs_` (service).
        Permissions are the token's scopes intersected with the role ceiling,
        re-evaluated per request.

````

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