> ## 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 ticket by id > Get tickets given certains query parameters ## OpenAPI ````yaml get /tickets/{id} openapi: 3.0.0 info: title: Channel Manager API version: 0.1.0 description: >- Official API documentation for Channel Manager. All endpoints are protected by an API key. servers: - url: https://channels-service-alpha.fourvenues.com description: Test server - url: https://channels-service.fourvenues.com description: Production server security: [] tags: [] paths: /tickets/{id}: get: tags: - Tickets summary: Get ticket by id description: Get tickets given certains query parameters operationId: getTicketById parameters: - name: id in: path description: Ticket id required: true schema: type: string - name: populate in: query description: |- Populate ticket with the options given separated by comma. Populate options: - `*`: All populators - `payments`: Payments required: false schema: type: string responses: '200': description: OK content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/Ticket' success: type: boolean '400': description: Bad Request '401': description: Unauthorized '404': description: Not Found security: - ApiKey: [] components: schemas: Ticket: type: object properties: _id: type: string description: The unique identifier for a ticket example: 5f8d0f8b9d2b3b0017b6d8a0 event_id: type: string description: Event id of a ticket example: 5f8d0f8b9d2b3b0017b6d8a0 ticket_rate_id: type: string description: Ticket rate id of a ticket example: 5f8d0f8b9d2b3b0017b6d8a0 qr_code: type: string description: QRCode of a ticket example: ABCDE12345 status: type: string enum: - processing - active - voided - filled_client - pending_payment description: Status of a ticket example: active price: $ref: '#/components/schemas/PriceTicketRate' payment_currency: type: string description: Currency of the payment example: EUR channel_id: type: string description: Channel id of a ticket example: 5f8d0f8b9d2b3b0017b6d8a0 fees: type: object properties: organization: type: number description: Fee charged to the client by the organization example: 1.1 discocil: type: number description: Fee charged by Fourvenues to the organization example: 0.7 full_name: type: string description: Full name of a ticket example: John Doe phone: type: string description: Phone number of a ticket example: '1234567890' email: type: string description: Email of a ticket example: john.appleseed@fourvenues.com gender: type: string description: Gender of the client. enum: - 0 = women - 1 = men example: 0 birthday: type: string description: Birthday of a ticket example: '1990-01-01' address: type: string description: Address of a ticket example: 123 Main St, New York, NY 10001 postal_code: type: string description: Postal code of a ticket example: '10001' country_code: type: string description: Country code of a ticket example: ES personal_document_type: type: string enum: - dni - nie - passport - other description: Personal document type of a ticket example: dni personal_document_number: type: string description: Personal document number of a ticket example: '1234567890' answers: type: array items: type: object properties: question_id: type: string description: Question id of a ticket example: '1234567890' answer: type: string description: Answer of a ticket example: Answer supplements: type: array description: Supplements attached to this ticket after purchase. items: $ref: '#/components/schemas/TicketSupplement' refunded: type: number description: Total refunded amount of a ticket example: 10 refunded_at: type: string description: Refunded date of a ticket example: '2020-10-19T07:00:00.000Z' refunds: type: array description: Refunds of a ticket items: type: object properties: channel_id: type: string description: Channel id of a ticket example: 5f8d0f8b9d2b3b0017b6d8a0 amount: type: number description: Refund amount of a ticket example: 10 at: type: string description: Refund date of a ticket example: '2020-10-19T07:00:00.000Z' for: type: number description: Clients that can access with this ticket example: 1 enter: type: number description: Clients that have entered with this ticket example: 1 entry_time: type: string description: Entry time of the clients with this ticket example: '2022-07-19T07:00:00.000Z' total_supplements: type: number description: >- Sum of supplement line totals (unit price × purchase quantity) for this ticket. example: 2 supplements_service_charge_total: type: number description: Total service charge applied to supplements on this ticket. example: 0.6 total_fees: type: number description: Total price of the fees example: 1.1 total_price: type: number description: >- Total price of the ticket + all extras (supplements, fees, warranty price, etc.) example: 16.1 warranty: type: object properties: total: type: number example: 1 description: Total amount that costs the warranty. hours: type: number example: 12 description: Hours before the event the warranty can be used. cost: type: number example: 0.2 description: GGDD warranty cost for this ticket. discount_amount: type: number description: Amount discounted by a discount code example: 5 PriceTicketRate: type: object description: >- A ticket rate can have one or multiple prices but only one can be active at a time. properties: _id: type: string example: '1643064796675' description: Unique identifier for the price. name: type: string example: Early Bird description: Name of the price. price: type: number example: 12 description: Price of the ticket. valid_until: type: string example: '2022-01-01T00:00:00.000Z' description: Date until the price will be available. quantity: type: number example: 0 description: >- Max number of tickets that can be purchased with this price. NOTE: 0 means unlimited. fee_type: type: string example: percentage enum: - percentage - fixed description: Type of the fee. fee_quantity: type: number example: 10 description: Quantity of the fee. includes: type: string example: 1 Drink description: Content the price includes. additional_info: type: string example: Only valid before 2:00 am. description: Additional info. used: type: number example: '55' description: Number of tickets sold of this price required: - id - price - valid_until - quantity - includes - additional_info TicketSupplement: type: object description: Supplement line on a purchased ticket. properties: _id: type: string description: Supplement identifier (same as supplement_id). example: '1643064796675' supplement_id: type: string description: Supplement identifier. example: '1643064796675' label: type: string example: 1 Copa price: type: number description: Unit price of the supplement on this ticket. example: 12 has_fake_price: type: boolean example: true fake_price: type: number example: 15 description: Original price before discount when has_fake_price is true. description: type: string example: Includes one drink at the bar total_price: type: number description: 'Line total: price × supplement_units.' example: 24 supplement_units: type: number description: Supplement packs purchased (purchase_quantity). example: 2 product_quantity: type: number description: >- Redeemable items per purchased pack, as configured on the ticket rate (e.g. 4 drinks per pack). example: 4 redemption_deadline_value: type: number description: >- Unix timestamp copied from the rate when redemption deadline was enabled at purchase time. example: 1798851600 securitySchemes: ApiKey: in: header name: X-Api-Key type: apiKey ````