How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Refurbed OrderService API

The OrderService API from Refurbed — 13 operation(s) for orderservice.

Refurbed OrderService API is one of 18 APIs that Refurbed publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include OrderService. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 13 operations across 13 paths, and defines 75 schemas. It is described by OpenAPI 3.2.0, at version 1.0.

Requests are made against a single base URL, https://api.refurbed.com.

13 operations 13 paths 75 schemas 13 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0
Base URL
https://api.refurbed.com
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Refurbed OrderService 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 13

Across 13 paths, the API surfaces 13 operations — 13 POST. Each is listed below with its method, path, parameters, and response codes.

OrderService 13
POST
/refb.merchant.v1.OrderService/CalculateRefundOrder
Calculate values for a refund of all refundable items of an order at once, i.e.
CalculateRefundOrder body → 200default
POST
/refb.merchant.v1.OrderService/CreateShippingLabel
Creates shipping label for an order
CreateShippingLabel body → 200default
POST
/refb.merchant.v1.OrderService/DeleteOrderCommercialInvoice
Deletes the previously uploaded commercial invoice for an order
DeleteOrderCommercialInvoice body → 200default
POST
/refb.merchant.v1.OrderService/DeleteOrderInvoice
Deletes the order's invoice. Order needs to be invoiceable
DeleteOrderInvoice body → 200default
POST
/refb.merchant.v1.OrderService/GetOrder
Gets a single order using its identifier
GetOrder body → 200default
POST
/refb.merchant.v1.OrderService/GetOrderCommercialInvoice
Returns the previously uploaded commercial invoice for an order
GetOrderCommercialInvoice body → 200default
POST
/refb.merchant.v1.OrderService/GetOrderInvoice
Gets the order's invoice. The URL access token is valid for 24h
GetOrderInvoice body → 200default
POST
/refb.merchant.v1.OrderService/ListOrders
Lists orders
ListOrders body → 200default
POST
/refb.merchant.v1.OrderService/ListShippingLabels
Lists shipping labels for an order
ListShippingLabels body → 200default
POST
/refb.merchant.v1.OrderService/RefundOrder
Refunds all refundable items of an order at once
RefundOrder body → 200default
POST
/refb.merchant.v1.OrderService/SetOrderInvoiceStream
Uploads an invoice for an order
SetOrderInvoiceStream body → 200default
POST
/refb.merchant.v1.OrderService/UpdateShippingLabelAddress
Updates the shipping label address for an order
UpdateShippingLabelAddress body → 200default
POST
/refb.merchant.v1.OrderService/UploadOrderCommercialInvoice
Uploads a commercial invoice for an order
UploadOrderCommercialInvoice body → 200default

Schemas 75

The contract defines 75 schemas that model the data the API accepts and returns. The most detailed are OrderItem (40 properties), ListOrdersRequest.Filter (28 properties), Order (27 properties), MerchantAddress (14 properties). Each schema is shown below with its type and property counts.

