Orders¶

Order resource¶

The order resource contains the following public fields:

Order position resource¶

Order payment resource¶

Order refund resource¶

List of all orders¶

GET /api/v1/organizers/(organizer)/events/(event)/orders/¶

Returns a list of all orders within a given event.

Example request:

GET /api/v1/organizers/bigevents/events/sampleconf/orders/ HTTP/1.1
Host: pretix.eu
Accept: application/json, text/javascript

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json
X-Page-Generated: 2017-12-01T10:00:00Z

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "code": "ABC12",
      "status": "p",
      "testmode": false,
      "secret": "k24fiuwvu8kxz3y1",
      "url": "https://test.pretix.eu/dummy/dummy/order/ABC12/k24fiuwvu8kxz3y1/",
      "email": "tester@example.org",
      "phone": "+491234567",
      "customer": null,
      "locale": "en",
      "sales_channel": "web",
      "datetime": "2017-12-01T10:00:00Z",
      "expires": "2017-12-10T10:00:00Z",
      "last_modified": "2017-12-01T10:00:00Z",
      "payment_date": "2017-12-05",
      "payment_provider": "banktransfer",
      "fees": [],
      "total": "23.00",
      "comment": "",
      "custom_followup_at": null,
      "checkin_attention": false,
      "require_approval": false,
      "invoice_address": {
          "last_modified": "2017-12-01T10:00:00Z",
          "is_business": true,
          "company": "Sample company",
          "name": "John Doe",
          "name_parts": {"full_name": "John Doe"},
          "street": "Test street 12",
          "zipcode": "12345",
          "city": "Testington",
          "country": "DE",
          "state": "",
          "internal_reference": "",
          "vat_id": "EU123456789",
          "vat_id_validated": false
      },
      "positions": [
        {
          "id": 23442,
          "order": "ABC12",
          "positionid": 1,
          "canceled": false,
          "item": 1345,
          "variation": null,
          "price": "23.00",
          "attendee_name": "Peter",
          "attendee_name_parts": {
            "full_name": "Peter",
          },
          "attendee_email": null,
          "company": "Sample company",
          "street": "Test street 12",
          "zipcode": "12345",
          "city": "Testington",
          "country": "DE",
          "state": null,
          "voucher": null,
          "tax_rate": "0.00",
          "tax_value": "0.00",
          "tax_rule": null,
          "secret": "z3fsn8jyufm5kpk768q69gkbyr5f4h6w",
          "addon_to": null,
          "subevent": null,
          "discount": null,
          "pseudonymization_id": "MQLJvANO3B",
          "seat": null,
          "checkins": [
            {
              "list": 44,
              "type": "entry",
              "gate": null,
              "device": 2,
              "datetime": "2017-12-25T12:45:23Z",
              "auto_checked_in": false
            }
          ],
          "answers": [
            {
              "question": 12,
              "question_identifier": "WY3TP9SL",
              "answer": "Foo",
              "option_idenfiters": [],
              "options": []
            }
          ],
          "downloads": [
            {
              "output": "pdf",
              "url": "https://pretix.eu/api/v1/organizers/bigevents/events/sampleconf/orderpositions/23442/download/pdf/"
            }
          ]
        }
      ],
      "downloads": [
        {
          "output": "pdf",
          "url": "https://pretix.eu/api/v1/organizers/bigevents/events/sampleconf/orders/ABC12/download/pdf/"
        }
      ],
      "payments": [
        {
          "local_id": 1,
          "state": "confirmed",
          "amount": "23.00",
          "created": "2017-12-01T10:00:00Z",
          "payment_date": "2017-12-04T12:13:12Z",
          "payment_url": null,
          "details": {},
          "provider": "banktransfer"
        }
      ],
      "refunds": []
    }
  ]
}

Query Parameters

• page (integer) – The page number in case of a multi-page result set, default is 1

• ordering (string) – Manually set the ordering of results. Valid fields to be used are datetime, code, last_modified, and status. Default: datetime

• code (string) – Only return orders that match the given order code

• status (string) – Only return orders in the given order status (see above)

• search (string) – Only return orders matching a given search query (matching for names, email addresses, and company names)

• item (integer) – Only return orders with a position that contains this item ID. Warning: Result will also include orders if they contain mixed items, and it will even return orders where the item is only contained in a canceled position.

• variation (integer) – Only return orders with a position that contains this variation ID. Warning: Result will also include orders if they contain mixed items and variations, and it will even return orders where the variation is only contained in a canceled position.

• testmode (boolean) – Only return orders with testmode set to true or false

• require_approval (boolean) – If set to true or false, only categories with this value for the field require_approval will be returned.

• include_canceled_positions – If set to true, the output will contain canceled order positions. Note that this only affects position-level cancellations, not fully-canceled orders.

• include_canceled_fees – If set to true, the output will contain canceled order fees.

• email (string) – Only return orders created with the given email address

• locale (string) – Only return orders with the given customer locale

• modified_since (datetime) – Only return orders that have changed since the given date. Be careful: We only recommend using this in combination with testmode=false, since test mode orders can vanish at any time and you will not notice it using this method.

• created_since (datetime) – Only return orders that have been created since the given date.

• subevent (integer) – Only return orders with a position that contains this subevent ID. Warning: Result will also include orders if they contain mixed subevents, and it will even return orders where the subevent is only contained in a canceled position.

• subevent_after (datetime) – Only return orders that contain a ticket for a subevent taking place after the given date. This is an exclusive after, and it considers the end of the subevent (or its start, if the end is not set).

• subevent_before (datetime) – Only return orders that contain a ticket for a subevent taking place after the given date. This is an exclusive before, and it considers the start of the subevent.

• exclude (string) – Exclude a field from the output, e.g. fees or positions.downloads. Can be used as a performance optimization. Can be passed multiple times.

• include (string) – Include only the given field in the output, e.g. fees or positions.downloads. Can be used as a performance optimization. Can be passed multiple times. include is applied before exclude, so exclude takes precedence.

Parameters

• organizer – The slug field of the organizer to fetch

• event – The slug field of the event to fetch

Response Headers

• X-Page-Generated – The server time at the beginning of the operation. If you’re using this API to fetch differences, this is the value you want to use as modified_since in your next call.

Status Codes

• 200 OK – no error

• 401 Unauthorized – Authentication failure

• 403 Forbidden – The requested organizer/event does not exist or you have no permission to view this resource.

Fetching individual orders¶

GET /api/v1/organizers/(organizer)/events/(event)/orders/(code)/¶

Returns information on one order, identified by its order code.

Example request:

