Skip to main content

Create a ticket

POST /api/v1/support/tickets

Headers

HeaderRequiredDescription
X-Bundle-IDYesApp bundle identifier
X-Team-IDYesApple Developer Team ID

Body

{
  "subject": "App crashes on launch",
  "body": "After updating to v2.1, the app crashes immediately...",
  "submitterId": "user_123",
  "submitterEmail": "user@example.com",
  "deviceHash": "optional"
}
FieldTypeRequiredDescription
subjectstringYes3–200 characters
bodystringYes10–5,000 characters
submitterIdstringYesUser or device identifier
submitterEmailstringNoContact email for replies
deviceHashstringNoDevice hash

Response

Returns the created ticket with messages.

List user’s tickets

GET /api/v1/support/tickets

Query parameters

ParameterTypeRequiredDescription
submitter_idstringYesUser or device identifier

Response

[
  {
    "id": "uuid",
    "subject": "App crashes on launch",
    "status": "open",
    "priority": "normal",
    "messageCount": 3,
    "createdAt": "2025-03-10T12:00:00Z",
    "updatedAt": "2025-03-10T14:00:00Z"
  }
]

Get ticket with messages

GET /api/v1/support/tickets/:ticketId

Response

{
  "id": "uuid",
  "subject": "App crashes on launch",
  "status": "open",
  "priority": "normal",
  "messageCount": 3,
  "createdAt": "2025-03-10T12:00:00Z",
  "messages": [
    {
      "id": "uuid",
      "ticketId": "uuid",
      "authorType": "user",
      "body": "After updating to v2.1...",
      "createdAt": "2025-03-10T12:00:00Z"
    },
    {
      "id": "uuid",
      "ticketId": "uuid",
      "authorType": "admin",
      "body": "Thanks for reporting. Can you share your device model?",
      "createdAt": "2025-03-10T13:00:00Z"
    }
  ]
}

Reply to a ticket

POST /api/v1/support/tickets/:ticketId/messages

Body

{
  "authorId": "user_123",
  "body": "I'm using an iPhone 15 Pro running iOS 18.0."
}

Response

Returns the created message object.