Getting Started

Make your first call to the Mobilytics Partner API in three steps.

1. Get an API key

Contact support@mobilytics.com to be provisioned a key. You'll receive two keys:

  • A staging key prefixed msk_test_ for integration testing.
  • A production key prefixed msk_live_ for live traffic.

Keep both secret. Rotate by asking support — the prior key is deactivated in the same transaction the new one is issued. See Authentication → Rotation for planning a clean cutover.

2. Make the hello-world call

The meta endpoint returns your API version and the companies your key is scoped to. If this call works, authentication and scoping are correctly set up.

curl -H "X-API-Key: msk_test_..." \
  https://app-api.dev.mobilytics.ai/v1/partner/meta

Expected response:

{
  "version": "v1",
  "companies": [{ "id": "cm1abc...", "name": "Your Company" }]
}

If companies is empty, your key has no company scope — reach out to support.

3. List your assets

curl -H "X-API-Key: msk_test_..." \
  https://app-api.dev.mobilytics.ai/v1/partner/assets

Every endpoint under /v1/partner/* returns data scoped to the companies on your key. Cross-tenant reads return 404 NOT_FOUND — we never reveal the existence of assets you don't own.

Base URLs

EnvironmentBase URL
Dev / previewhttps://app-api.dev.mobilytics.ai
Productionhttps://app-api.mobilytics.ai

Use the dev environment for integration testing. The staging key works only against the dev base URL; the production key works only against production.

What's next