API Documentation

Travel Inventory ID API

Integrate the Universal Travel Product ID registry into your systems. Search, match, and manage travel inventory with our RESTful API.

Get API AccessView Endpoints

RESTful Architecture

Standard HTTP methods and JSON responses for easy integration

Secure Authentication

API keys with role-based access control and rate limiting

High Performance

99.9% uptime SLA with sub-100ms response times

Scalable Infrastructure

Handle millions of requests with automatic scaling

Authentication

Simple API key authentication

All API requests require authentication using an API key. Include your key in the Authorization header with every request.

  • Generate API keys from your dashboard
  • Keys are scoped to specific permissions
  • Rotate keys without downtime
  • Monitor usage and rate limits in real-time

Authorization Header

Authorization: Bearer YOUR_API_KEY

Example request

curl -X GET \

"https://api.tripsworld.com/registry/search?q=marina"

-H "Authorization: Bearer sk_live_xxx"

Endpoints

Available API endpoints

The Travel Inventory ID API provides endpoints for searching, retrieving, and managing travel product identities.

GET/registry/search
GET/registry/product/{UTPID}
POST/registry/match
POST/registry/batch-map
GET/registry/duplicates/{UTPID}
POST/registry/verify
GET/registry/stats
Example Response

Structured JSON responses

All responses follow a consistent JSON structure with clear status codes, pagination support, and detailed error messages.

Response includes

  • Canonical UTPID identifier
  • Product name and category
  • Verification status
  • Match confidence score
  • Linked suppliers
  • Duplicate count

GET /registry/product/TW-HTL-00291847

{

"utpid": "TW-HTL-00291847",

"name": "Marina Bay Suites",

"category": "hotel",

"location": {

"city": "Singapore",

"country": "SG",

"coordinates": [1.2894, 103.8610]

},

"verified": true,

"confidence": 0.97,

"suppliers": [

{ "id": "SUP-001", "name": "Expedia" },

{ "id": "SUP-002", "name": "Booking.com" }

],

"duplicates": 2,

"lastUpdated": "2024-01-15T10:30:00Z"

}

Ready to integrate?

Get started with the Travel Inventory ID API. Create an account to receive your API key and access the full documentation.

Get API Access