Support tickets

List support tickets

Parameters

Request example Try it in the Dashboard

curl -X GET "https://papaproxy.net/account_new/api/v1/customer/tickets" \
  -H "Authorization: Bearer $PAPAPROXY_API_KEY"

import os

import requests

resp = requests.get(
    "https://papaproxy.net/account_new/api/v1/customer/tickets",
    headers={"Authorization": f"Bearer {os.environ['PAPAPROXY_API_KEY']}"},
    timeout=30,
)
resp.raise_for_status()
print(resp.json())

const resp = await fetch("https://papaproxy.net/account_new/api/v1/customer/tickets", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.PAPAPROXY_API_KEY}`,
  },
});
if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
console.log(await resp.json());

<?php
$ch = curl_init('https://papaproxy.net/account_new/api/v1/customer/tickets');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('PAPAPROXY_API_KEY'),
    ],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
var_dump($status, json_decode($response, true));

package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest("GET", "https://papaproxy.net/account_new/api/v1/customer/tickets", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer "+os.Getenv("PAPAPROXY_API_KEY"))
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	data, _ := io.ReadAll(resp.Body)
	fmt.Println(resp.Status, string(data))
}

Responses

• 200 Paginated ticket list. · 12 fields

  Example response · JSONCopy

  {
    "tickets": [
      {
        "id": "25d98664-5d50-59ee-974a-d7dd4773bde9",
        "customer_id": "8218fbc6-d67b-52fd-a639-cca399215d31",
        "subject": "Proxy question",
        "status": "closed",
        "service_id": null,
        "last_message_at": "2026-11-07T14:09:52.876903Z",
        "created_at": "2026-11-07T14:09:52.876903Z",
        "updated_at": "2026-11-07T14:24:19.868992Z"
      }
    ],
    "total": 11,
    "offset": 0,
    "limit": 1
  }

  Field	Type	Description
  tickets required	array of object
  tickets[].id required	string (uuid)	Unique ID.
  tickets[].customer_id required	string (uuid), nullable	ID of your account.
  tickets[].subject required	string	Ticket subject.
  tickets[].status required	string	Ticket status.One of: open, in_progress, waiting, customer_replied, closed
  tickets[].service_id required	string (uuid), nullable	ID of the service.
  tickets[].last_message_at required	string (date-time), nullable	When the last message was posted (ISO 8601, UTC).
  tickets[].created_at required	string (date-time)	When it was created (ISO 8601, UTC).
  tickets[].updated_at required	string (date-time), nullable	When it was last changed (ISO 8601, UTC).
  total required	integer	Total number of items across all pages.
  offset	integer	Number of items skipped.Default: 0
  limit	integer	Page size.Default: 50

• 401 The API key is missing, malformed, revoked, or expired, or the account is inactive.

  Example · JSONCopy

  {
    "detail": "Invalid or revoked API key."
  }

  Error format

• 403 The API key lacks scope tickets:read.

  Example · JSONCopy

  {
    "detail": "API key is missing required scope: tickets:read"
  }

  Error format

• 422 Validation error: a field is missing or has the wrong type or value.

  Example · JSONCopy

  {
    "detail": "Validation error"
  }

  Error format

• 429 Too many requests: the per-account limit is 60 requests per minute, shared by all keys and the MCP server. Retry with exponential backoff.

  Example · JSONCopy

  {
    "detail": "Too Many Requests"
  }

  Error format

Open a support ticket

Request body

Request example Try it in the Dashboard

curl -X POST "https://papaproxy.net/account_new/api/v1/customer/tickets" \
  -H "Authorization: Bearer $PAPAPROXY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"subject": "Proxy question", "message": "Two IPs in my US package time out on HTTPS. Could you check them?"}'

import os

import requests

resp = requests.post(
    "https://papaproxy.net/account_new/api/v1/customer/tickets",
    headers={"Authorization": f"Bearer {os.environ['PAPAPROXY_API_KEY']}"},
    json={
        "subject": "Proxy question",
        "message": "Two IPs in my US package time out on HTTPS. Could you check them?"
    },
    timeout=30,
)
resp.raise_for_status()
print(resp.json())

const resp = await fetch("https://papaproxy.net/account_new/api/v1/customer/tickets", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.PAPAPROXY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "subject": "Proxy question",
    "message": "Two IPs in my US package time out on HTTPS. Could you check them?"
  }),
});
if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
console.log(await resp.json());

<?php
$ch = curl_init('https://papaproxy.net/account_new/api/v1/customer/tickets');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('PAPAPROXY_API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'subject' => 'Proxy question',
        'message' => 'Two IPs in my US package time out on HTTPS. Could you check them?'
    ]),
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
var_dump($status, json_decode($response, true));

package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
	"strings"
)

func main() {
	req, err := http.NewRequest("POST", "https://papaproxy.net/account_new/api/v1/customer/tickets", strings.NewReader(`{"subject": "Proxy question", "message": "Two IPs in my US package time out on HTTPS. Could you check them?"}`))
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer "+os.Getenv("PAPAPROXY_API_KEY"))
	req.Header.Set("Content-Type", "application/json")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	data, _ := io.ReadAll(resp.Body)
	fmt.Println(resp.Status, string(data))
}

Responses

• 201 Ticket with full message history. · 26 fields

  Example response · JSONCopy

  {
    "id": "25d98664-5d50-59ee-974a-d7dd4773bde9",
    "customer_id": "8218fbc6-d67b-52fd-a639-cca399215d31",
    "subject": "Proxy question",
    "status": "closed",
    "service_id": null,
    "last_message_at": "2026-11-07T14:09:52.876903Z",
    "created_at": "2026-11-07T14:09:52.876903Z",
    "updated_at": "2026-11-07T14:24:19.868992Z",
    "messages": [
      {
        "id": "101deaaa-d993-5b5a-8826-13a213959f27",
        "ticket_id": "25d98664-5d50-59ee-974a-d7dd4773bde9",
        "author_kind": "customer",
        "author_id": "8218fbc6-d67b-52fd-a639-cca399215d31",
        "message": "Hi! Two IPs in my US package time out on HTTPS. Could you check them?",
        "created_at": "2026-11-07T14:09:52.876903Z",
        "attachments": [],
        "detected_lang": null,
        "translated_body": null,
        "translation_target": null
      }
    ]
  }

  Field	Type	Description
  id required	string (uuid)	Unique ID.
  customer_id required	string (uuid), nullable	ID of your account.
  subject required	string	Ticket subject.
  status required	string	Ticket status.One of: open, in_progress, waiting, customer_replied, closed
  service_id required	string (uuid), nullable	ID of the service.
  last_message_at required	string (date-time), nullable	When the last message was posted (ISO 8601, UTC).
  created_at required	string (date-time)	When it was created (ISO 8601, UTC).
  updated_at required	string (date-time), nullable	When it was last changed (ISO 8601, UTC).
  messages required	array of object
  messages[].id required	string (uuid)	Unique ID.
  messages[].ticket_id required	string (uuid)
  messages[].author_kind required	string
  messages[].author_id required	string (uuid), nullable
  messages[].message required	string
  messages[].created_at required	string (date-time)	When it was created (ISO 8601, UTC).
  messages[].attachments	array of object	Attached files.
  messages[].attachments[].id required	string (uuid)	Unique ID.
  messages[].attachments[].message_id required	string (uuid)
  messages[].attachments[].uploader_type required	string
  messages[].attachments[].filename required	string	File name.
  messages[].attachments[].content_type required	string	MIME type of the file.
  messages[].attachments[].size required	integer
  messages[].attachments[].created_at required	string (date-time)	When it was created (ISO 8601, UTC).
  messages[].detected_lang	string, nullable
  messages[].translated_body	string, nullable
  messages[].translation_target	string, nullable

• 401 The API key is missing, malformed, revoked, or expired, or the account is inactive.

  Example · JSONCopy

  {
    "detail": "Invalid or revoked API key."
  }

  Error format

• 403 The API key lacks scope tickets:write.

  Example · JSONCopy

  {
    "detail": "API key is missing required scope: tickets:write"
  }

  Error format

• 422 Validation error: a field is missing or has the wrong type or value.

  Example · JSONCopy

  {
    "detail": "Validation error"
  }

  Error format

• 429 Too many requests: the per-account limit is 60 requests per minute, shared by all keys and the MCP server. Retry with exponential backoff.

  Example · JSONCopy

  {
    "detail": "Too Many Requests"
  }

  Error format

Get a support ticket

Parameters

Request example Try it in the Dashboard

curl -X GET "https://papaproxy.net/account_new/api/v1/customer/tickets/3fa85f64-5717-4562-b3fc-2c963f66afa6" \
  -H "Authorization: Bearer $PAPAPROXY_API_KEY"

import os

import requests

resp = requests.get(
    "https://papaproxy.net/account_new/api/v1/customer/tickets/3fa85f64-5717-4562-b3fc-2c963f66afa6",
    headers={"Authorization": f"Bearer {os.environ['PAPAPROXY_API_KEY']}"},
    timeout=30,
)
resp.raise_for_status()
print(resp.json())

const resp = await fetch("https://papaproxy.net/account_new/api/v1/customer/tickets/3fa85f64-5717-4562-b3fc-2c963f66afa6", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.PAPAPROXY_API_KEY}`,
  },
});
if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
console.log(await resp.json());

