Introduction

Our API allows you to gain access to your tickets. If you are having problems accessing resources or have anything in mind we should add, let us know via support@tinydub.com

Example: Self-assigned tickets

Method: GET

$access_token = 't8ZMQLQiquuyMjHFqfqW0hlEvQsNioCQLLe9npgZ';
 
curl https://tinydub.com/api/v1/tickets/self \
    -H "Authorization: Bearer $access_token" \
    -H 'Accept: application/json' \
    -H 'Content-Type: application/json'

Rate Limiting

You can make up to 60 requests per minute and 1,440 requests per day per authenticated user. You can check the returned HTTP headers of any API request to see your current per minute rate limit status:

Status: 200 OK
x-ratelimit-limit: 60
x-ratelimit-remaining: 59

If you keep hitting the limit, consider caching the results within your application.

Errors

When we detect an error in your request, we will return a HTTP 4xx response. Most common will be 400 (Bad Request), 401 (Unauthorized), 403 (Forbidden) and 404 (Not Found).

For example, a 404 response will return the following information:

{
  "error": "Ticket not found"
}

Please note that the response error might give you further details about what went wrong. A error is only returned for requests that resulted with an error. If you aren't receiving errors, but for example a login page, make sure you've set "Accept: application/json" in your request headers.

Response data

All responses from our API will be formatted as JSON.

This is an example payload of the /api/v1/tickets/self endpoint, which gives you data about tickets that are currently assigned to you.

[
    {
        "id": "tA1MShTq",
        "name": "Rosalie",
        "email": "rosalie@example.com",
        "status": "pending",
        "has_unread_messages": true,
        "created_at": "2025-11-25T08:47:59.000000Z"
    }
]

Successful responses will return a HTTP 20x response.