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

# List Mobile Apps

> Retrieve all mobile apps registered in your project for deep linking and attribution

## Request

<ParamField header="X-API-KEY" type="string" required>
  Your API key: `b2co_your_api_key`
</ParamField>

## Response

<ResponseField name="success" type="boolean">
  Indicates if the request was successful
</ResponseField>

<ResponseField name="data" type="object">
  Response data containing mobile apps list
</ResponseField>

<ResponseField name="data.apps" type="array">
  Array of mobile app objects
</ResponseField>

<ResponseField name="data.apps[].id" type="string">
  Unique identifier for the mobile app
</ResponseField>

<ResponseField name="data.apps[].name" type="string">
  Display name of the mobile app
</ResponseField>

<ResponseField name="data.apps[].platform" type="string">
  Platform type: `IOS` or `ANDROID`
</ResponseField>

<ResponseField name="data.apps[].bundleId" type="string">
  iOS bundle identifier (iOS apps only)
</ResponseField>

<ResponseField name="data.apps[].appStoreFallback" type="string">
  App Store fallback URL (iOS apps only)
</ResponseField>

<ResponseField name="data.apps[].appStoreId" type="string">
  App Store ID (iOS apps only)
</ResponseField>

<ResponseField name="data.apps[].iosMinVersion" type="string">
  Minimum iOS version required (iOS apps only)
</ResponseField>

<ResponseField name="data.apps[].packageName" type="string">
  Android package name (Android apps only)
</ResponseField>

<ResponseField name="data.apps[].playStoreFallback" type="string">
  Play Store fallback URL (Android apps only)
</ResponseField>

<ResponseField name="data.apps[].androidMinVersion" type="string">
  Minimum Android version required (Android apps only)
</ResponseField>

<ResponseField name="data.apps[].createdAt" type="string">
  ISO 8601 timestamp when the app was created
</ResponseField>

<ResponseField name="data.apps[].updatedAt" type="string">
  ISO 8601 timestamp when the app was last updated
</ResponseField>

<ResponseField name="data.total" type="number">
  Total number of mobile apps in the project
</ResponseField>

<ResponseField name="timestamp" type="string">
  ISO 8601 timestamp of the response
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.bit2connect.com/1.0/mobile-apps" \
    -H "X-API-KEY: b2co_your_api_key"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.bit2connect.com/1.0/mobile-apps', {
    method: 'GET',
    headers: {
      'X-API-KEY': 'b2co_your_api_key'
    }
  });

  const data = await response.json();
  console.log(data);
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://api.bit2connect.com/1.0/mobile-apps',
      headers={'X-API-KEY': 'b2co_your_api_key'}
  )

  data = response.json()
  print(data)
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "data": {
      "apps": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440000",
          "name": "My iOS App",
          "platform": "IOS",
          "bundleId": "com.mycompany.myapp",
          "appStoreFallback": "https://apps.apple.com/app/id123456789",
          "appStoreId": "123456789",
          "iosMinVersion": "14.0",
          "packageName": null,
          "playStoreFallback": null,
          "androidMinVersion": null,
          "createdAt": "2024-01-15T10:30:00Z",
          "updatedAt": "2024-01-15T10:30:00Z"
        },
        {
          "id": "550e8400-e29b-41d4-a716-446655440001",
          "name": "My Android App",
          "platform": "ANDROID",
          "bundleId": null,
          "appStoreFallback": null,
          "appStoreId": null,
          "iosMinVersion": null,
          "packageName": "com.mycompany.myapp",
          "playStoreFallback": "https://play.google.com/store/apps/details?id=com.mycompany.myapp",
          "androidMinVersion": "21",
          "createdAt": "2024-01-15T11:00:00Z",
          "updatedAt": "2024-01-15T11:00:00Z"
        }
      ],
      "total": 2
    },
    "timestamp": "2024-01-15T12:00:00Z"
  }
  ```
</ResponseExample>