GET /v1/spaces/:space_id/tickets/:number
HTTP Verb: GET
Available statuses: 200 OK, 404 Not Found
Object: Ticket
Location: n/a
Formats: XML, JSON
Retrieve a ticket identified by a ticket number. Be careful, do not use a ticket ID as identifier, use ticket numbers instead.
Params
No options available
Examples
Request JSON, using cURL utility:
curl -H "Authorization: Bearer _token" https://api.assembla.com/v1/spaces/_space_id/tickets/_number.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/_number.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>
<id type="integer">10</id>
<number type="integer">8</number>
<summary>A nice ticket</summary>
<description></description>
<state type="integer">1</state>
<status>New</status>
<priority type="integer">1</priority>
<total-working-hours type="float">0.0</total-working-hours>
<milestone-id nil="true"></milestone-id>
<estimate type="float">0.0</estimate>
<notification-list></notification-list>
<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>
<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>
<component-id nil="true"></component-id>
</ticket>
Description for each field: ticket object fields reference