> ## 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. # Get reseller event > Returns one sellable event, with its ticket rates and their stock when asked for. An event outside the API key is answered as not found. ## OpenAPI ````yaml get /resellers/v2/events/{id} 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/events/{id}: get: tags: - V2 summary: Get reseller event description: >- Returns one sellable event, with its ticket rates and their stock when asked for. An event outside the API key is answered as not found. parameters: - name: id in: path required: true schema: type: string example: abcdefghijk1234567890 description: Event id. - name: populate in: query required: false schema: type: string enum: - ticket-rates description: >- Pass `ticket-rates` to include the rates of the event with their prices and availability. responses: '200': description: The event content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/EventDetail' 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 '404': description: No sellable event with that id is visible to this API key content: application/json: schema: type: object properties: success: type: boolean example: false error: type: string example: EVENT_NOT_FOUND '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: EventDetail: allOf: - $ref: '#/components/schemas/Event' - type: object properties: slug: type: string example: saturdays-at-ginger-klub code: type: string example: GK-SAT-03 age: type: integer example: 18 music_genres: type: array items: type: string example: - techno - house location_id: type: string example: abcdefghijk1234567890 is_until_late: type: boolean example: true is_upselling_enabled: type: boolean example: false ticket_rates: type: array items: $ref: '#/components/schemas/TicketRate' description: Only present when the request asked for `populate=ticket-rates`. Event: type: object properties: _id: type: string example: abcdefghijk1234567890 name: type: string example: Saturdays at Ginger Klub description: type: string example: Resident DJs every Saturday night. display_date: type: string format: date-time example: '2026-10-03T22:00:00.000Z' description: Date the event is advertised under. start_date: type: string format: date-time example: '2026-10-03T22:00:00.000Z' end_date: type: string format: date-time example: '2026-10-04T05:30:00.000Z' currency: type: string example: EUR image_url: type: string example: https://cdn.fourvenues.com/ginger-klub/saturdays.jpg organization_id: type: string example: abcdefghijk1234567890 location: $ref: '#/components/schemas/Location' TicketRate: type: object properties: _id: type: string example: abcdefghijk1234567890 organization_id: type: string example: abcdefghijk1234567890 event_id: type: string example: abcdefghijk1234567890 name: type: string example: Entry + 1 drink slug: type: string example: entry-1-drink valid_from: type: string format: date-time example: '2026-09-01T08:00:00.000Z' complete: type: boolean example: false type: type: string enum: - public - limited example: public show_all_prices: type: boolean example: false min: type: integer example: 1 max: type: integer example: 10 nominative: type: boolean example: true available: type: boolean example: true description: Whether the rate can be sold right now. current_price: $ref: '#/components/schemas/Price' prices: type: array items: $ref: '#/components/schemas/Price' warranty: $ref: '#/components/schemas/Warranty' supplements: type: array items: $ref: '#/components/schemas/Supplement' questions: type: array items: $ref: '#/components/schemas/Question' has_discount_codes_enabled: type: boolean example: false availability: $ref: '#/components/schemas/TicketRateAvailability' Location: type: object nullable: true properties: name: type: string example: Ginger Klub address: type: string example: Carrer de Balmes 23 full_address: type: string example: Carrer de Balmes 23, 08007 Barcelona, Spain city: type: string example: Barcelona country: type: string example: ES timezone: type: string example: Europe/Madrid Price: 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 description: Amount in the currency of the event. valid_until: type: string format: date-time example: '2026-10-03T21:00:00.000Z' description: >- When this price stops being sellable, never later than the sale deadline of the event. fee_type: type: string nullable: true enum: - fijo - porcentaje - null example: porcentaje description: >- Whether `fee_quantity` is a flat amount (`fijo`) or a percentage (`porcentaje`). fee_quantity: type: number format: float example: 8 description: >- Booking fee, in the currency of the event when `fee_type` is `fijo`, as a percentage when it is `porcentaje`. includes: type: string example: Entry + 1 drink additional_info: type: string example: Drink must be claimed before 2am. quantity: type: integer example: 100 description: Units this price may sell in total. `0` means unlimited. Warranty: type: object description: >- Refund warranty sold with the rate. The key is absent when the rate has no warranty configured, and only `enabled: false` travels when it has one that is turned off, so check it before reading its fields. properties: enabled: type: boolean example: true is_fixed: type: boolean example: false fixed_price: type: number format: float example: 0 percentage: type: number format: float example: 10 hours: type: integer example: 48 Supplement: type: object properties: _id: type: string example: abcdefghijk1234567890 label: type: string example: Coat check price: type: number format: float example: 3 has_fake_price: type: boolean example: false fake_price: type: number format: float example: 0 description: type: string example: Skip the queue at the wardrobe. product_quantity: type: integer example: 1 service_charge_amount: type: number format: float example: 0 service_charge_type: type: string enum: - fixed - percentage - null example: fixed description: >- Whether `service_charge_amount` is a flat amount or a percentage of the supplement price. `null` when the supplement carries no service charge. nullable: true Question: type: object properties: _id: type: string example: abcdefghijk1234567890 label: type: string example: Date of birth type: type: string example: date items: type: array items: type: string example: [] required: type: boolean example: true TicketRateAvailability: type: object properties: maxQuantity: type: integer example: 300 description: Units all prices of the rate add up to. `0` means unlimited. totalUsage: type: integer example: 120 description: Same figure as `sold`, kept for symmetry with the price tiers. sold: type: integer example: 120 description: >- Units already sold for this rate across every sales channel of the organizer. A reseller key is not a sales channel, so this is the organizer total, not your own: it reads higher than the per-channel figure the Channel Manager API reports. available: type: integer nullable: true example: 180 description: >- Units still sellable. `null` means nothing caps the rate — treat it as stock available, never as sold out. The `available` boolean of the rate is what says whether it is still on sale. limit: type: integer example: 300 description: >- Tighter of the rate ceiling and the sum of its prices. `0` means unlimited. 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. ````