You need authorization token to send request to all the endpoints in this documentation.
\nThis postman collections comes with a demo key. Please use it in your development. If you hit limit please reach out to use. You can also obtain personal token by creating on account on the platform.
\nAuthorization key can be obtained from account click here
\nOnce the authorization key is obtained. It must be added in the header of each request which is sent to server
\nKey: x-code
\nValue: abcdefghai
\nexample: x-code: abcdefghai
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"21304751","collectionId":"c9191d8b-8df0-47a6-b98f-ec7fa29c37a3","publishedId":"2sAY517zaC","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-11-09T15:33:11.000Z"},"item":[{"name":"Create Short Url","id":"dd3433ce-3d46-4001-998a-fb5368796b36","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-code","value":"abc","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"url\": \"https://example.com/long-urlasd2832\",\r\n \"dltHeader\": \"BKMTCH\",\r\n \"maxLength\": 10\r\n}","options":{"raw":{"language":"json"}}},"url":"https://smler.in/api/v1/short","description":"This end point is used to shorten a long url and generate a short code for the same. Please toggle between examples on the right to see all variation of shorting.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-code"},{"key":"value","value":"Update your short urls which were already created before. You can update all the parameters except the shortCode, dltHeader and domain. You can also update the originalUrl by passing parameter of originalUrl. Everything else follows same as the create request.
This method will help you get the long form of the generated short url. Getting url by this query will not be counted as a hit and won't be added be added in analytics
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-code"},{"key":"value","value":"This parameter must be the short code which is present in the url
\n","type":"text/plain"},"key":"short","value":"ZoxHzANoVQ"},{"description":{"content":"This parameter is optional. If no dltHeader was provided while url creation. Then there's no need to pass this parameter
\n","type":"text/plain"},"key":"dltHeader","value":"optional-dlt-header"},{"description":{"content":"Optional parameter to specify the domain of short url. Leave it blank you're using smler.in else use your custom domain
\n","type":"text/plain"},"key":"domain","value":"smler.in"},{"description":{"content":"Optional parameter to also a trigger a webhook on this request
\n","type":"text/plain"},"key":"triggerWebhook","value":"true"}],"variable":[]}},"response":[{"id":"661236fb-3c8c-435d-832b-79cb4260f79a","name":"Get Long Url","originalRequest":{"method":"GET","header":[{"key":"x-code","value":"abcdefghijklmnop","type":"text"}],"url":{"raw":"https://smler.in/api/v1/short?short=ZoxHzANoVQ&dltHeader=optional-dlt-header","protocol":"https","host":["smler","in"],"path":["api","v1","short"],"query":[{"key":"short","value":"ZoxHzANoVQ","description":"This parameter must be the short code which is present in the url"},{"key":"dltHeader","value":"optional-dlt-header","description":"This parameter is optional. If no dltHeader was provided while url creation. Then there's no need to pass this parameter"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Date","value":"Tue, 08 Oct 2024 08:05:47 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"315"},{"key":"Connection","value":"keep-alive"},{"key":"vary","value":"Origin"},{"key":"access-control-allow-origin","value":"*"}],"cookie":[],"responseTime":null,"body":"{\n \"_id\": \"6704e29f87d0213283e46381\",\n \"originalUrl\": \"https://example.com/long-url\",\n \"shortCode\": \"ZoxHzANoVQ\",\n \"createdBy\": \"66fb7ed74f2ee9c85af00a86\",\n \"domain\": \"smler.in\",\n \"dltHeader\": \"optional-dlt-header\",\n \"createdAt\": \"2024-10-08T07:43:27.910Z\",\n \"updatedAt\": \"2024-10-08T07:43:27.910Z\",\n \"__v\": 0,\n \"id\": \"6704e29f87d0213283e46381\"\n}"}],"_postman_id":"12287d05-2d56-4e56-9e43-305da8ac32c3"},{"name":"Create Short Url In Bulk","id":"efc7681b-d739-4b05-a292-abdbdd178d36","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"urls\": [\r\n {\"url\": \"https://example.com\", \"dltHeader\": \"BOKIMO\", \"maxLength\": 9, \"domain\": \"test.smler.in\"},\r\n {\"url\": \"https://example.co\", \"dltHeader\": \"BOKIMO\", \"maxLength\": 9, \"domain\": \"bokimo.com\"}\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://smler.in/api/v2/short/bulk","description":"This end point is used to bulk shorten a long url and generate a short code for the same. Please toggle between examples on the right to see all variation of shorting the url.
\nNote: You can bulk short, maximum of 5000 urls in one go. If you have more than that try them in batches of 5000.
\nSend in an array of urls. Each block should contain the following schema. Refer examples for exact details
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-code"},{"key":"value","value":"Purpose
Marks a tracked deep-link click as converted (e.g., after an app install or desired action). Useful for attributing conversions to a specific short link/click.
HTTP
\nMethod: POST
\nURL: https://smler.in/api/v2/track/:clickId
\nRequest body (JSON)
\nCommon errors
\n400 Bad Request: Missing or invalid body fields (shortCode/domain).
\n404 Not Found: clickId does not exist or does not belong to the provided short link/domain.
\n409 Conflict: Click already marked as converted (see idempotency notes).
\n429 Too Many Requests: Rate limit exceeded.
\n5xx Server Error: Temporary service issues.
\nUsage notes
\nIdempotency: Re-sending for the same click may either return 200 with the existing conversion state or 409 Conflict depending on server configuration. Treat the operation as idempotent from a client perspective (safe to retry with the same payload when you receive transient errors).
\nConversion marking: The server associates the conversion with the provided clickId and validates that the shortCode and domain match the original click. Ensure you pass the exact short link details used to generate the click.
\nRelated: See saved example \"Track deep link with click id\" for variations and testing scenarios.
\nWhen a webhook needs to be triggered manually, you can call this API endpoint.
\nIn deep link scenarios, requests are handled directly by the application and do not reach the Smler server. As a result, any webhooks or associated notifications will not be triggered automatically.
\nTo address this, you can manually invoke this endpoint whenever a deep link is used. This ensures that the webhook is triggered as expected.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-code"},{"key":"value","value":"