Travel Marketplace API
The REST API for syncing destinations, publishing packages, and receiving live booking events. Every endpoint below has a dedicated page with integration steps, sample requests, and responses.
Base URL: https://tourapi.nirajp.com.np/api/v1
Authentication
Register an organization
Create a new organization and its owner account. The account is created pending approval — you can log in once approved.
Authenticate a user
Exchange email + password for an access token (JWT) and refresh token. Send the access token as a Bearer header on all protected requests.
Get the current user
Return the profile of the user identified by the supplied JWT.
Packages
Bookings
Integrations
Subscribe to webhooks
Register an outbound webhook subscription. We POST signed JSON to your target URL when any of the selected events occur.
List webhook subscriptions
List your active webhook subscriptions.
Delete a webhook
Remove a webhook subscription. Replace :id with the subscription id.
Create a partner API key
Mint a partner API key. The raw key is returned once and must be stored securely — use it as the x-api-key header on /partner/* routes.
List API keys
List your API keys. Only prefixes are returned — full keys are shown once at creation.
Revoke an API key
Revoke a partner API key. Replace :id with the key id.
Partner API
Webhooks
Subscribe via POST /integrations/webhooks. We POST a signed JSON payload to your URL on these events:
booking.createdbooking.updatedbooking.cancelled
{
"event": "booking.created",
"data": { "bookingId": 5, "status": "pending" },
"sentAt": "2026-07-19T09:09:34.676Z"
}Headers: X-Event, X-Signature: sha256=… (HMAC-SHA256 with your signing secret), X-Delivery-Attempt. Failed deliveries retry up to 5 times.