GET /api/v1/organizers/bigevents/events/sampleconf/orders/ABC12/ HTTP/1.1
Host: pretix.eu
Accept: application/json, text/javascript

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
  "code": "ABC12",
  "status": "p",
  "testmode": false,
  "secret": "k24fiuwvu8kxz3y1",
  "url": "https://test.pretix.eu/dummy/dummy/order/ABC12/k24fiuwvu8kxz3y1/",
  "email": "tester@example.org",
  "phone": "+491234567",
  "customer": null,
  "locale": "en",
  "sales_channel": "web",
  "datetime": "2017-12-01T10:00:00Z",
  "expires": "2017-12-10T10:00:00Z",
  "last_modified": "2017-12-01T10:00:00Z",
  "payment_date": "2017-12-05",
  "payment_provider": "banktransfer",
  "fees": [],
  "total": "23.00",
  "comment": "",
  "custom_followup_at": null,
  "checkin_attention": false,
  "require_approval": false,
  "invoice_address": {
      "last_modified": "2017-12-01T10:00:00Z",
      "company": "Sample company",
      "is_business": true,
      "name": "John Doe",
      "name_parts": {"full_name": "John Doe"},
      "street": "Test street 12",
      "zipcode": "12345",
      "city": "Testington",
      "country": "DE",
      "state": "",
      "internal_reference": "",
      "vat_id": "EU123456789",
      "vat_id_validated": false
  },
  "positions": [
    {
      "id": 23442,
      "order": "ABC12",
      "positionid": 1,
      "canceled": false,
      "item": 1345,
      "variation": null,
      "price": "23.00",
      "attendee_name": "Peter",
      "attendee_name_parts": {
        "full_name": "Peter",
      },
      "attendee_email": null,
      "company": "Sample company",
      "street": "Test street 12",
      "zipcode": "12345",
      "city": "Testington",
      "country": "DE",
      "state": null,
      "voucher": null,
      "tax_rate": "0.00",
      "tax_rule": null,
      "tax_value": "0.00",
      "secret": "z3fsn8jyufm5kpk768q69gkbyr5f4h6w",
      "addon_to": null,
      "subevent": null,
      "discount": null,
      "pseudonymization_id": "MQLJvANO3B",
      "seat": null,
      "checkins": [
        {
          "list": 44,
          "type": "entry",
          "gate": null,
          "device": 2,
          "datetime": "2017-12-25T12:45:23Z",
          "auto_checked_in": false
        }
      ],
      "answers": [
        {
          "question": 12,
          "question_identifier": "WY3TP9SL",
          "answer": "Foo",
          "option_idenfiters": [],
          "options": []
        }
      ],
      "downloads": [
        {
          "output": "pdf",
          "url": "https://pretix.eu/api/v1/organizers/bigevents/events/sampleconf/orderpositions/23442/download/pdf/"
        }
      ]
    }
  ],
  "downloads": [
    {
      "output": "pdf",
      "url": "https://pretix.eu/api/v1/organizers/bigevents/events/sampleconf/orders/ABC12/download/pdf/"
    }
  ],
  "payments": [
    {
      "local_id": 1,
      "state": "confirmed",
      "amount": "23.00",
      "created": "2017-12-01T10:00:00Z",
      "payment_date": "2017-12-04T12:13:12Z",
      "payment_url": null,
      "details": {},
      "provider": "banktransfer"
    }
  ],
  "refunds": []
}

Parameters

• organizer – The slug field of the organizer to fetch

• event – The slug field of the event to fetch

• code – The code field of the order to fetch

Query Parameters

• include_canceled_positions – If set to true, the output will contain canceled order positions. Note that this only affects position-level cancellations, not fully-canceled orders.

• include_canceled_fees – If set to true, the output will contain canceled order fees.

Status Codes

• 200 OK – no error

• 401 Unauthorized – Authentication failure

• 403 Forbidden – The requested organizer/event does not exist or you have no permission to view this resource.

• 404 Not Found – The requested order does not exist.

Order ticket download¶

GET /api/v1/organizers/(organizer)/events/(event)/orders/(code)/download/(output)/¶

Download tickets for an order, identified by its order code. Depending on the chosen output, the response might be a ZIP file, PDF file or something else. The order details response contains a list of output options for this particular order.

Tickets can only be downloaded if ticket downloads are active and – depending on event settings – the order is either paid or pending. Note that in some cases the ticket file might not yet have been created. In that case, you will receive a status code 409 Conflict and you are expected to retry the request after a short period of waiting.

Example request:

GET /api/v1/organizers/bigevents/events/sampleconf/orders/ABC12/download/pdf/ HTTP/1.1
Host: pretix.eu
Accept: application/json, text/javascript

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/pdf

...

Parameters

• organizer – The slug field of the organizer to fetch

• event – The slug field of the event to fetch

• code – The code field of the order to fetch

• output – The internal name of the output provider to use

Status Codes

• 200 OK – no error

• 401 Unauthorized – Authentication failure

• 403 Forbidden – The requested organizer/event does not exist or you have no permission to view this resource or downloads are not available for this order at this time. The response content will contain more details.

• 404 Not Found – The requested order or output provider does not exist.

• 409 Conflict – The file is not yet ready and will now be prepared. Retry the request after waiting for a few seconds.

Updating order fields¶

PATCH /api/v1/organizers/(organizer)/events/(event)/orders/(code)/¶

Updates specific fields on an order. Currently, only the following fields are supported:

• email

• phone

• checkin_attention

• locale

• comment

• custom_followup_at

• invoice_address (you always need to supply the full object, or null to delete the current address)

Example request:

PATCH /api/v1/organizers/bigevents/events/sampleconf/orders/ABC12/ HTTP/1.1
Host: pretix.eu
Accept: application/json, text/javascript
Content-Type: application/json

{
  "email": "other@example.org",
  "locale": "de",
  "comment": "Foo",
  "checkin_attention": true
}

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

(Full order resource, see above.)

Parameters

• organizer – The slug field of the organizer of the event

• event – The slug field of the event

• code – The code field of the order to update

Status Codes

• 200 OK – no error

• 400 Bad Request – The order could not be updated due to invalid submitted data.

• 401 Unauthorized – Authentication failure

• 403 Forbidden – The requested organizer/event does not exist or you have no permission to update this order.

Generating new secrets¶

POST /api/v1/organizers/(organizer)/events/(event)/orders/(code)/regenerate_secrets/¶

Triggers generation of new secret attributes for both the order and all order positions.

Example request:

POST /api/v1/organizers/bigevents/events/sampleconf/orders/ABC12/regenerate_secrets/ HTTP/1.1
Host: pretix.eu
Accept: application/json, text/javascript

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

(Full order resource, see above.)

Parameters

• organizer – The slug field of the organizer of the event

• event – The slug field of the event

• code – The code field of the order to update

Status Codes

• 200 OK – no error

• 400 Bad Request – The order could not be updated due to invalid submitted data.

• 401 Unauthorized – Authentication failure

• 403 Forbidden – The requested organizer/event does not exist or you have no permission to update this order.

POST /api/v1/organizers/(organizer)/events/(event)/orderpositions/(id)/regenerate_secrets/¶

Triggers generation of a new secret attribute for a single order position.

Example request:

POST /api/v1/organizers/bigevents/events/sampleconf/orderpositions/23/regenerate_secrets/ HTTP/1.1
Host: pretix.eu
Accept: application/json, text/javascript

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

(Full order position resource, see above.)

Parameters

• organizer – The slug field of the organizer of the event

• event – The slug field of the event

• code – The id field of the order position to update

Status Codes

• 200 OK – no error

• 400 Bad Request – The order position could not be updated due to invalid submitted data.

• 401 Unauthorized – Authentication failure

• 403 Forbidden – The requested organizer/event does not exist or you have no permission to update this order position.

Deleting orders¶

DELETE /api/v1/organizers/(organizer)/events/(event)/orders/(code)/¶

Deletes an order. Works only if the order has testmode set to true.

Example request:

DELETE /api/v1/organizers/bigevents/events/sampleconf/orders/ABC12/ HTTP/1.1
Host: pretix.eu
Accept: application/json, text/javascript

Example response:

HTTP/1.1 204 No Content
Vary: Accept
Content-Type: application/json

Parameters

• organizer – The slug field of the organizer to fetch

• event – The slug field of the event to fetch

• code – The code field of the order to delete

Status Codes

• 204 No Content – no error

• 401 Unauthorized – Authentication failure

• 403 Forbidden – The requested organizer/event does not exist or you have no permission to delete this resource or the order may not be deleted.

• 404 Not Found – The requested order does not exist.

Creating orders¶

