Skip to main content

VentesWeb API

Welcome to the Connect VentesWeb API documentation.

Overview​

The Connect VentesWeb API is the REST rewrite of the legacy AparteConnectPlus SOAP web service. It provides a modern REST interface for building web sales channels on top of Tick&Live's ticketing platform:

  • Catalog Management - Browse events, venues, rates and fees
  • Cart & Order Processing - Build carts, allocate seats and confirm orders programmatically
  • Identity - Authenticate and manage customer identity
  • Media - Retrieve venue seating plan pictures

Base URLs​

  • Development: http://localhost:5000

Authentication​

The API uses JWT Bearer authentication. Provide your token in the Authorization header:

curl -H "Authorization: Bearer <your-jwt-token>" \
     -H "x-tenant: your-tenant-id" \
     http://localhost:5000/api/v1/catalog/events

The API is multi-tenant: every request must also include the x-tenant header containing your tenant ID.

See the Authentication Guide for details.

Rate Limits​

The API enforces rate limits to ensure fair usage:

  • Catalog endpoints: 100 requests/minute
  • Cart & Order endpoints: 20 requests/minute
  • Overall: 1000 requests/hour

See Rate Limits for details and best practices.

Response Format​

All responses are JSON. Successful responses return data in the following format:

{
  "events": [...],
  "pagination": {...}
}

Errors follow the RFC 7807 Problem Details format:

{
  "type": "https://tools.ietf.org/html/rfc7231#section-6.5.1",
  "title": "Bad Request",
  "status": 400,
  "detail": "Error description"
}

API Versioning​

The current API version is v1. Version information is included in response headers:

API-Version: 1.0

Interactive Documentation​

Use the API Reference (generated automatically from OpenAPI) to explore endpoints interactively. You can:

  • View request/response schemas
  • Try endpoints directly from your browser
  • See code examples in multiple languages

Note: The API Reference is automatically generated from the OpenAPI specification.

Getting Started​

New to the API? Start here:

  1. Authentication - Learn about authentication
  2. Complete Authentication Guide - Detailed authentication documentation

Migration from SOAP​

The VentesWeb API is a REST rewrite of the AparteConnectPlus SOAP web service. Migrating from the SOAP API? Check out our SOAP Migration Guide. Each endpoint documents its SOAP equivalent (ACP_* method) and the SOAP to REST field mapping.

Support​

Need help?

Next Steps​

  • Explore the API Reference (auto-generated from OpenAPI)
  • Review Best Practices
  • Check the Changelog for latest updates