Getting Started with Yolcu360 Agency API

Yolcu360 Agency API is a RESTful API that allows our business partners to easily integrate with our car rental and transfer services. With this API, you can:

• Search for locations
• Query available vehicles
• Create reservations
• Process payments
• Manage orders
• Book and manage private transfers (see Transfer Overview)

To use the API, you first need to obtain an API key and secret. To do this, log in to the agency portal at pro.yolcu360.com and create a new key from the API Keys section.

You need to obtain a JWT token using your API key:

curl -X POST https://staging.api.pro.yolcu360.com/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "key": "YOUR_API_KEY",
    "secret": "YOUR_API_SECRET"
  }'

Successful response:

{
  "accessToken": "eyJhbGciOiJIUzI1NiIs...",
  "refreshToken": "dGhpc2lzYXJlZnJlc2h0b2tlbg...",
  "accessTokenExpireAt": "2024-12-26T10:30:00Z",
  "refreshTokenExpireAt": "2024-12-27T10:00:00Z"
}

Use the accessToken you received in the Authorization header for all API calls:

curl -X GET https://staging.api.pro.yolcu360.com/api/v1/locations?query=istanbul \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Our API serves in two different environments:

⚠️ Important: Reservations made in the staging environment are not real. Payments in the staging environment are only supported for the "Yolcutest" vendor. If a payment is blocked due to this rule, API responds with code 6008.

The API uses standard HTTP status codes:

• 200 OK - Request successful
• 201 Created - Resource created
• 400 Bad Request - Invalid request
• 401 Unauthorized - Authentication error
• 403 Forbidden - Authorization error
• 404 Not Found - Resource not found
• 429 Too Many Requests - Rate limit exceeded
• 500 Internal Server Error - Server error

Error responses are in the following format:

{
  "code": 1001,
  "description": "Invalid request parameters",
  "details": {
    "field": "checkInDateTime",
    "message": "Must be a future date"
  }
}

Authentication and location lookup are shared with car rental; the booking steps differ. See Transfer Overview for the details.

For technical support:

• Email: api-support@yolcu360.com
• Documentation: api-docs.yolcu360.com