Refurbed TicketService API
The TicketService API from Refurbed — 10 operation(s) for ticketservice.
Refurbed TicketService API is one of 18 APIs that Refurbed publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include TicketService. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.
This API exposes 10 operations across 10 paths, and defines 59 schemas. It is described by OpenAPI 2.0, at version 1.0.
Requests are made against the base URL https://api.refurbed.com.
10 operations
10 paths
59 schemas
10 POST
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 1
Refurbed TicketService API declares
1 security scheme
for authenticating requests.
An API key is passed in the header as Authorization (APIKeyAuth).
By default, every request must be authenticated.
Paths & Operations 10
Across 10 paths, the API surfaces 10 operations — 10 POST. Each is listed below with its method, path, parameters, and response codes.
TicketService 10
POST
/refb.merchant.v1.TicketService/CreateTicket
Creates a new ticket.
POST
/refb.merchant.v1.TicketService/CreateTicketHelpRequest
Creates a help request for a given ticket.
POST
/refb.merchant.v1.TicketService/GenerateReturnShippingLabel
Generates a return shipping label and posts it as a message on the ticket. Call GetTicket to load the ticket messages again.
POST
/refb.merchant.v1.TicketService/GetTicket
Retrieves a single ticket by its ID, including its messages.
POST
/refb.merchant.v1.TicketService/GetTicketHelpRequest
Retrieves details of a single help request by its ID, including the messages.
POST
/refb.merchant.v1.TicketService/ListTicketHelpRequests
Lists all help requests for a given ticket.
POST
/refb.merchant.v1.TicketService/ListTickets
Lists tickets.
POST
/refb.merchant.v1.TicketService/RequestTopicChange
Requests a topic change for a ticket. If request is approved, the ticket topic is changed to a generic topic, the caller does not specify the desired topic.
POST
/refb.merchant.v1.TicketService/UpdateTicket
Updates the ticket by performing one or more of the following actions: - Assigning the ticket to a user (by email) - Changing the ticket status - Adding a message to the ticket - Updating the notes
POST
/refb.merchant.v1.TicketService/UpdateTicketHelpRequest
Updates the ticket help request by adding a message to it.
Schemas 59
The contract defines 59 schemas that model the data the API accepts and returns. The most detailed are Ticket (18 properties), ListTicketsRequest.Filter (16 properties), UpdateTicketRequest (6 properties), CreateTicketRequest (5 properties). Each schema is shown below with its type and property counts.
ScopedTicketMessage
object
Represents a ticket message with a scope of visibility.
2 properties
SubmittableTicketStatus
string
TicketMessageSubmission
object
Represents a message to be submitted to a ticket when creating a new ticket or adding a message to an existing ticket. Also used for creating messages within t…
2 properties
1 required
ScopedMessageSubmission
object
2 properties
SlaCheckpoint
object
2 properties
StringSetContainsFilter
object
3 properties
Int64Pagination
object
Paginates resources with int64 primary key.
3 properties
StringEqualsFilter
object
1 property
TicketUrgencyStatus
string
- PANIC: Refurbed customer service is monitoring each update and will support you and the customer if need be. - URGENT: The ticket has been escalated to refur…
CreateTicketHelpRequestRequest
object
3 properties
1 required
TicketTopicChangeRequestAttachmentExemptionReason
string
TicketUrgencyStatusFilter
object
2 properties
GetTicketResponse
object
2 properties
ListTicketsResponse
object
2 properties
Customer
object
2 properties
BoolFilter
object
1 property
TicketMessageSubmission.Attachment
object
2 properties
2 required
CreateTicketHelpRequestResponse
object
2 properties
MarketplaceOrderItem
object
3 properties
ListTicketsRequest
object
3 properties
Author
object
3 properties
RequestTopicChangeResponse
object
2 properties
TicketSlaCheckpointType
string
- AWAITINGREPLYSINCE: The time since when the SLA timer starts (e.g., customer or refurbed agent response). - OVERDUE: The time when the ticket passes its SLA…
GenerateReturnShippingLabelRequest
object
1 property
1 required
UpdateTicketHelpRequestRequest
object
3 properties
2 required
CountryCodeFilter
object
2 properties
ListTicketsRequest.Sort.By
string
Any
object
Any contains an arbitrary serialized protocol buffer message along with a URL that describes the type of the serialized message. Protobuf library provides supp…
1 property
TicketMessageSenderType
string
GetTicketRequest
object
1 property
1 required
UpdateTicketResponse
object
2 properties
ListTicketsRequest.Sort
object
2 properties
SortOrder
string
CountryCode
string
Alpha-2 country codes as specified in ISO 3166-1.
Int64AnyOfFilter
object
1 property
TicketHelpRequestStatus
string
- OPEN: Help request is open, awaiting a response from refurbed. - CLOSED: Help request is permanently closed and immutable. - PENDING: Refurbed has replied; t…
TicketOrderItemIdentifier
object
Used to identify an order item related to a ticket. It could be either a marketplace order item (orderitems.id), or a buyback order item (buybackorderitems.id).
2 properties
CreateTicketResponse
object
2 properties
TicketHelpRequestTopic
string
TicketMessage.Attachment
object
3 properties
Status
object
The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](h…
3 properties
ListTicketsRequest.Filter
object
16 properties
UpdateTicketHelpRequestResponse
object
2 properties
Ticket
object
A customer support ticket. Only stores metadata, such as status, order, etc. Ticket messages can be retrieved only when calling GetTicket.
18 properties
TicketMessageScope
string
- PUBLIC: Messages visible to all parties (merchant, refurbed agents, customer). - INTERNAL: Messages visible only to the merchant and refurbed agents.
Assignee
object
2 properties
RequestTopicChangeRequest
object
3 properties
1 required
TicketHelpRequest
object
A help request associated to a ticket. Created by a merchant to request help from refurbed to assist with handling a ticket.
5 properties
StringFilter
object
2 properties
GetTicketHelpRequestResponse
object
2 properties
Ticket.BuybackOrderItem
object
3 properties
UpdateTicketRequest
object
6 properties
1 required
CreateTicketRequest
object
5 properties
1 required
TicketStatusFilter
object
2 properties
TicketMessage
object
A message belonging to either a ticket or a ticket help request. Contains the message body, attachments, as well as information about the author of the message.
5 properties
ListTicketHelpRequestsRequest
object
1 property
1 required
TicketStatus
string
ListTicketHelpRequestsResponse
object
1 property
GetTicketHelpRequestRequest
object
2 properties
2 required
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from Refurbed 12
Other APIs Refurbed publishes across the network.
Refurbed BuybackBidService API
Refurbed BuybackOrderItemService API
Refurbed BuybackOrderService API
Refurbed BuybackProductService API
Refurbed BuybackSupplyboxService API
Refurbed CatalogService API
Refurbed CurrencyService API
Refurbed InstanceService API
Refurbed MarketOfferService API
Refurbed MarketService API
Refurbed MerchantService API
Refurbed OfferService API
#TicketService