HTTP Verb: GET

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

Object: Ticket

Location: n/a

Formats: XML, JSON

Returns a list of tickets associated with the tag. Be sure to have Tickets Tool attached to your project before using this API.

Params

Param Description
page Parameter to specify which page to request, see per_page to determine how many items per page.
per_page Specify the number of tickets fetched per one page, default is 10.

Examples

Request JSON, using cURL utility:

curl -i -H "Authorization: Bearer _token" https://api.assembla.com/v1/spaces/_space_id/tags/_id/tickets.json

Response

HTTP/1.1 200 OK
Server: nginx/0.8.55
Date: Thu, 19 Jul 2012 11:46:28 GMT
Content-Type: application/json; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Status: 200
...

[
  {
    "number":8,
    "custom_fields":{"Text Field":"","list":""},
    "total_estimate":0.0,
    "priority":1,
    "component_id":null,
    "story_importance":0,
    "space_id":"b89TL8MYWr4id7adbNA33N",
    "reporter_id":"bRxpnOMYWr4id7adbNA33N",
    "milestone_id":null,
    "status":1,
    "is_story":false,
    "notification_list":"",
    "permission_type":0,
    "description":"",
    "completed_date":null,
    "importance":0.0,
    "created_on":"2011-09-02T10:21:48Z",
    "total_invested_hours":0.0,
    "updated_at":"2012-04-12T10:32:58Z",
    "summary":"My ticket",
    "total_working_hours":0.0,
    "estimate":0.0,
    "id":10,
    "assigned_to_id":null,
    "status_name":"New",
    "working_hours":0.0
  },
  ...
]

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

Request XML, using cURL utility:

curl -i -H "Authorization: Bearer _token" https://api.assembla.com/v1/spaces/_space_id/tags/_id/tickets.xml

Response

HTTP/1.1 200 OK
Server: nginx/0.8.55
Date: Thu, 19 Jul 2012 11:44:49 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>
    <total-working-hours type="float">0.0</total-working-hours>
    <status type="integer">1</status>
    <milestone-id nil="true"></milestone-id>
    <summary>My ticket</summary>
    <estimate type="float">0.0</estimate>
    <notification-list></notification-list>
    <description></description>
    <is-story type="boolean">false</is-story>
    <reporter-id>bRxpnOMYWr4id7adbNA33N</reporter-id>
    <space-id>b89TL8MYWr4id7adbNA33N</space-id>
    <permission-type type="integer">0</permission-type>
    <assigned-to-id nil="true"></assigned-to-id>
    <updated-at type="datetime">2012-04-12T10:32:58Z</updated-at>
    <story-importance type="integer">0</story-importance>
    <total-invested-hours type="float">0.0</total-invested-hours>
    <total-estimate type="float">0.0</total-estimate>
    <working-hours type="float">0.0</working-hours>
    <status-name>New</status-name>
    <created-on type="datetime">2011-09-02T10:21:48Z</created-on>
    <custom-fields>
      <Text-Field></Text-Field>
      <list></list>
    </custom-fields>
    <importance type="float">0.0</importance>
    <completed-date nil="true"></completed-date>
    <id type="integer">10</id>
    <component-id nil="true"></component-id>
    <priority type="integer">1</priority>
    <number type="integer">8</number>
  </ticket>
  ...
</tickets>

Description for each field: ticket object fields reference