API Now Live!
REST API v1 is production-ready. Start building today.
Build with Mobily API
Powerful REST API to create, manage, and track short links programmatically
Fast & Simple
RESTful API with JSON responses. Get started in minutes with our simple authentication.
Secure
API key authentication with rate limiting. HTTPS-only endpoints for maximum security.
Analytics
Full analytics data for every link. Track clicks, referrers, devices, and more.
Quick Start
1 Get Your API Key
Generate your API key from your dashboard. Each key supports 1,000 requests/hour.
Go to API Keys2 Make Your First Request
Create a short link with a simple POST request:
curl -X POST https://mobily.ca/api/v1/links \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com/very-long-url",
"custom_alias": "mylink"
}'
3 Get Response
Receive your shortened link instantly:
{
"success": true,
"short_url": "https://mobily.ca/mylink",
"original_url": "https://example.com/very-long-url",
"alias": "mylink",
"created_at": "2025-10-07T14:30:00Z"
}
API Endpoints
/api/v1/links
Create Short Link
Create a new shortened URL with optional custom alias and settings.
Parameters:
url(required) - The original URL to shortencustom_alias(optional) - Custom short codepassword(optional) - Password protectionexpires_at(optional) - Expiration date (YYYY-MM-DD)
/api/v1/links/{alias}
Get Link Details
Retrieve information about a specific shortened link including analytics.
/api/v1/links
List All Links
Get a paginated list of all your shortened links.
/api/v1/links/{alias}
Update Link
Update link settings like password, expiration, or destination URL.
/api/v1/links/{alias}
Delete Link
Permanently delete a shortened link.
/api/v1/links/{alias}/analytics
Get Analytics
Retrieve detailed analytics data for a specific link.
Error Codes
| Code | Status | Description |
|---|---|---|
| 200 | OK | Request completed successfully |
| 400 | Bad Request | Invalid parameters or malformed request |
| 401 | Unauthorized | Missing or invalid API key |
| 403 | Forbidden | API key doesn't have permission for this action |
| 404 | Not Found | Resource not found |
| 429 | Too Many Requests | Rate limit exceeded. Wait before retrying. |
| 500 | Internal Server Error | Server error. Contact support if persists. |
Error Response Format
All error responses include a JSON body with error and message fields for debugging.
Authentication
All API requests require authentication using an API key. Include your API key in the Authorization header:
Authorization: Bearer YOUR_API_KEY
Keep Your API Key Secret
Never expose your API key in client-side code or public repositories. Store it securely in environment variables.
Rate Limits
Free Plan
100
requests / hour
Pro Plan
1,000
requests / hour
Business Plan
10,000
requests / hour
Ready to Start Building?
Get your API key now and start integrating Mobily into your applications today.