POST /api/v1/organizers/(organizer)/events/(event)/orders/¶

Creates a new order.

Warning

This endpoint is intended for advanced users. It is not designed to be used to build your own shop frontend, it’s rather intended to import attendees from external sources etc. There is a lot that it does not or can not do, and you will need to be careful using it. It allows to bypass many of the restrictions imposed when creating an order through the regular shop.

Specifically, this endpoint currently

• does not validate if products are only to be sold in a specific time frame

• does not validate if products are only to be sold on other sales channels

• does not validate if the event’s ticket sales are already over or haven’t started

• does not validate the number of items per order or the number of times an item can be included in an order

• does not validate any requirements related to add-on products and does not add bundled products automatically

• does not check prices but believes any prices you send

• does not prevent you from buying items that can only be bought with a voucher

• does not calculate fees automatically

• does not allow to pass data to plugins and will therefore cause issues with some plugins like the shipping module

• does not support file upload questions

• does not support redeeming gift cards

• does not support or validate memberships

You can supply the following fields of the resource:

• code (optional) – Only A-Z and 0-9, but without O and 1.

• status (optional) – Defaults to pending for non-free orders and paid for free orders. You can only set this to "n" for pending or "p" for paid. We will create a payment object for this order either in state created or in state confirmed, depending on this value. If you create a paid order, the order_paid signal will not be sent out to plugins and no email will be sent. If you want that behavior, create an unpaid order and then call the mark_paid API method.

• customer (optional) – Customer identifier or null

• testmode (optional) – Defaults to false

• consume_carts (optional) – A list of cart IDs. All cart positions with these IDs will be deleted if the order creation is successful. Any quotas or seats that become free by this operation will be credited to your order creation.

• email (optional)

• locale

• sales_channel (optional)

• payment_provider (optional) – The identifier of the payment provider set for this order. This needs to be an existing payment provider. You should use "free" for free orders, and we strongly advise to use "manual" for all orders you create as paid. This field is optional when the order status is "n" or the order total is zero, otherwise it is required.

• payment_info (optional) – You can pass a nested JSON object that will be set as the internal info value of the payment object that will be created. How this value is handled is up to the payment provider and you should only use this if you know the specific payment provider in detail. Please keep in mind that the payment provider will not be called to do anything about this (i.e. if you pass a bank account to a debit provider, no charge will be created), this is just informative in case you handled the payment already.

• payment_date (optional) – Date and time of the completion of the payment.

• comment (optional)

• custom_followup_at (optional)

• checkin_attention (optional)

• require_approval (optional)

• invoice_address (optional)

  • company

  • is_business

  • name or name_parts

  • street

  • zipcode

  • city

  • country

  • state

  • internal_reference

  • vat_id

  • vat_id_validated (optional) – If you need support for reverse charge (rarely the case), you need to check

  yourself if the passed VAT ID is a valid EU VAT ID. In that case, set this to true. Only valid VAT IDs will trigger reverse charge taxation. Don’t forget to set is_business as well!

• positions

  • positionid (optional, see below)

  • item

  • variation (optional)

  • price (optional, if set to null or missing the price will be computed from the given product)

  • seat (The seat_guid attribute of a seat. Required when the specified item requires a seat, otherwise must be null.)

  • attendee_name or attendee_name_parts (optional)

  • voucher (optional, the code attribute of a valid voucher)

  • attendee_email (optional)

  • company (optional)

  • street (optional)

  • zipcode (optional)

  • city (optional)

  • country (optional)

  • state (optional)

  • secret (optional)

  • addon_to (optional, see below)

  • subevent (optional)

  • answers

    • question

    • answer

    • options

• fees

  • fee_type

  • value

  • description

  • internal_type

  • tax_rule

  • _treat_value_as_percentage (Optional convenience flag. If set to true, your value parameter will be treated as a percentage and the fee will be calculated using that percentage and the sum of all product prices. Note that this will not include other fees and is calculated once during order generation and will not be respected automatically when the order changes later.)

  • _split_taxes_like_products (Optional convenience flag. If set to true, your tax_rule will be ignored and the fee will be taxed like the products in the order. If the products have multiple tax rates, multiple fees will be generated with weights adjusted to the net price of the products. Note that this will be calculated once during order generation and is not respected automatically when the order changes later.)

• force (optional). If set to true, quotas will be ignored.

• send_email (optional). If set to true, the same emails will be sent as for a regular order, regardless of whether these emails are enabled for certain sales channels. If set to null, behavior will be controlled by pretix’ settings based on the sales channels (added in pretix 4.7). Defaults to false. Used to be send_mail before pretix 3.14.

If you want to use add-on products, you need to set the positionid fields of all positions manually to incrementing integers starting with 1. Then, you can reference one of these IDs in the addon_to field of another position. Note that all add_ons for a specific position need to come immediately after the position itself.

Starting with pretix 3.7, you can add "simulate": true to the body to do a “dry run” of your order. This will validate your order and return you an order object with the resulting prices, but will not create an actual order. You can use this for testing or to look up prices. In this case, some attributes are ignored, such as whether to send an email or what payment provider will be used. Note that some returned fields will contain empty values (e.g. all id fields of positions will be zero) and some will contain fake values (e.g. the order code will always be PREVIEW). pretix plugins will not be triggered, so some special behavior might be missing as well.

Example request:

POST /api/v1/organizers/bigevents/events/sampleconf/orders/ HTTP/1.1
Host: pretix.eu
Accept: application/json, text/javascript
Content-Type: application/json

{
  "email": "dummy@example.org",
  "locale": "en",
  "sales_channel": "web",
  "fees": [
    {
      "fee_type": "payment",
      "value": "0.25",
      "description": "",
      "internal_type": "",
      "tax_rule": 2
    }
  ],
  "payment_provider": "banktransfer",
  "invoice_address": {
    "is_business": false,
    "company": "Sample company",
    "name_parts": {"full_name": "John Doe"},
    "street": "Sesam Street 12",
    "zipcode": "12345",
    "city": "Sample City",
    "country": "UK",
    "state": "",
    "internal_reference": "",
    "vat_id": ""
  },
  "positions": [
    {
      "positionid": 1,
      "item": 1,
      "variation": null,
      "price": "23.00",
      "attendee_name_parts": {
        "full_name": "Peter"
      },
      "attendee_email": null,
      "addon_to": null,
      "answers": [
        {
          "question": 1,
          "answer": "23",
          "options": []
        }
      ],
      "subevent": null
    }
  ]
}

Example response:

HTTP/1.1 201 Created
Vary: Accept
Content-Type: application/json

(Full order resource, see above.)

Parameters

• organizer – The slug field of the organizer of the event to create an order for

• event – The slug field of the event to create an order for

Status Codes

• 201 Created – no error

• 400 Bad Request – The order could not be created due to invalid submitted data or lack of quota.

• 401 Unauthorized – Authentication failure

• 403 Forbidden – The requested organizer/event does not exist or you have no permission to create this order.

Order state operations¶

POST /api/v1/organizers/(organizer)/events/(event)/orders/(code)/mark_paid/¶

Marks a pending or expired order as successfully paid.

Example request:

POST /api/v1/organizers/bigevents/events/sampleconf/orders/ABC12/mark_paid/ HTTP/1.1
Host: pretix.eu
Accept: application/json, text/javascript
Content-Type: application/json

{
    "send_email": true
}

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
  "code": "ABC12",
  "status": "p",
  ...
}

Parameters

• organizer – The slug field of the organizer to modify

• event – The slug field of the event to modify

• code – The code field of the order to modify

Status Codes

• 200 OK – no error