<?php
$ch = curl_init('https://papaproxy.net/account_new/api/v1/customer/tickets/3fa85f64-5717-4562-b3fc-2c963f66afa6');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('PAPAPROXY_API_KEY'),
    ],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
var_dump($status, json_decode($response, true));

package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest("GET", "https://papaproxy.net/account_new/api/v1/customer/tickets/3fa85f64-5717-4562-b3fc-2c963f66afa6", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer "+os.Getenv("PAPAPROXY_API_KEY"))
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	data, _ := io.ReadAll(resp.Body)
	fmt.Println(resp.Status, string(data))
}

Responses

• 200 Ticket with full message history. · 26 fields

  Example response · JSONCopy

  {
    "id": "25d98664-5d50-59ee-974a-d7dd4773bde9",
    "customer_id": "8218fbc6-d67b-52fd-a639-cca399215d31",
    "subject": "Proxy question",
    "status": "closed",
    "service_id": null,
    "last_message_at": "2026-11-07T14:09:52.876903Z",
    "created_at": "2026-11-07T14:09:52.876903Z",
    "updated_at": "2026-11-07T14:24:19.868992Z",
    "messages": [
      {
        "id": "101deaaa-d993-5b5a-8826-13a213959f27",
        "ticket_id": "25d98664-5d50-59ee-974a-d7dd4773bde9",
        "author_kind": "customer",
        "author_id": "8218fbc6-d67b-52fd-a639-cca399215d31",
        "message": "Hi! Two IPs in my US package time out on HTTPS. Could you check them?",
        "created_at": "2026-11-07T14:09:52.876903Z",
        "attachments": [],
        "detected_lang": null,
        "translated_body": null,
        "translation_target": null
      }
    ]
  }

  Field	Type	Description
  id required	string (uuid)	Unique ID.
  customer_id required	string (uuid), nullable	ID of your account.
  subject required	string	Ticket subject.
  status required	string	Ticket status.One of: open, in_progress, waiting, customer_replied, closed
  service_id required	string (uuid), nullable	ID of the service.
  last_message_at required	string (date-time), nullable	When the last message was posted (ISO 8601, UTC).
  created_at required	string (date-time)	When it was created (ISO 8601, UTC).
  updated_at required	string (date-time), nullable	When it was last changed (ISO 8601, UTC).
  messages required	array of object
  messages[].id required	string (uuid)	Unique ID.
  messages[].ticket_id required	string (uuid)
  messages[].author_kind required	string
  messages[].author_id required	string (uuid), nullable
  messages[].message required	string
  messages[].created_at required	string (date-time)	When it was created (ISO 8601, UTC).
  messages[].attachments	array of object	Attached files.
  messages[].attachments[].id required	string (uuid)	Unique ID.
  messages[].attachments[].message_id required	string (uuid)
  messages[].attachments[].uploader_type required	string
  messages[].attachments[].filename required	string	File name.
  messages[].attachments[].content_type required	string	MIME type of the file.
  messages[].attachments[].size required	integer
  messages[].attachments[].created_at required	string (date-time)	When it was created (ISO 8601, UTC).
  messages[].detected_lang	string, nullable
  messages[].translated_body	string, nullable
  messages[].translation_target	string, nullable

