Skip to main content

​
Endpoint

GET /api/professional-settings

​
Description

Retrieves the current configuration and preferences for the professional, including work schedule, session parameters, and payment settings. See implementation in server/src/modules/professional-settings/professional-settings.controller.ts:14-24.

​
Authentication

This endpoint requires Bearer token authentication. Include your access token in the Authorization header.

​
Request

No parameters required.

​
Response

​
status
number
HTTP status code (200 for success)
​
data
array
Array of professional settings objects (typically contains one object)

​
Example Request

curl -X GET https://your-domain.com/api/professional-settings \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

​
Example Response

{
  "status": 200,
  "data": [
    {
      "user_id": "prof456",
      "session_duration_minutes": 60,
      "work_days": "1,2,3,4,5",
      "work_start_time": "09:00",
      "work_end_time": "17:00",
      "reservation_window_days": 30,
      "requires_deposit": true,
      "deposit_amount": 5000,
      "session_modalities": "BOTH",
      "office_address": "Av. Example 123, City"
    }
  ]
}

​
Error Responses

​
Not Found

{
  "statusCode": 404,
  "message": "Configuración no encontrada",
  "error": "Not Found"
}

​
Unauthorized

{
  "statusCode": 401,
  "message": "Token inválido o expirado",
  "error": "Unauthorized"
}

​
Use Cases

  • Display professional’s availability settings
  • Check if payment is required before booking
  • Show session duration and modalities to clients
  • Calculate available appointment slots
  • Determine booking window for client scheduling

​
Notes

  • Response typically contains an array with a single settings object
  • Settings determine reservation creation behavior
  • Used by Create Without Payment to check payment requirements
  • Essential for calculating availability in Get Availability

Build docs developers (and LLMs) love

Get started for freeTalk to us