• 400 Bad Request – The order cannot be marked as paid, either because the current order status does not allow it or because no quota is left to perform the operation.

• 401 Unauthorized – Authentication failure

• 403 Forbidden – The requested organizer/event does not exist or you have no permission to view this resource.

• 404 Not Found – The requested order does not exist.

• 409 Conflict – The server was unable to acquire a lock and could not process your request. You can try again after a short waiting period.

POST /api/v1/organizers/(organizer)/events/(event)/orders/(code)/mark_canceled/¶

Cancels an order. For a pending order, this will set the order to status c. For a paid order, this will set the order to status c if no cancellation_fee is passed. If you do pass a cancellation_fee, the order will instead stay paid, but all positions will be removed (or marked as canceled) and replaced by the cancellation fee as the only component of the order.

You can control whether the customer is notified through send_email (defaults to true). You can pass a comment that can be visible to the user if it is used in the email template.

Example request:

POST /api/v1/organizers/bigevents/events/sampleconf/orders/ABC12/mark_canceled/ HTTP/1.1
Host: pretix.eu
Accept: application/json, text/javascript
Content-Type: text/json

{
    "send_email": true,
    "comment": "Event was canceled.",
    "cancellation_fee": null
}

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
  "code": "ABC12",
  "status": "c",
  ...
}

Parameters

• organizer – The slug field of the organizer to modify

• event – The slug field of the event to modify

• code – The code field of the order to modify

Status Codes

• 200 OK – no error

• 400 Bad Request – The order cannot be marked as canceled since the current order status does not allow it.

• 401 Unauthorized – Authentication failure

• 403 Forbidden – The requested organizer/event does not exist or you have no permission to view this resource.

• 404 Not Found – The requested order does not exist.

POST /api/v1/organizers/(organizer)/events/(event)/orders/(code)/reactivate/¶

Reactivates a canceled order. This will set the order to pending or paid state. Only possible if all products are still available.

Example request:

POST /api/v1/organizers/bigevents/events/sampleconf/orders/ABC12/reactivate/ HTTP/1.1
Host: pretix.eu
Accept: application/json, text/javascript

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
  "code": "ABC12",
  "status": "n",
  ...
}

Parameters

• organizer – The slug field of the organizer to modify

• event – The slug field of the event to modify

• code – The code field of the order to modify

Status Codes

• 200 OK – no error

• 400 Bad Request – The order cannot be reactivated

• 401 Unauthorized – Authentication failure

• 403 Forbidden – The requested organizer/event does not exist or you have no permission to view this resource.

• 404 Not Found – The requested order does not exist.

POST /api/v1/organizers/(organizer)/events/(event)/orders/(code)/mark_pending/¶

Marks a paid order as unpaid.

Example request:

POST /api/v1/organizers/bigevents/events/sampleconf/orders/ABC12/mark_pending/ HTTP/1.1
Host: pretix.eu
Accept: application/json, text/javascript

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
  "code": "ABC12",
  "status": "n",
  ...
}

Parameters

• organizer – The slug field of the organizer to modify

• event – The slug field of the event to modify

• code – The code field of the order to modify

Status Codes

• 200 OK – no error

• 400 Bad Request – The order cannot be marked as unpaid since the current order status does not allow it.

• 401 Unauthorized – Authentication failure

• 403 Forbidden – The requested organizer/event does not exist or you have no permission to view this resource.

• 404 Not Found – The requested order does not exist.

POST /api/v1/organizers/(organizer)/events/(event)/orders/(code)/mark_expired/¶

Marks an unpaid order as expired.

Example request:

POST /api/v1/organizers/bigevents/events/sampleconf/orders/ABC12/mark_expired/ HTTP/1.1
Host: pretix.eu
Accept: application/json, text/javascript

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
  "code": "ABC12",
  "status": "e",
  ...
}

Parameters

• organizer – The slug field of the organizer to modify

• event – The slug field of the event to modify

• code – The code field of the order to modify

Status Codes

• 200 OK – no error

• 400 Bad Request – The order cannot be marked as expired since the current order status does not allow it.

• 401 Unauthorized – Authentication failure

• 403 Forbidden – The requested organizer/event does not exist or you have no permission to view this resource.

• 404 Not Found – The requested order does not exist.

POST /api/v1/organizers/(organizer)/events/(event)/orders/(code)/extend/¶

Extends the payment deadline of a pending order. If the order is already expired and quota is still available, its state will be changed to pending.

The only required parameter of this operation is expires, which should contain a date in the future. Note that only a date is expected, not a datetime, since pretix will always set the deadline to the end of the day in the event’s timezone.

You can pass the optional parameter force. If it is set to true, the operation will be performed even if it leads to an overbooked quota because the order was expired and the tickets have been sold again.

Example request:

POST /api/v1/organizers/bigevents/events/sampleconf/orders/ABC12/extend/ HTTP/1.1
Host: pretix.eu
Accept: application/json, text/javascript
Content-Type: text/json

{
    "expires": "2017-10-28",
    "force": false
}

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
  "code": "ABC12",
  "status": "n",
  "expires": "2017-10-28T23:59:59Z",
  ...
}

Parameters

• organizer – The slug field of the organizer to modify

• event – The slug field of the event to modify

• code – The code field of the order to modify

Status Codes

• 200 OK – no error

• 400 Bad Request – The order cannot be extended since the current order status does not allow it or no quota is available or the submitted date is invalid.

• 401 Unauthorized – Authentication failure

• 403 Forbidden – The requested organizer/event does not exist or you have no permission to view this resource.

• 404 Not Found – The requested order does not exist.

POST /api/v1/organizers/(organizer)/events/(event)/orders/(code)/approve/¶

Approve an order that is pending approval.

Example request:

POST /api/v1/organizers/bigevents/events/sampleconf/orders/ABC12/approve/ HTTP/1.1
Host: pretix.eu
Accept: application/json, text/javascript

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
  "code": "ABC12",
  "status": "n",
  "require_approval": false,
  ...
}

Parameters

• organizer – The slug field of the organizer to modify

• event – The slug field of the event to modify

• code – The code field of the order to modify

Status Codes

• 200 OK – no error

• 400 Bad Request – The order cannot be approved, likely because the current order status does not allow it.

• 401 Unauthorized – Authentication failure

• 403 Forbidden – The requested organizer/event does not exist or you have no permission to view this resource.

• 404 Not Found – The requested order does not exist.

• 409 Conflict – The server was unable to acquire a lock and could not process your request. You can try again after a short waiting period.

POST /api/v1/organizers/(organizer)/events/(event)/orders/(code)/deny/¶

Marks an order that is pending approval as denied.

Example request:

POST /api/v1/organizers/bigevents/events/sampleconf/orders/ABC12/deny/ HTTP/1.1
Host: pretix.eu
Accept: application/json, text/javascript
Content-Type: text/json

{
    "send_email": true,
    "comment": "You're not a business customer!"
}

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
  "code": "ABC12",
  "status": "c",
  "require_approval": true,
  ...
}

Parameters

• organizer – The slug field of the organizer to modify

• event – The slug field of the event to modify

• code – The code field of the order to modify

Status Codes

• 200 OK – no error

• 400 Bad Request – The order cannot be marked as denied since the current order status does not allow it.

• 401 Unauthorized – Authentication failure

• 403 Forbidden – The requested organizer/event does not exist or you have no permission to update this resource.

• 404 Not Found – The requested order does not exist.

Generating invoices¶

POST /api/v1/organizers/(organizer)/events/(event)/orders/(code)/create_invoice/¶

Creates an invoice for an order which currently does not have an invoice. Returns the invoice object.

