API Reference
Introduction
Fundamental concepts of the Dub API.
Dub’s API is currently in beta. If you have any questions or feedback, please reach out to us at support@dub.co.
Base URL
Dub’s API is built on REST principles and is served over HTTPS. To ensure data privacy, unencrypted HTTP is not supported.
The Base URL for all API endpoints is:
https://api.dub.co
Authentication
Authentication to the Dub API is performed via the Authorization header with a Bearer token. To authenticate, you need to include the Authorization header with the word Bearer
followed by your token in your API requests like so:
Authorization: Bearer <Your-Token>
You can get your token under your Dub Account Settings.
Response Codes
The API returns standard HTTP response codes to indicate the success or failure of an API request. Here are a few examples:
Code | Description |
---|---|
200 | The request was successful. |
400 | The request was invalid or cannot be served. |
401 | The request requires user authentication. |
403 | The server understood the request, but refuses to authorize it. |
404 | The requested resource could not be found. |
429 | Too many requests. |
500 | The server encountered an unexpected condition which prevented it from fulfilling the request. |
Caveats
- Dub’s API is currently in beta and is subject to change. However, we will do our best to keep breaking changes to a minimum.
- The API does not support
PUT
requests at this time. One workaround would be toDELETE
the resource andPOST
a new one. - The API does not support generic shortlinks (
dub.sh
,chatg.pt
) at this time.
Was this page helpful?