• 401 The API key is missing, malformed, revoked, or expired, or the account is inactive.

  Example · JSONCopy

  {
    "detail": "Invalid or revoked API key."
  }

  Error format

• 403 The API key lacks scope tickets:read.

  Example · JSONCopy

  {
    "detail": "API key is missing required scope: tickets:read"
  }

  Error format

• 404 Ticket not found, or it doesn't belong to your account. — error format
• 422 Validation error: a field is missing or has the wrong type or value.

  Example · JSONCopy

  {
    "detail": "Validation error"
  }

  Error format

• 429 Too many requests: the per-account limit is 60 requests per minute, shared by all keys and the MCP server. Retry with exponential backoff.

  Example · JSONCopy

  {
    "detail": "Too Many Requests"
  }

  Error format

Reply to a support ticket

Parameters

Request body

Request example Try it in the Dashboard

curl -X POST "https://papaproxy.net/account_new/api/v1/customer/tickets/3fa85f64-5717-4562-b3fc-2c963f66afa6/reply" \
  -H "Authorization: Bearer $PAPAPROXY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "Thanks, both IPs work now."}'

import os

import requests

resp = requests.post(
    "https://papaproxy.net/account_new/api/v1/customer/tickets/3fa85f64-5717-4562-b3fc-2c963f66afa6/reply",
    headers={"Authorization": f"Bearer {os.environ['PAPAPROXY_API_KEY']}"},
    json={
        "message": "Thanks, both IPs work now."
    },
    timeout=30,
)
resp.raise_for_status()
print(resp.json())

