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
| Environment | Base URL |
|---|---|
| Dev / preview | https://app-api.dev.mobilytics.ai |
| Production | https://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
- Explore the Reference — every endpoint, parameter, and response shape.
- Read the Authentication, Pagination, and Error handling concepts so you don't have to learn them one bug at a time.
- Subscribe to the Changelog for additive changes and advance notice of breaking changes.