> ## Documentation Index
> Fetch the complete documentation index at: https://docs.handauncle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get System URLs

> Returns system URLs like terms and conditions, privacy policy, FAQs, and support email.

Retrieve system URLs including terms and conditions, privacy policy, FAQs, and support email.

This endpoint provides all the legal and support-related URLs that need to be
displayed in the mobile app.

## Use Cases

* Display links in settings or about screens
* Show legal documents when required
* Provide support contact information
* Ensure compliance with app store requirements

## Response

Returns a `systemUrls` object containing:

* `termsAndConditions`: URL to the terms and conditions page
* `privacyPolicy`: URL to the privacy policy page
* `faqs`: URL to the frequently asked questions page
* `supportEmail`: Email address for customer support

## Example

### Request

```bash cURL theme={null}
curl -X GET 'https://api.handauncle.com/app/config/system-urls' \
  -H 'Accept: application/json'
```

```javascript JavaScript theme={null}
const response = await fetch('https://api.handauncle.com/app/config/system-urls');
const { data } = await response.json();

// Use in your app
const termsUrl = data.systemUrls.termsAndConditions;
const privacyUrl = data.systemUrls.privacyPolicy;
const supportEmail = data.systemUrls.supportEmail;
```

```swift Swift/iOS theme={null}
let url = URL(string: "https://api.handauncle.com/app/config/system-urls")!
let (data, _) = try await URLSession.shared.data(from: url)
let response = try JSONDecoder().decode(ConfigResponse.self, from: data)

let termsURL = response.data.systemUrls.termsAndConditions
```

### Response

```json theme={null}
{
  "success": true,
  "data": {
    "systemUrls": {
      "termsAndConditions": "https://www.handauncle.com/terms-and-conditions",
      "privacyPolicy": "https://www.handauncle.com/privacy-policy",
      "faqs": "https://www.handauncle.com/terms-and-conditions",
      "supportEmail": "hello@handauncle.com"
    }
  },
  "meta": {
    "timestamp": "2025-12-10T14:32:18.445Z",
    "request_id": "req_674e2f4a8c1b3d5e7f9a2b4c"
  }
}
```

## See Also

* [Update System URLs](/api-reference/endpoint/app-config-update-system-urls) - Admin endpoint to modify these URLs
* [Get All Configuration](/api-reference/endpoint/app-config) - Get both system and social media URLs


## OpenAPI

````yaml GET /app/config/system-urls
openapi: 3.1.0
info:
  title: Handa Uncle API
  version: 1.0.0
  description: Public specification for the Handa Uncle web and mobile APIs.
  contact:
    name: Handa Uncle Engineering
    email: hello@handauncle.com
servers:
  - url: https://handauncle-backend-prod-205012263523.asia-south1.run.app
    description: Prod API base (Cloud Run)
  - url: https://api.handauncle.com
    description: Production
  - url: https://staging-api.handauncle.com
    description: Staging
  - url: http://localhost:8080
    description: Local development
security: []
tags:
  - name: Mobile App
    description: Endpoints used by the native Handa Uncle app.
  - name: Platform
    description: Cross-service operational endpoints.
  - name: Auth
    description: Authentication endpoints handled by the backend adapter.
  - name: AI
    description: LLM chat endpoints supporting streaming and device-auth guests.
  - name: OTP
    description: Phone OTP lifecycle powered by Exotel.
  - name: Webhooks
    description: Server-to-server hooks invoked by Auth0.
  - name: Conversations
    description: Authenticated user conversation management.
  - name: Chat Share
    description: Create, manage, and consume shared conversations.
  - name: Files
    description: Upload, list, and delete user files.
  - name: Prompt management
    description: Admin and public APIs for managing masked pre-prompts.
  - name: User Profile
    description: Profile card collection and user data for personalized AI responses.
  - name: Visual Embeds
    description: Manage visual embed images that attach to AI chat responses.
  - name: Second Opinion
    description: Admin and public APIs for Second Opinion suggestion cards.
  - name: Profile Cards
    description: >-
      APIs for managing profile card questions used in onboarding and
      personalization.
paths:
  /app/config/system-urls:
    get:
      tags:
        - Mobile App
      summary: Get system URLs configuration
      description: >-
        Returns system URLs like terms and conditions, privacy policy, FAQs, and
        support email.
      operationId: getSystemUrls
      responses:
        '200':
          description: System URLs returned successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SystemUrlsResponseEnvelope'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  schemas:
    SystemUrlsResponseEnvelope:
      type: object
      properties:
        success:
          type: boolean
          enum:
            - true
        data:
          $ref: '#/components/schemas/SystemUrlsData'
        meta:
          $ref: '#/components/schemas/ResponseMeta'
      required:
        - success
        - data
        - meta
      example:
        success: true
        data:
          systemUrls:
            termsAndConditions: https://www.handauncle.com/terms
            privacyPolicy: https://www.handauncle.com/privacy
            faqs: https://www.handauncle.com/faqs
            supportEmail: hello@handauncle.com
        meta:
          requestId: req_674e2f5b9d2c4e6f8a1b3c5d
          timestamp: '2025-12-10T14:33:45.789Z'
    SystemUrlsData:
      type: object
      properties:
        systemUrls:
          $ref: '#/components/schemas/SystemUrls'
      required:
        - systemUrls
      example:
        systemUrls:
          termsAndConditions: https://www.handauncle.com/terms
          privacyPolicy: https://www.handauncle.com/privacy
          faqs: https://www.handauncle.com/faqs
          supportEmail: hello@handauncle.com
    ResponseMeta:
      type: object
      properties:
        timestamp:
          type: string
          format: date-time
        requestId:
          type: string
          description: Server generated correlation identifier.
      required:
        - timestamp
        - requestId
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
          enum:
            - false
        error:
          $ref: '#/components/schemas/ErrorObject'
        meta:
          $ref: '#/components/schemas/ResponseMeta'
      required:
        - success
        - error
        - meta
    SystemUrls:
      type: object
      properties:
        termsAndConditions:
          type: string
          format: uri
        privacyPolicy:
          type: string
          format: uri
        faqs:
          type: string
          format: uri
        supportEmail:
          type: string
          format: email
      required:
        - termsAndConditions
        - privacyPolicy
        - faqs
        - supportEmail
      example:
        termsAndConditions: https://www.handauncle.com/terms
        privacyPolicy: https://www.handauncle.com/privacy
        faqs: https://www.handauncle.com/faqs
        supportEmail: hello@handauncle.com
    ErrorObject:
      type: object
      properties:
        message:
          type: string
          description: Human-readable error message describing the issue.
          example: Please enter a valid 10-digit phone number (e.g., 9876543210)
        code:
          type: string
          description: Error code for programmatic handling.
          example: VALIDATION_ERROR
        details:
          type: array
          description: >-
            Array of field-specific validation errors (for VALIDATION_ERROR
            responses).
          items:
            type: object
            properties:
              field:
                type: string
                description: Field name that failed validation.
                example: phone
              message:
                type: string
                description: Specific validation error message for this field.
                example: Please enter a valid 10-digit phone number (e.g., 9876543210)
            required:
              - field
              - message
      required:
        - message
  responses:
    InternalError:
      description: Unexpected server error.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'

````