GetOrderResponse
object
1 property
CountryCodeFilter
object
2 properties
GetOrderInvoiceResponse
object
1 property
PaymentMethod
string
RefundEligibility
string
- ELIGIBLE: Refunds are allowed. - INELIGIBLEUNKNOWN: Refunds are not allowed for an unspecified reason. - INELIGIBLEPERIODEXPIRED: Refunds are not allowed bec…
Order
object
An order.
27 properties
CurrencyCode
string
Currency codes as specified in ISO 4217. - AED: XTS = 963; // Code reserved for testing purposes.
CreateShippingLabelRequest
object
4 properties 3 required
UpdateShippingLabelAddressResponse
object
1 property
UploadOrderCommercialInvoiceResponse
object
3 properties
GetOrderInvoiceRequest
object
1 property 1 required
Int64Pagination
object
Paginates resources with int64 primary key.
3 properties
NumericRangeFilter
object
Numeric range filter is used for decimal numbers. It is especially used for monetary amounts and other quantities where exactness is required.
6 properties
GetOrderCommercialInvoiceResponse
object
2 properties
v1.Address
object
13 properties
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
OrderItemShipmentStatus
string
- INFORECEIVED: Carrier has received request from shipper and is about to pick up the shipment. - INTRANSIT: Carrier has accepted or picked up shipment from sh…
OrderItem
object
An order item.
40 properties
OfferGrading
string
The grading of the item being sold. Please consult the refurbed seller guide and quality charta to learn about refurbed's grading requirements.
ListOrdersRequest.Filter
object
28 properties
UpdateShippingLabelAddressRequest
object
2 properties 1 required
UpdateShippingLabelAddressRequest.Address
object
10 properties 6 required
OrderItemIdentifier
object
2 properties
CarrierEnum.Carrier
string
BatteryCondition
string
SetOrderInvoiceRequest.Meta
object
1 property 1 required
SetOrderInvoiceRequest
array
Send first message with Meta set, then other messages with chunked data to stream. Max total data size is 2MB (2 1024^2 bytes).
2 properties
OfferSKUFilter
object
3 properties
UploadOrderCommercialInvoiceRequest.Meta
object
2 properties 2 required
SetOrderInvoiceResponse
object
3 properties
GetOrderCommercialInvoiceRequest
object
1 property 1 required
MerchantAddress
object
MerchantAddress is the address from which the merchant dispatches shipments. Used as the merchant's shipping address in the context of shipping label creation.
14 properties
ListOrdersResponse
object
2 properties
RefundOrderResponse
object
6 properties
OrderAddressPhoneNumberFilter
object
2 properties
TimestampRangeFilter
object
6 properties
RefundOrderRequest
object
1 property 1 required
CountryCode
string
Alpha-2 country codes as specified in ISO 3166-1.
OrderCustomerEmailFilter
object
2 properties
ListOrdersRequest.Sort.By
string
ShippingLabel
object
ShippingLabel represents a shipping label for parcel.
6 properties
ListShippingLabelsRequest
object
1 property 1 required
GetOrderRequest
object
1 property 1 required
OrderLabelCollectionFilter
object
3 properties
OrderAddressFilter
object
1 property
ListOrdersRequest
object
3 properties
CurrencyCodeFilter
object
2 properties
OrderItemIdentifierType
string
ListShippingLabelsResponse
object
1 property
AddressEntityFilter
object
2 properties
CalculateRefundOrderResponse
object
6 properties
SortOrder
string
NormalPrinterURLs
object
4 properties
OrderState
string
Order states are calculated based on the individual order item states. - NEW: Order was not handled yet. At least one order item has state NEW. - REJECTED: Ord…
ListOrdersRequest.Filter.OrderItemNameFilter
object
1 property
OfferWarranty
string
The warranty the merchant provides to the customer. Only 12 months is supported. - M12: 12 months. - M18: 18 months, deprecated. Only 12 months is supported fo…
OrderItemShipmentSubstatus
string
- INFORECEIVED: The carrier received a request from the shipper and is about to pick up the shipment. - LABELCREATEDNOUPDATESYET: The order has been processed/…
CreateShippingLabelResponse
object
1 property
TrackingData
object
3 properties
OrderAddressVATINFilter
object
2 properties
DeleteOrderCommercialInvoiceRequest
object
1 property 1 required
Int64Filter
object
2 properties
OrderItemState
string
- NEW: Order item was not handled yet. Next states: REJECTED, CANCELLED or ACCEPTED. - REJECTED: Order item cannot be fulfilled. Final state. - CANCELLED: Orde…
CalculateRefundOrderRequest
object
1 property 1 required
UploadOrderCommercialInvoiceRequest
array
Send first message with Meta set, then other messages with chunked data to stream. Max total data size is 2MB (2 1024^2 bytes).
2 properties
OrderLabel
string
Labels are additional indicators set next to the order state. They can be filtered by. - PROCESSING: Set if the items' states of an order are neither all state…
ListOrdersRequest.Sort
object
2 properties
AddressEntity
string
BoolFilter
object
1 property
OrderItemTaxation
string
OrderStateFilter
object
2 properties
OfferData
object
9 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
DeleteOrderInvoiceRequest
object
1 property 1 required
MerchantAddressType
string

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

refurbed-orderservice-api-openapi.yml Raw ↑

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
Where this information came from

This is an independent, third-party profile of Refurbed OrderService API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.