REST API

Our REST API exposes versioned HTTP endpoints with predictable resource URLs and RFC-compliant error responses. Use it for conventional CRUD-style integrations, webhooks, and background jobs.

Endpoints

• Production: https://api.tourfold.com/api/v2/

Reference

• OpenAPI: /openapi (download the YAML specification)

Start here

• Conventions: Basics covers naming, date formats, pagination cursors, and URL structure.
• Authentication: Auth explains OAuth2/OIDC and API key usage.
• Errors: Shared Errors for REST and GraphQL.

Common guides

• Pagination, sorting & filtering
• Nested resources
• Rate limiting
• Server-sent events
• Tracing

Example request

curl -X GET "https://api.tourfold.com/api/v2/areas" \
  -H "Authorization: Bearer YOUR_TOKEN"