Example request:

POST /api/v1/organizers/bigevents/events/sampleconf/orders/ABC12/create_invoice/ HTTP/1.1
Host: pretix.eu
Accept: application/json, text/javascript

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
  "order": "FOO",
  "number": "DUMMY-00001",
  "is_cancellation": false,
  ...
}

Parameters

• organizer – The slug field of the organizer to modify

• event – The slug field of the event to modify

• code – The code field of the order to create an invoice for

Status Codes

• 200 OK – no error

• 400 Bad Request – The invoice can not be created (invoicing disabled, the order already has an invoice, …)

• 401 Unauthorized – Authentication failure

• 403 Forbidden – The requested organizer/event does not exist or you have no permission to view this resource.

• 404 Not Found – The requested order does not exist.

Sending e-mails¶

POST /api/v1/organizers/(organizer)/events/(event)/orders/(code)/resend_link/¶

Sends an email to the buyer with the link to the order page.

Example request:

POST /api/v1/organizers/bigevents/events/sampleconf/orders/ABC12/resend_link/ HTTP/1.1
Host: pretix.eu
Accept: application/json, text/javascript

Example response:

HTTP/1.1 204 No Content
Vary: Accept

Parameters

• organizer – The slug field of the organizer to modify

• event – The slug field of the event to modify

• code – The code field of the order to send an email for

Status Codes

• 200 OK – no error

• 400 Bad Request – The order does not have an email address associated

• 401 Unauthorized – Authentication failure

• 403 Forbidden – The requested organizer/event does not exist or you have no permission to view this resource.

• 404 Not Found – The requested order does not exist.

• 503 Service Unavailable – The email could not be sent.

List of all order positions¶

GET /api/v1/organizers/(organizer)/events/(event)/orderpositions/¶

Returns a list of all order positions within a given event.

Example request:

GET /api/v1/organizers/bigevents/events/sampleconf/orderpositions/ HTTP/1.1
Host: pretix.eu
Accept: application/json, text/javascript

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": 23442,
      "order": "ABC12",
      "positionid": 1,
      "canceled": false,
      "item": 1345,
      "variation": null,
      "price": "23.00",
      "attendee_name": "Peter",
      "attendee_name_parts": {
        "full_name": "Peter"
      },
      "attendee_email": null,
      "voucher": null,
      "tax_rate": "0.00",
      "tax_rule": null,
      "tax_value": "0.00",
      "secret": "z3fsn8jyufm5kpk768q69gkbyr5f4h6w",
      "discount": null,
      "pseudonymization_id": "MQLJvANO3B",
      "seat": null,
      "addon_to": null,
      "subevent": null,
      "checkins": [
        {
          "list": 44,
          "type": "entry",
          "gate": null,
          "device": 2,
          "datetime": "2017-12-25T12:45:23Z",
          "auto_checked_in": false
        }
      ],
      "answers": [
        {
          "question": 12,
          "question_identifier": "WY3TP9SL",
          "answer": "Foo",
          "option_idenfiters": [],
          "options": []
        }
      ],
      "downloads": [
        {
          "output": "pdf",
          "url": "https://pretix.eu/api/v1/organizers/bigevents/events/sampleconf/orderpositions/23442/download/pdf/"
        }
      ]
    }
  ]
}

Query Parameters

• page (integer) – The page number in case of a multi-page result set, default is 1

• ordering (string) – Manually set the ordering of results. Valid fields to be used are order__code, order__datetime, positionid, attendee_name, and order__status. Default: order__datetime,positionid

• order (string) – Only return positions of the order with the given order code

• search (string) – Fuzzy search matching the attendee name, order code, invoice address name as well as to the beginning of the secret.

• item (integer) – Only return positions with the purchased item matching the given ID.

• item__in (integer) – Only return positions with the purchased item matching one of the given comma-separated IDs.

• variation (integer) – Only return positions with the purchased item variation matching the given ID.

• variation__in (integer) – Only return positions with one of the purchased item variation matching the given comma-separated IDs.

• attendee_name (string) – Only return positions with the given value in the attendee_name field. Also, add-on products positions are shown if they refer to an attendee with the given name.

• secret (string) – Only return positions with the given ticket secret.

• pseudonymization_id (string) – Only return positions with the given pseudonymization ID.

• order__status (string) – Only return positions with the given order status.

• order__status__in (string) – Only return positions with one the given comma-separated order status.

• has_checkin (boolean) – If set to true or false, only return positions that have or have not been checked in already.

• subevent (integer) – Only return positions of the sub-event with the given ID

• subevent__in (integer) – Only return positions of one of the sub-events with the given comma-separated IDs

• addon_to (integer) – Only return positions that are add-ons to the position with the given ID.

• addon_to__in (integer) – Only return positions that are add-ons to one of the positions with the given comma-separated IDs.

• voucher (string) – Only return positions with a specific voucher.

• voucher__code (string) – Only return positions with a specific voucher code.

• include_canceled_positions – If set to true, the output will contain canceled order positions. Note that this only affects position-level cancellations, not fully-canceled orders.

Parameters

• organizer – The slug field of the organizer to fetch

• event – The slug field of the event to fetch

Status Codes

• 200 OK – no error

• 401 Unauthorized – Authentication failure

• 403 Forbidden – The requested organizer/event does not exist or you have no permission to view this resource.

Fetching individual positions¶

GET /api/v1/organizers/(organizer)/events/(event)/orderpositions/(id)/¶

Returns information on one order position, identified by its internal ID.

Example request:

GET /api/v1/organizers/bigevents/events/sampleconf/orderpositions/23442/ HTTP/1.1
Host: pretix.eu
Accept: application/json, text/javascript

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
  "id": 23442,
  "order": "ABC12",
  "positionid": 1,
  "canceled": false,
  "item": 1345,
  "variation": null,
  "price": "23.00",
  "attendee_name": "Peter",
  "attendee_name_parts": {
    "full_name": "Peter",
  },
  "attendee_email": null,
  "voucher": null,
  "tax_rate": "0.00",
  "tax_rule": null,
  "tax_value": "0.00",
  "secret": "z3fsn8jyufm5kpk768q69gkbyr5f4h6w",
  "addon_to": null,
  "subevent": null,
  "discount": null,
  "pseudonymization_id": "MQLJvANO3B",
  "seat": null,
  "checkins": [
    {
      "list": 44,
      "type": "entry",
      "gate": null,
      "device": 2,
      "datetime": "2017-12-25T12:45:23Z",
      "auto_checked_in": false
    }
  ],
  "answers": [
    {
      "question": 12,
      "question_identifier": "WY3TP9SL",
      "answer": "Foo",
      "option_idenfiters": [],
      "options": []
    }
  ],
  "downloads": [
    {
      "output": "pdf",
      "url": "https://pretix.eu/api/v1/organizers/bigevents/events/sampleconf/orderpositions/23442/download/pdf/"
    }
  ]
}

Parameters

• organizer – The slug field of the organizer to fetch

• event – The slug field of the event to fetch

• id – The id field of the order position to fetch

Query Parameters

• include_canceled_positions – If set to true, canceled positions may be returned (otherwise, they return 404).

Status Codes

• 200 OK – no error

• 401 Unauthorized – Authentication failure

• 403 Forbidden – The requested organizer/event does not exist or you have no permission to view this resource.

• 404 Not Found – The requested order position does not exist.

Order position ticket download¶

GET /api/v1/organizers/(organizer)/events/(event)/orderpositions/(id)/download/(output)/¶

Download tickets for one order position, identified by its internal ID. Depending on the chosen output, the response might be a ZIP file, PDF file or something else. The order details response contains a list of output options for this particular order position.

