HTTP Verb: GET

Available statuses: 200 OK, 204 No Content, 404 Not Found

Object: Ticket

Location: n/a

Formats: XML, JSON

Returns a paginated list of tickets filter by ticket report.

Params

Param Description
filter[ticket_report] Specify ticket report ID. When no ticket report is specified, tickets from the "Active by Space" report are returned.

Examples

Request XML, using cURL utility:

curl -i -H "Authorization: Bearer _token" -XGET -d "filter[ticket_report]=_ticket_report_id" https://_portfolio_subdomain.api.assembla.com/v1/tickets.xml

Response:

HTTP/1.1 200 OK
Server: nginx/0.8.55
Date: Fri, 07 Sep 2012 13:08:42 GMT
Content-Type: application/xml; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Status: 200
...

<?xml version="1.0" encoding="UTF-8"?>
<tickets type="array">
  <ticket>
    <id type="integer">285</id>
    <number type="integer">1</number>
    <summary>Summary goes here</summary>
    <description>Description goes here</description>
    <priority type="integer">3</priority>
    <completed-date nil="true"></completed-date>
    <component-id nil="true"></component-id>
    <created-on type="datetime">2013-06-14T03:51:29-05:00</created-on>
    <permission-type type="integer">0</permission-type>
    <importance type="float">-1.0</importance>
    <is-story type="boolean">false</is-story>
    <milestone-id type="integer">73</milestone-id>
    <notification-list>dd_iFeDNur4PMj5bfBjDYC</notification-list>
    <space-id>d6_muWDNyr4PMj5bfBjDYC</space-id>
    <state type="integer">1</state>
    <status>New</status>
    <story-importance type="integer">0</story-importance>
    <updated-at type="datetime">2013-06-16T22:38:02-05:00</updated-at>
    <working-hours type="float">0.0</working-hours>
    <estimate type="float">1.0</estimate>
    <total-estimate type="float">1.0</total-estimate>
    <total-invested-hours type="float">0.0</total-invested-hours>
    <total-working-hours type="float">0.0</total-working-hours>
    <assigned-to-id>dd_iFeDNur4PMj5bfBjDYC</assigned-to-id>
    <reporter-id>dd_iFeDNur4PMj5bfBjDYC</reporter-id>
    <custom-fields></custom-fields>
  </ticket>
  ...
</tickets>

Request JSON, using cURL utility:

curl -i -H "Authorization: Bearer _token" -XGET -d "filter[ticket_report]=_ticket_report_id" https://_portfolio_subdomain.api.assembla.com/v1/tickets.json

Response:

HTTP/1.1 200 OK
Server: nginx/0.8.55
Date: Fri, 07 Sep 2012 13:12:30 GMT
Content-Type: application/json; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Status: 200
...

[
  {
    "id": 285,
    "number": 1,
    "summary": "Summary goes here",
    "description": "Description goes here",
    "priority": 3,
    "completed_date": null,
    "component_id": null,
    "created_on": "2013-06-14T03:51:29-05:00",
    "permission_type": 0,
    "importance": -1,
    "is_story": false,
    "milestone_id": 73,
    "notification_list": "dd_iFeDNur4PMj5bfBjDYC",
    "space_id": "d6_muWDNyr4PMj5bfBjDYC",
    "state": 1,
    "status": "New",
    "story_importance": 0,
    "updated_at": "2013-06-16T22:38:02-05:00",
    "working_hours": 0,
    "estimate": 1,
    "total_estimate": 1,
    "total_invested_hours": 0,
    "total_working_hours": 0,
    "assigned_to_id": "dd_iFeDNur4PMj5bfBjDYC",
    "reporter_id": "dd_iFeDNur4PMj5bfBjDYC",
    "custom_fields": {}
  },
  ...
]

JSON is formatted here for readability, in a real response JSON body is inline with no indentation.

Description for each field: Ticket object fields reference