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

# List tickets of a buyer

> Lists the activated tickets a buyer holds for one organization, limited to events the reseller could list. Both `email` and `organization_id` are required: the endpoint answers for one buyer at a time, never a census. Ordered by purchase date, newest first.



## OpenAPI

````yaml get /resellers/v2/tickets
openapi: 3.0.0
info:
  title: Reseller API
  version: 1.0.0
  description: >-
    Reseller API. Version 1 validates and swaps a ticket from its barcode.
    Version 2 exposes the catalogue a reseller needs to sell: the organizations
    its key covers, their sellable events with ticket rates and stock, and the
    tickets of a given buyer.
servers:
  - url: https://api-alpha.fourvenues.com
    description: Alpha
  - url: https://api.fourvenues.com
    description: Production
security: []
paths:
  /resellers/v2/tickets:
    get:
      tags:
        - V2
      summary: List tickets of a buyer
      description: >-
        Lists the activated tickets a buyer holds for one organization, limited
        to events the reseller could list. Both `email` and `organization_id`
        are required: the endpoint answers for one buyer at a time, never a
        census. Ordered by purchase date, newest first.
      parameters:
        - name: email
          in: query
          required: true
          schema:
            type: string
            format: email
          example: john.appleseed@fourvenues.com
          description: >-
            Email of the buyer whose tickets are listed. Matched whole, ignoring
            case and surrounding spaces; no partial search.
        - name: organization_id
          in: query
          required: true
          schema:
            type: string
          example: abcdefghijk1234567890
          description: Organization the tickets belong to. Must be covered by the API key.
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 50
          description: Page size.
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
            default: 0
          description: Number of items skipped before the page.
      responses:
        '200':
          description: Page of tickets
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Ticket'
                  has_more:
                    type: boolean
                    example: true
                    description: Whether another page exists after this one.
                  success:
                    type: boolean
                    example: true
        '400':
          description: The query parameters did not validate
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: string
                    example: VALIDATION_ERROR
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  valid:
                    type: boolean
                    example: false
                  swappable:
                    type: boolean
                    example: false
                  error:
                    type: string
                    example: UNAUTHORIZED
        '403':
          description: The API key does not cover the requested organization
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: string
                    example: ORGANIZATION_NOT_ALLOWED
        '500':
          description: Unexpected error
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: string
                    example: INTERNAL_ERROR
      security:
        - ApiKeyAuth: []
components:
  schemas:
    Ticket:
      type: object
      properties:
        _id:
          type: string
          example: abcdefghijk1234567890
        organization_id:
          type: string
          example: abcdefghijk1234567890
        event_id:
          type: string
          example: abcdefghijk1234567890
        code:
          type: string
          example: ABCD1234
        status:
          type: string
          enum:
            - activated
            - cancelled
            - filling_client
          example: activated
        enter:
          type: integer
          enum:
            - 0
            - 1
          example: 0
          description: >-
            Whether the holder already checked in: `1` once the ticket was
            scanned at the door, `0` before that.
        refunded:
          type: boolean
          example: false
        name:
          type: string
          example: Joan Llavor de Poma
        email:
          type: string
          format: email
          example: john.appleseed@fourvenues.com
        phone:
          type: string
          example: '+34600000000'
        price:
          type: number
          format: float
          example: 15
        total_paid:
          type: number
          format: float
          example: 16.2
        total_fees:
          type: number
          format: float
          example: 1.2
        payment_id:
          type: string
          nullable: true
          example: abcdefghijk1234567890
        ticket_rate:
          $ref: '#/components/schemas/TicketRateReference'
        price_ticket_rate:
          $ref: '#/components/schemas/TicketPriceTier'
        created_at:
          type: string
          format: date-time
          example: '2026-09-12T17:41:02.000Z'
        updated_at:
          type: string
          format: date-time
          example: '2026-09-12T17:41:05.000Z'
    TicketRateReference:
      type: object
      properties:
        _id:
          type: string
          example: abcdefghijk1234567890
        name:
          type: string
          nullable: true
          example: Entry + 1 drink
    TicketPriceTier:
      type: object
      nullable: true
      properties:
        _id:
          type: string
          example: abcdefghijk1234567890
        name:
          type: string
          nullable: true
          example: Early bird
        price:
          type: number
          format: float
          example: 15
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        Reseller API key, sent raw in the `Authorization` header:
        `Authorization: rs_live_xxxxxxxxxxxxxxxx`. Keys prefixed `rs_test_`
        operate against the test environment. The same key serves v2 and the
        swap operations, and it only reaches the organizations Fourvenues
        authorized on it.

````