HTTP Verb: GET

Available statuses: 200 OK, 404 Not Found

Object: Ticket

Location: n/a

Formats: XML, JSON

Retrieve a ticket identified by an ID.

Params

No options available

Examples

Request JSON, using cURL utility:

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

Response:

HTTP/1.1 200 OK
Server: nginx/0.8.55
Date: Mon, 18 Jun 2012 11:31:32 GMT
Content-Type: application/json; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Status: 200
...

{
  "id":10,
  "number":8,
  "summary":"A nice ticket",
  "description":"",
  "priority":1,
  "component_id":null,
  "status":"New",
  "state":1,
  "story_importance":0,
  "space_id":"b89TL8MYWr4id7adbNA33N",
  "reporter_id":"bRxpnOMYWr4id7adbNA33N",
  "milestone_id":null,
  "is_story":false,
  "notification_list":"",
  "permission_type":0,
  "completed_date":null,
  "importance":0.0,
  "created_on":"2011-09-02T10:21:48Z",
  "custom_fields":{"Text Field":"","list":""},
  "total_estimate":0.0,
  "total_invested_hours":0.0,
  "updated_at":"2012-04-12T10:32:58Z",
  "total_working_hours":0.0,
  "estimate":0.0,
  "assigned_to_id":null,
  "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 -H "Authorization: Bearer _token" https://api.assembla.com/v1/spaces/_space_id/tickets/id/_id.xml

Response:

HTTP/1.1 200 OK
Server: nginx/0.8.55
Date: Mon, 18 Jun 2012 11:35:32 GMT
Content-Type: application/xml; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Status: 200
...

<?xml version="1.0" encoding="UTF-8"?>
<ticket>
  <total-working-hours type="float">0.0</total-working-hours>
  <state type="integer">1</state>
  <milestone-id nil="true"></milestone-id>
  <summary>That is a new 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>New</status>
  <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>

Description for each field: ticket object fields reference