List tickets

Returns a paginated list of tickets.

Availability: Full version only — a Clock instance answers 404 for this endpoint.

Request

GET /api/v1/tickets

curl --request GET \
     --url 'https://www.zep-online.de/zepinstanz/next/api/v1/tickets' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer {token}'

Query parameters

Name
perPage
Type
integer, nullable
Description
Ignored on this endpoint — send limit instead. Any value given here is replaced by limit, or by the default when limit is absent.
Name
page
Type
integer, nullable
Description
The page of results to return, counting from 1.
Name
orderBy
Type
string, nullable
Description
Name of the field to sort by.
Name
order
Type
string, nullable
Description
Sort direction, ascending or descending.
One of: "asc", "desc"
Name
limit
Type
integer, nullable
Description
The number of records per page, 1 to 200. Defaults to 15.
Name
modified_after
Type
string (date-time)
Description
Only return records modified after this timestamp (ISO 8601, or “Y-m-d H:i:s”).
Name
modified_before
Type
string (date-time)
Description
Only return records modified before or at this timestamp (ISO 8601, or “Y-m-d H:i:s”).
Name
start_date
Type
string (date)
Description
Name
end_date
Type
string (date)
Description

Response

{
  "data": [
    {
      "id": 1,
      "subject": "Fehler in der Benutzeroberfläche beheben",
      "priority": 3,
      "status": {
        "id": 1,
        "name": "neu"
      },
      "creator_username": "max.mustermann",
      "processor_username": "frank",
      "date": "2024-07-20T00:00:00.000000Z",
      "receipt_date": "2024-11-15",
      "start_date": "2024-01-15T00:00:00.000000Z",
      "deadline": "2024-11-20",
      "processing_date": "2024-02-28 14:09:38",
      "done_date": "2024-02-28 14:11:38",
      "approved_date": "2024-03-12 08:23:54",
      "rejected_date": "2026-01-31T09:00:00.000000Z",
      "billed_date": "2024-05-31T00:00:00.000000Z",
      "planned_hours": 1.5,
      "prevent_overbooking": 0,
      "history_modified": "2024-03-12 08:23:54",
      "project_id": 16,
      "project_task_id": 1,
      "notify_of_completion": true,
      "customer_contact_person_id": 1,
      "history_creator_username": "max.mustermann",
      "customer_reference": "string",
      "external_ticket_number": "string",
      "from_mail": "string",
      "created": "2024-07-20T11:30:00.000000Z",
      "modified": "2024-07-20T12:30:00.000000Z",
      "keywords": {},
      "categories": [
        {
          "name": "EU",
          "description": {
            "de": "string",
            "en": "string",
            "fr": "string",
            "es": "string",
            "pl": "string"
          },
          "type": {
            "id": "string",
            "name": "Mitarbeiter/in"
          }
        }
      ]
    }
  ],
  "links": {
    "first": "string",
    "last": "string",
    "prev": "string",
    "next": "string"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "links": [
      {
        "url": "string",
        "label": "string",
        "active": true
      }
    ],
    "path": "string",
    "per_page": 1,
    "to": 1,
    "total": 1
  }
}

Response fields

Name
id
Type
integer
Description
The ticket’s unique identifier.
Name
subject
Type
string
Description
The ticket’s subject line.
Name
priority
Type
integer
Description
The ticket’s priority, an integer from 1 to 5. Instances may define custom designations for these values, so no fixed meaning per number is guaranteed.
Name
status
Type
object
Description
The ticket’s lifecycle status (e.g. new, in process, done).
Name
status.id
Type
integer
Description
The stored value. Compare against this, not against name.
Name
status.name
Type
string
Description
The human-readable label, delivered in the tenant’s language. Do not parse it.
One of: "neu", "in Bearbeitung", "fertig", "abgelehnt", "bewilligt", "billed"
Name
creator_username
Type
string, nullable
Description
The username of the employee who created the ticket.
Name
processor_username
Type
string, nullable
Description
The username of the employee currently processing the ticket.
Name
date
Type
string (date-time), nullable
Description
The date the ticket was raised.
Name
receipt_date
Type
string (date-time), nullable
Description
The date the underlying request was received (e.g. by mail).
Name
start_date
Type
string (date-time), nullable
Description
The date work on the ticket is planned to start.
Name
deadline
Type
string (date-time), nullable
Description
The date by which the ticket should be completed.
Name
processing_date
Type
string (date-time), nullable
Description
The date the ticket moved into processing.
Name
done_date
Type
string (date-time), nullable
Description
The date the ticket was marked done.
Name
approved_date
Type
string (date-time), nullable
Description
The date the ticket was approved.
Name
rejected_date
Type
string (date-time), nullable
Description
The date the ticket was rejected.
Name
billed_date
Type
string (date-time), nullable
Description
The date the ticket was billed.
Name
planned_hours
Type
number, nullable
Description
The number of hours planned for this ticket.
Name
prevent_overbooking
Type
integer
Description
Whether recorded time for this ticket may exceed its planned hours, and for which time types.
One of: 0, 1, 2, 3, 4
Name
history_modified
Type
string (date-time), nullable
Description
When the ticket’s most recent activity entry (comment or status change) was recorded.
Name
project_id
Type
integer
Description
The id of the project this ticket belongs to.
Name
project_task_id
Type
integer
Description
The id of the project task (PSP element) this ticket is booked against.
Name
notify_of_completion
Type
boolean, nullable
Description
Whether the ticket creator is notified by e-mail when the ticket is marked done.
Name
customer_contact_person_id
Type
integer, nullable
Description
The id of the customer contact this ticket was raised by or for.
Name
history_creator_username
Type
string, nullable
Description
The username of the employee who created the ticket’s first history entry.
Name
customer_reference
Type
string, nullable
Description
A free-text reference number supplied by the customer for this ticket.
Name
external_ticket_number
Type
string, nullable
Description
A ticket number from an external system this ticket corresponds to.
Name
from_mail
Type
string, nullable
Description
The sender e-mail address, if the ticket was created from an incoming e-mail.
Name
created
Type
string (date-time), nullable
Description
When the ticket record was created.
Name
modified
Type
string (date-time), nullable
Description
When the ticket record was last modified.
Name
keywords
Type
object, nullable
Description
Free-text, comma-separated keywords for searching and filtering tickets.
Name
categories
Type
array of Category
Description
The categories assigned to this ticket. Present only on GET /tickets/{ticket}; absent on the list endpoint GET /tickets.
Name
categories.name
Type
string
Description
Name of the category, shown wherever an entity is tagged with it.
Name
categories.description
Type
object
Description
Longer explanation of what this category should be used for.
Name
categories.type
Type
object
Description
The kind of entity this category can be attached to, e.g. employee, project or customer.

Generated from the OpenAPI specification — edit the source code, not this page.

Tickets GET Get a ticket