Partner Connections - PageOne Travel B2B API

All endpoints require partner JWT:

Authorization: Bearer <partner_jwt>

Path scope:

/api/partners/:partnerId/connections

Backend enforces that path partnerId must equal authenticated user’s partner ID.

What is Connection

A connection is partner-specific API access configuration. Key fields:

code: numeric connection code used in core API requests (settings.access.code)
apiType: public | b2b | cug | mobile
connectionType: direct | tgx | metasearch
rateLimit, rateLimitWindowMs
netMarkups
currentInUse
notificationEmail

1) List My Partner Connections

GET /api/partners/:partnerId/connections

2) Get One Partner Connection

GET /api/partners/:partnerId/connections/:id

3) Update Connection Notification Email

PUT /api/partners/:partnerId/connections/:id/notification-email

Request body:

{
  "notificationEmail": "alerts@partner.com"
}

Field validation:

notificationEmail: optional, must be valid email if provided

Example List Response

{
  "data": [
    {
      "id": "67ab66acd90f8d7bf44ff005",
      "code": 10001,
      "apiType": "b2b",
      "rateLimit": 60,
      "currentInUse": true,
      "partnerId": "67a84f588277d6f3bc5ecfff",
      "notificationEmail": "alerts@partner.com",
      "createdAt": "2026-01-18T05:10:10.000Z",
      "updatedAt": "2026-02-11T18:51:09.000Z"
    }
  ],
  "message": "success"
}

Common Errors

403 You can only access connections for your own partner
403 This connection does not belong to your partner
404 Connection not found

​What is Connection

​1) List My Partner Connections

​2) Get One Partner Connection

​3) Update Connection Notification Email

​Example List Response

​Common Errors