> ## 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. # Refund Ticket > Void ticket and mark the amount of money refunded. It can be partial or total and it can be done multiple times until the ticket is fully refunded. However, the first time it is done, the ticket is marked as voided. ## OpenAPI ````yaml put /tickets/{id}/refund 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}/refund: put: tags: - Tickets summary: Refund Ticket description: >- Void ticket and mark the amount of money refunded. It can be partial or total and it can be done multiple times until the ticket is fully refunded. However, the first time it is done, the ticket is marked as voided. operationId: refundTicket parameters: - name: id in: path description: Ticket id required: true schema: type: string requestBody: content: application/json: schema: type: object properties: amount: type: number description: Amount to refund. example: 10 required: - amount responses: '200': description: OK content: application/json: schema: type: object properties: data: $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 ````