Be aware that the output does not have to be a file, but can also be a regular HTTP response with a Content-Type set to text/uri-list. In this case, the user is expected to navigate to that URL in order to access their ticket. The referenced URL can provide a download or a regular, human-viewable website - so it is advised to open this URL in a webbrowser and leave it up to the user to handle the result.

Tickets can only be downloaded if ticket downloads are active and – depending on event settings – the order is either paid or pending. Also, depending on event configuration downloads might be only unavailable for add-on products or non-admission products. Note that in some cases the ticket file might not yet have been created. In that case, you will receive a status code 409 Conflict and you are expected to retry the request after a short period of waiting.

Example request:

GET /api/v1/organizers/bigevents/events/sampleconf/orderpositions/23442/download/pdf/ HTTP/1.1
Host: pretix.eu
Accept: application/json, text/javascript

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/pdf

...

Parameters

• organizer – The slug field of the organizer to fetch

• event – The slug field of the event to fetch

• id – The id field of the order position to fetch

• output – The internal name of the output provider to use

Status Codes

• 200 OK – no error

• 401 Unauthorized – Authentication failure

• 403 Forbidden – The requested organizer/event does not exist or you have no permission to view this resource or downloads are not available for this order position at this time. The response content will contain more details.

• 404 Not Found – The requested order position or download provider does not exist.

• 409 Conflict – The file is not yet ready and will now be prepared. Retry the request after waiting for a few seconds.

Manipulating individual positions¶

PATCH /api/v1/organizers/(organizer)/events/(event)/orderpositions/(id)/¶

Updates specific fields on an order position. Currently, only the following fields are supported:

• attendee_email

• attendee_name_parts or attendee_name

• company

• street

• zipcode

• city

• country

• state

• answers: If specified, you will need to provide all answers for this order position. Validation is handled the same way as when creating orders through the API. You are therefore expected to provide question, answer, and possibly options. question_identifier and option_identifiers will be ignored. As a special case, you can submit the magic value "file:keep" as the answer to a file question to keep the current value without re-uploading it.

• item

• variation

• subevent

• seat (specified as a string mapping to a string_guid)

• price

• tax_rule

Changing parameters such as item or price will not automatically trigger creation of a new invoice, you need to take care of that yourself.

Example request:

PATCH /api/v1/organizers/bigevents/events/sampleconf/orderpositions/23442/ HTTP/1.1
Host: pretix.eu
Accept: application/json, text/javascript
Content-Type: application/json

{
  "attendee_email": "other@example.org"
}

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

(Full order position resource, see above.)

Parameters

• organizer – The slug field of the organizer of the event

• event – The slug field of the event

• id – The id field of the order position to update

Status Codes

• 200 OK – no error

• 400 Bad Request – The order could not be updated due to invalid submitted data.

• 401 Unauthorized – Authentication failure

• 403 Forbidden – The requested organizer/event does not exist or you have no permission to update this order.

POST /api/v1/organizers/(organizer)/events/(event)/orderpositions/¶

Adds a new position to an order. Currently, only the following fields are supported:

• order (mandatory, specified as a string mapping to a code)

• addon_to (optional, specified as an integer mapping to the positionid of the parent position)

• item (mandatory)

• variation (mandatory depending on item)

• subevent (mandatory depending on event)

• seat (specified as a string mapping to a string_guid, mandatory depending on event and item)

• price (default price will be used if unset)

• attendee_email

• attendee_name_parts or attendee_name

• company

• street

• zipcode

• city

• country

• state

• answers: Validation is handled the same way as when creating orders through the API. You are therefore expected to provide question, answer, and possibly options. question_identifier and option_identifiers will be ignored. As a special case, you can submit the magic value "file:keep" as the answer to a file question to keep the current value without re-uploading it.

This will not automatically trigger creation of a new invoice, you need to take care of that yourself.

Example request:

POST /api/v1/organizers/bigevents/events/sampleconf/orderpositions/ HTTP/1.1
Host: pretix.eu
Accept: application/json, text/javascript
Content-Type: application/json

{
  "order": "ABC12",
  "item": 5,
  "addon_to": 1
}

Example response:

HTTP/1.1 201 Created
Vary: Accept
Content-Type: application/json

(Full order position resource, see above.)

Parameters

• organizer – The slug field of the organizer of the event

• event – The slug field of the event

Status Codes

• 200 OK – no error

• 400 Bad Request – The position could not be created due to invalid submitted data.

• 401 Unauthorized – Authentication failure

• 403 Forbidden – The requested organizer/event does not exist or you have no permission to create this position.

DELETE /api/v1/organizers/(organizer)/events/(event)/orderpositions/(id)/¶

Cancels an order position, identified by its internal ID.

Example request:

DELETE /api/v1/organizers/bigevents/events/sampleconf/orderpositions/23442/ HTTP/1.1
Host: pretix.eu
Accept: application/json, text/javascript

Example response:

HTTP/1.1 204 No Content
Vary: Accept

Parameters

• organizer – The slug field of the organizer to fetch

• event – The slug field of the event to fetch

• id – The id field of the order position to delete

Status Codes

• 204 No Content – no error

• 400 Bad Request – This position cannot be deleted (e.g. last position in order)

• 401 Unauthorized – Authentication failure

• 403 Forbidden – The requested organizer/event does not exist or you have no permission to view this resource.

• 404 Not Found – The requested order position does not exist.

Changing order contents¶

While you can change positions individually sometimes it is necessary to make multiple changes to an order at once within one transaction. This makes it possible to e.g. swap the seats of two attendees in an order without running into conflicts. This interface also offers some possibilities not available otherwise, such as splitting an order or changing fees.

POST /api/v1/organizers/(organizer)/events/(event)/orders/(code)/change/¶

Performs a change operation on an order. You can supply the following fields:

• patch_positions: A list of objects with the two keys position specifying an order position ID and body specifying the desired changed values of the position (item, variation, subevent, seat, price, tax_rule).

• cancel_positions: A list of objects with the single key position specifying an order position ID.

• split_positions: A list of objects with the single key position specifying an order position ID.

• create_positions: A list of objects describing new order positions with the same fields supported as when creating them individually through the POST …/orderpositions/ endpoint.

• patch_fees: A list of objects with the two keys fee specifying an order fee ID and body specifying the desired changed values of the position (value).

• cancel_fees: A list of objects with the single key fee specifying an order fee ID.

• recalculate_taxes: If set to "keep_net", all taxes will be recalculated based on the tax rule and invoice address, the net price will be kept. If set to "keep_gross", the gross price will be kept. If set to null (the default) the taxes are not recalculated.

• send_email: If set to true, the customer will be notified about the change. Defaults to false.

• reissue_invoice: If set to true and an invoice exists for the order, it will be canceled and a new invoice will be issued. Defaults to true.

Example request:

POST /api/v1/organizers/bigevents/events/sampleconf/orders/ABC12/change/ HTTP/1.1
Host: pretix.eu
Accept: application/json, text/javascript
Content-Type: application/json

{
  "cancel_positions": [
    {
      "position": 12373
    }
  ],
  "patch_positions": [
    {
      "position": 12374,
      "body": {
        "item": 12,
        "variation": None,
        "subevent": 562,
        "seat": "seat-guid-2",
        "price": "99.99",
        "tax_rule": 15
      }
    }
  ],
  "split_positions": [
    {
      "position": 12375
    }
  ],
  "create_positions": [
    {
      "item": 12,
      "variation": None,
      "subevent": 562,
      "seat": "seat-guid-2",
      "price": "99.99",
      "addon_to": 12374,
      "attendee_name": "Peter",
    }
  ],
  "cancel_fees": [
    {
      "fee": 49
    }
  ],
  "change_fees": [
    {
      "fee": 51,
      "body": {
        "value": "12.00"
      }
    }
  ],
  "reissue_invoice": true,
  "send_email": true,
  "recalculate_taxes": "keep_gross"
}

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