const resp = await fetch("https://papaproxy.net/account_new/api/v1/customer/tickets/3fa85f64-5717-4562-b3fc-2c963f66afa6/reply", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.PAPAPROXY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "message": "Thanks, both IPs work now."
  }),
});
if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
console.log(await resp.json());

<?php
$ch = curl_init('https://papaproxy.net/account_new/api/v1/customer/tickets/3fa85f64-5717-4562-b3fc-2c963f66afa6/reply');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('PAPAPROXY_API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'message' => 'Thanks, both IPs work now.'
    ]),
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
var_dump($status, json_decode($response, true));

package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
	"strings"
)

func main() {
	req, err := http.NewRequest("POST", "https://papaproxy.net/account_new/api/v1/customer/tickets/3fa85f64-5717-4562-b3fc-2c963f66afa6/reply", strings.NewReader(`{"message": "Thanks, both IPs work now."}`))
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer "+os.Getenv("PAPAPROXY_API_KEY"))
	req.Header.Set("Content-Type", "application/json")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	data, _ := io.ReadAll(resp.Body)
	fmt.Println(resp.Status, string(data))
}

Responses

• 200 Ticket with full message history. · 26 fields

  Example response · JSONCopy

  {
    "id": "25d98664-5d50-59ee-974a-d7dd4773bde9",
    "customer_id": "8218fbc6-d67b-52fd-a639-cca399215d31",
    "subject": "Proxy question",
    "status": "closed",
    "service_id": null,
    "last_message_at": "2026-11-07T14:09:52.876903Z",
    "created_at": "2026-11-07T14:09:52.876903Z",
    "updated_at": "2026-11-07T14:24:19.868992Z",
    "messages": [
      {
        "id": "101deaaa-d993-5b5a-8826-13a213959f27",
        "ticket_id": "25d98664-5d50-59ee-974a-d7dd4773bde9",
        "author_kind": "customer",
        "author_id": "8218fbc6-d67b-52fd-a639-cca399215d31",
        "message": "Hi! Two IPs in my US package time out on HTTPS. Could you check them?",
        "created_at": "2026-11-07T14:09:52.876903Z",
        "attachments": [],
        "detected_lang": null,
        "translated_body": null,
        "translation_target": null
      }
    ]
  }

  Field	Type	Description
  id required	string (uuid)	Unique ID.
  customer_id required	string (uuid), nullable	ID of your account.
  subject required	string	Ticket subject.
  status required	string	Ticket status.One of: open, in_progress, waiting, customer_replied, closed
  service_id required	string (uuid), nullable	ID of the service.
  last_message_at required	string (date-time), nullable	When the last message was posted (ISO 8601, UTC).
  created_at required	string (date-time)	When it was created (ISO 8601, UTC).
  updated_at required	string (date-time), nullable	When it was last changed (ISO 8601, UTC).
  messages required	array of object
  messages[].id required	string (uuid)	Unique ID.
  messages[].ticket_id required	string (uuid)
  messages[].author_kind required	string
  messages[].author_id required	string (uuid), nullable
  messages[].message required	string
  messages[].created_at required	string (date-time)	When it was created (ISO 8601, UTC).
  messages[].attachments	array of object	Attached files.
  messages[].attachments[].id required	string (uuid)	Unique ID.
  messages[].attachments[].message_id required	string (uuid)
  messages[].attachments[].uploader_type required	string
  messages[].attachments[].filename required	string	File name.
  messages[].attachments[].content_type required	string	MIME type of the file.
  messages[].attachments[].size required	integer
  messages[].attachments[].created_at required	string (date-time)	When it was created (ISO 8601, UTC).
  messages[].detected_lang	string, nullable
  messages[].translated_body	string, nullable
  messages[].translation_target	string, nullable

• 400 The ticket is closed.

  Example · JSONCopy

  {
    "detail": "Cannot reply to a closed ticket. Reopen it first."
  }

  Error format

• 401 The API key is missing, malformed, revoked, or expired, or the account is inactive.

  Example · JSONCopy

  {
    "detail": "Invalid or revoked API key."
  }

  Error format

• 403 The API key lacks scope tickets:write.

  Example · JSONCopy

  {
    "detail": "API key is missing required scope: tickets:write"
  }

  Error format

• 404 Ticket not found, or it doesn't belong to your account. — error format
• 422 Validation error: a field is missing or has the wrong type or value.

  Example · JSONCopy

  {
    "detail": "Validation error"
  }

  Error format

• 429 Too many requests: the per-account limit is 60 requests per minute, shared by all keys and the MCP server. Retry with exponential backoff.

  Example · JSONCopy

  {
    "detail": "Too Many Requests"
  }

  Error format