Get Agency Configuration

Retrieve the agency's configuration settings for mobile app initialization. This endpoint provides all the information needed to customize the app experience for a specific agency, including branding, feature flags, document requirements, and booking rules.

This is typically the first API call made when the app launches. It determines:

• Branding: Logo, colors, and agency name for UI customization
• Feature flags: Which features are enabled (bookings, payments, etc.)
• Document requirements: What documents users must upload before booking
• Booking rules: Minimum/maximum rental periods, advance booking limits
• Payment settings: Currency, deposit requirements, accepted methods
• Support information: Contact details and hours of operation

Public Endpoint

This endpoint does not require user authentication—only the agency signature is needed. This allows the app to display agency branding and requirements before the user logs in or registers.

Endpoint

INFO

GET /api/v1/client/config

Headers

Header	Value	Required
Accept	application/json	Yes
X-Agency-Signature	{signature}	Yes

TIP

This endpoint does not require authentication. Only the agency signature is needed.

Example Request

curl -X GET https://api.daakey.com/api/v1/client/config \
  -H "Accept: application/json" \
  -H "X-Agency-Signature: {signature}"

Response

Success (200)

{
  "success": true,
  "message": "Configuration retrieved",
  "data": {
    "agency": {
      "id": 123,
      "name": "Daakey Car Rental",
      "code": "DAAKEY01",
      "logo_url": "https://api.daakey.com/storage/agencies/123/logo.png",
      "primary_color": "#6366f1",
      "secondary_color": "#8b5cf6"
    },
    "features": {
      "bookings_enabled": true,
      "payments_enabled": true,
      "documents_required": true,
      "phone_verification_required": true,
      "email_verification_required": false
    },
    "documents": {
      "required": ["driver_license_front", "driver_license_back"],
      "optional": ["id_card", "passport"]
    },
    "booking": {
      "min_hours": 1,
      "max_days": 30,
      "advance_booking_days": 90,
      "cancellation_hours": 24
    },
    "payment": {
      "currency": "USD",
      "methods": ["card"],
      "deposit_required": true,
      "deposit_amount": 200.00
    },
    "support": {
      "email": "support@daakey.com",
      "phone": "+1234567890",
      "hours": "24/7"
    },
    "legal": {
      "terms_url": "https://daakey.com/terms",
      "privacy_url": "https://daakey.com/privacy"
    }
  },
  "meta": {
    "agency_id": 123,
    "agency_code": "DAAKEY01"
  },
  "request_id": "uuid",
  "timestamp": "2024-01-01T00:00:00.000Z"
}

Notes

• This endpoint is called once when the app initializes
• Configuration may be cached client-side
• Changes to config require app restart or refresh