(Full order position resource, see above.)

Parameters

• organizer – The slug field of the organizer of the event

• event – The slug field of the event

• code – The code field of the order to update

Status Codes

• 200 OK – no error

• 400 Bad Request – The order could not be updated due to invalid submitted data.

• 401 Unauthorized – Authentication failure

• 403 Forbidden – The requested organizer/event does not exist or you have no permission to update this order.

Order payment endpoints¶

GET /api/v1/organizers/(organizer)/events/(event)/orders/(code)/payments/¶

Returns a list of all payments for an order.

Example request:

GET /api/v1/organizers/bigevents/events/sampleconf/orders/ABC12/payments/ HTTP/1.1
Host: pretix.eu
Accept: application/json, text/javascript

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "local_id": 1,
      "state": "confirmed",
      "amount": "23.00",
      "created": "2017-12-01T10:00:00Z",
      "payment_date": "2017-12-04T12:13:12Z",
      "payment_url": null,
      "details": {},
      "provider": "banktransfer"
    }
  ]
}

Query Parameters

• page (integer) – The page number in case of a multi-page result set, default is 1

Parameters

• organizer – The slug field of the organizer to fetch

• event – The slug field of the event to fetch

• order – The code field of the order to fetch

Status Codes

• 200 OK – no error

• 401 Unauthorized – Authentication failure

• 403 Forbidden – The requested organizer/event does not exist or you have no permission to view this resource.

• 404 Not Found – The requested order does not exist.

GET /api/v1/organizers/(organizer)/events/(event)/orders/(code)/payments/(local_id)/¶

Returns information on one payment, identified by its order-local ID.

Example request:

GET /api/v1/organizers/bigevents/events/sampleconf/orders/ABC12/payments/1/ HTTP/1.1
Host: pretix.eu
Accept: application/json, text/javascript

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
  "local_id": 1,
  "state": "confirmed",
  "amount": "23.00",
  "created": "2017-12-01T10:00:00Z",
  "payment_date": "2017-12-04T12:13:12Z",
  "payment_url": null,
  "details": {},
  "provider": "banktransfer"
}

Parameters

• organizer – The slug field of the organizer to fetch

• event – The slug field of the event to fetch

• code – The code field of the order to fetch

• local_id – The local_id field of the payment to fetch

Status Codes

• 200 OK – no error

• 401 Unauthorized – Authentication failure

• 403 Forbidden – The requested organizer/event does not exist or you have no permission to view this resource.

• 404 Not Found – The requested order or payment does not exist.

POST /api/v1/organizers/(organizer)/events/(event)/orders/(code)/payments/(local_id)/confirm/¶

Marks a payment as confirmed. Only allowed in states pending and created.

Example request:

POST /api/v1/organizers/bigevents/events/sampleconf/orders/ABC12/payments/1/confirm/ HTTP/1.1
Host: pretix.eu
Accept: application/json, text/javascript
Content-Type: application/json

{
    "send_email": true,
    "force": false
}

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
  "local_id": 1,
  "state": "confirmed",
  ...
}

Parameters

• organizer – The slug field of the organizer to fetch

• event – The slug field of the event to fetch

• code – The code field of the order to fetch

• local_id – The local_id field of the payment to modify

Status Codes

• 200 OK – no error

• 400 Bad Request – Invalid request or payment state

• 401 Unauthorized – Authentication failure

• 403 Forbidden – The requested organizer/event does not exist or you have no permission to view this resource.

• 404 Not Found – The requested order or payment does not exist.

POST /api/v1/organizers/(organizer)/events/(event)/orders/(code)/payments/(local_id)/cancel/¶

Marks a payment as canceled. Only allowed in states pending and created.

Example request:

POST /api/v1/organizers/bigevents/events/sampleconf/orders/ABC12/payments/1/cancel/ HTTP/1.1
Host: pretix.eu
Accept: application/json, text/javascript

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
  "local_id": 1,
  "state": "canceled",
  ...
}

Parameters

• organizer – The slug field of the organizer to fetch

• event – The slug field of the event to fetch

• code – The code field of the order to fetch

• local_id – The local_id field of the payment to modify

Status Codes

• 200 OK – no error

• 400 Bad Request – Invalid request or payment state

• 401 Unauthorized – Authentication failure

• 403 Forbidden – The requested organizer/event does not exist or you have no permission to view this resource.

• 404 Not Found – The requested order or payment does not exist.

POST /api/v1/organizers/(organizer)/events/(event)/orders/(code)/payments/(local_id)/refund/¶

Create and execute a manual refund. Only available in confirmed state. Returns a refund resource, not a payment resource!

Example request:

POST /api/v1/organizers/bigevents/events/sampleconf/orders/ABC12/payments/1/refund/ HTTP/1.1
Host: pretix.eu
Accept: application/json, text/javascript
Content-Type: application/json

{
  "amount": "23.00",
  "mark_canceled": false
}

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
  "local_id": 1,
  "source": "admin",
  "state": "done",
  ...
}

Parameters

• organizer – The slug field of the organizer to fetch

• event – The slug field of the event to fetch

• code – The code field of the order to fetch

• local_id – The local_id field of the payment to modify

Status Codes

• 200 OK – no error

• 400 Bad Request – Invalid request, payment state, or operation not supported by the payment provider

• 401 Unauthorized – Authentication failure

• 403 Forbidden – The requested organizer/event does not exist or you have no permission to view this resource.

• 404 Not Found – The requested order or payment does not exist.

POST /api/v1/organizers/(organizer)/events/(event)/orders/(code)/payments/¶

Creates a new payment.

Be careful with the info parameter: You can pass a nested JSON object that will be set as the internal info value of the payment object that will be created. How this value is handled is up to the payment provider and you should only use this if you know the specific payment provider in detail. Please keep in mind that the payment provider will not be called to do anything about this (i.e. if you pass a bank account to a debit provider, no charge will be created), this is just informative in case you handled the payment already.

Example request:

POST /api/v1/organizers/bigevents/events/sampleconf/orders/ABC12/payments/ HTTP/1.1
Host: pretix.eu
Accept: application/json, text/javascript
Content-Type: application/json

{
  "state": "confirmed",
  "amount": "23.00",
  "payment_date": "2017-12-04T12:13:12Z",
  "info": {},
  "send_email": false,
  "provider": "banktransfer"
}

Example response:

HTTP/1.1 201 Created
Vary: Accept
Content-Type: application/json

{
  "local_id": 1,
  "state": "confirmed",
  "amount": "23.00",
  "created": "2017-12-01T10:00:00Z",
  "payment_date": "2017-12-04T12:13:12Z",
  "payment_url": null,
  "details": {},
  "provider": "banktransfer"
}

Parameters

• organizer – The slug field of the organizer to access

• event – The slug field of the event to access

• order – The code field of the order to access

Status Codes

• 201 Created – no error

• 401 Unauthorized – Authentication failure

• 403 Forbidden – The requested organizer/event does not exist or you have no permission to view this resource.

• 404 Not Found – The requested order does not exist.

Order refund endpoints¶

GET /api/v1/organizers/(organizer)/events/(event)/orders/(code)/refunds/¶

Returns a list of all refunds for an order.

Example request:

GET /api/v1/organizers/bigevents/events/sampleconf/orders/ABC12/refunds/ HTTP/1.1
Host: pretix.eu
Accept: application/json, text/javascript

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "local_id": 1,
      "state": "done",
      "source": "admin",
      "amount": "23.00",
      "payment": 1,
      "created": "2017-12-01T10:00:00Z",
      "execution_date": "2017-12-04T12:13:12Z",
      "comment": "Cancellation",
      "details": {},
      "provider": "banktransfer"
    }
  ]
}

Query Parameters

• page (integer) – The page number in case of a multi-page result set, default is 1

Parameters

• organizer – The slug field of the organizer to fetch

• event – The slug field of the event to fetch

• order – The code field of the order to fetch

Status Codes

• 200 OK – no error

• 401 Unauthorized – Authentication failure

• 403 Forbidden – The requested organizer/event does not exist or you have no permission to view this resource.

• 404 Not Found – The requested order does not exist.

GET /api/v1/organizers/(organizer)/events/(event)/orders/(code)/refunds/(local_id)/¶

Returns information on one refund, identified by its order-local ID.

Example request:

GET /api/v1/organizers/bigevents/events/sampleconf/orders/ABC12/refunds/1/ HTTP/1.1
Host: pretix.eu
Accept: application/json, text/javascript

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
  "local_id": 1,
  "state": "done",
  "source": "admin",
  "amount": "23.00",
  "payment": 1,
  "created": "2017-12-01T10:00:00Z",
  "execution_date": "2017-12-04T12:13:12Z",
  "comment": "Cancellation",
  "details": {},
  "provider": "banktransfer"
}

Parameters

• organizer – The slug field of the organizer to fetch

• event – The slug field of the event to fetch

• code – The code field of the order to fetch

• local_id – The local_id field of the refund to fetch

Status Codes

• 200 OK – no error

• 401 Unauthorized – Authentication failure

• 403 Forbidden – The requested organizer/event does not exist or you have no permission to view this resource.

• 404 Not Found – The requested order or refund does not exist.

POST /api/v1/organizers/(organizer)/events/(event)/orders/(code)/refunds/¶

Creates a refund manually.

Warning

We recommend to only use this endpoint for refunds with payment provider manual. This endpoint also does not check for mismatching amounts etc. Be careful!

Example request:

POST /api/v1/organizers/bigevents/events/sampleconf/orders/ABC12/refunds/ HTTP/1.1
Host: pretix.eu
Accept: application/json, text/javascript
Content-Type: application/json

{
  "state": "created",
  "source": "admin",
  "amount": "23.00",
  "payment": 1,
  "execution_date": null,
  "comment": "Cancellation",
  "provider": "manual",
  "mark_canceled": false,
  "mark_pending": true
}

Example response:

HTTP/1.1 201 Created
Vary: Accept
Content-Type: application/json

{
  "local_id": 1,
  "state": "created",
  "source": "admin",
  "amount": "23.00",
  "payment": 1,
  "created": "2017-12-01T10:00:00Z",
  "execution_date": null,
  "comment": "Cancellation",
  "details": {},
  "provider": "manual"
}

Query Parameters

• page (integer) – The page number in case of a multi-page result set, default is 1

Parameters

• organizer – The slug field of the organizer to fetch

• event – The slug field of the event to fetch

• order – The code field of the order to fetch

Status Codes

• 200 OK – no error

• 400 Bad Request – Invalid data supplied

• 401 Unauthorized – Authentication failure

• 403 Forbidden – The requested organizer/event does not exist or you have no permission to view this resource.

• 404 Not Found – The requested order does not exist.

POST /api/v1/organizers/(organizer)/events/(event)/orders/(code)/refunds/(local_id)/done/¶

Marks a refund as completed. Only allowed in states transit and created.

Example request:

POST /api/v1/organizers/bigevents/events/sampleconf/orders/ABC12/refunds/1/done/ HTTP/1.1
Host: pretix.eu
Accept: application/json, text/javascript

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
  "local_id": 1,
  "state": "done",
  ....
}

Parameters

• organizer – The slug field of the organizer to fetch

• event – The slug field of the event to fetch

• code – The code field of the order to fetch

• local_id – The local_id field of the refund to modify

Status Codes

• 200 OK – no error

• 400 Bad Request – Invalid request or refund state

• 401 Unauthorized – Authentication failure

• 403 Forbidden – The requested organizer/event does not exist or you have no permission to view this resource.

• 404 Not Found – The requested order or refund does not exist.

POST /api/v1/organizers/(organizer)/events/(event)/orders/(code)/refunds/(local_id)/process/¶

Acts on an external refund, either marks the order as canceled or pending. Only allowed in state external.

Example request:

POST /api/v1/organizers/bigevents/events/sampleconf/orders/ABC12/refunds/1/done/ HTTP/1.1
Host: pretix.eu
Accept: application/json, text/javascript
Content-Type: application/json

{"mark_canceled": false}

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
  "local_id": 1,
  "state": "done",
  ....
}

Parameters

• organizer – The slug field of the organizer to fetch

• event – The slug field of the event to fetch

• code – The code field of the order to fetch

• local_id – The local_id field of the refund to modify

Status Codes

• 200 OK – no error

• 400 Bad Request – Invalid request or refund state

• 401 Unauthorized – Authentication failure

• 403 Forbidden – The requested organizer/event does not exist or you have no permission to view this resource.

• 404 Not Found – The requested order or refund does not exist.

POST /api/v1/organizers/(organizer)/events/(event)/orders/(code)/refunds/(local_id)/cancel/¶

Marks a refund as canceled. Only allowed in states transit, external, and created.

Example request:

POST /api/v1/organizers/bigevents/events/sampleconf/orders/ABC12/refunds/1/cancel/ HTTP/1.1
Host: pretix.eu
Accept: application/json, text/javascript

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
  "local_id": 1,
  "state": "canceled",
  ....
}

Parameters

• organizer – The slug field of the organizer to fetch

• event – The slug field of the event to fetch

• code – The code field of the order to fetch

• local_id – The local_id field of the refund to modify

Status Codes

• 200 OK – no error

• 400 Bad Request – Invalid request or refund state

• 401 Unauthorized – Authentication failure

• 403 Forbidden – The requested organizer/event does not exist or you have no permission to view this resource.

• 404 Not Found – The requested order or refund does not exist.

Revoked ticket secrets¶

With some non-default ticket secret generation methods, a list of revoked ticket secrets is required for proper validation.

GET /api/v1/organizers/(organizer)/events/(event)/revokedsecrets/¶

Returns a list of all revoked secrets within a given event.

Example request:

GET /api/v1/organizers/bigevents/events/sampleconf/revokedsecrets/ HTTP/1.1
Host: pretix.eu
Accept: application/json, text/javascript

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json
X-Page-Generated: 2017-12-01T10:00:00Z

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": 1234,
      "secret": "k24fiuwvu8kxz3y1",
      "created": "2017-12-01T10:00:00Z",
    }
  ]
}

Query Parameters

• page (integer) – The page number in case of a multi-page result set, default is 1

• ordering (string) – Manually set the ordering of results. Valid fields to be used are secret and created. Default: -created

• created_since (datetime) – Only return revocations that have been created since the given date.

Parameters

• organizer – The slug field of the organizer to fetch

• event – The slug field of the event to fetch

Response Headers

• X-Page-Generated – The server time at the beginning of the operation. If you’re using this API to fetch differences, this is the value you want to use as created_since in your next call.

Status Codes

• 200 OK – no error

• 401 Unauthorized – Authentication failure

• 403 Forbidden – The requested organizer/event does not exist or you have no permission to view this resource.