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. using the RefundOrder method.
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.

CurrencyCodeFilter
object
2 properties
GetOrderInvoiceRequest
object
1 property 1 required
RefundOrderResponse
object
6 properties
AddressEntity
string
UpdateShippingLabelAddressResponse
object
1 property
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
UpdateShippingLabelAddressRequest.Address
object
10 properties 6 required
CountryCodeFilter
object
2 properties
GetOrderResponse
object
1 property
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…
OrderCustomerEmailFilter
object
2 properties
GetOrderRequest
object
1 property 1 required
CarrierEnum.Carrier
string
CreateShippingLabelResponse
object
1 property
ListOrdersRequest
object
3 properties
NormalPrinterURLs
object
4 properties
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
RefundOrderRequest
object
1 property 1 required
SetOrderInvoiceRequest.Meta
object
1 property 1 required
OrderItemTaxation
string
OfferData
object
9 properties
OrderLabelCollectionFilter
object
3 properties
ListOrdersRequest.Filter.OrderItemNameFilter
object
1 property
GetOrderCommercialInvoiceResponse
object
2 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
GetOrderInvoiceResponse
object
1 property
TrackingData
object
3 properties
SetOrderInvoiceResponse
object
3 properties
DeleteOrderCommercialInvoiceRequest
object
1 property 1 required
AddressEntityFilter
object
2 properties
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
OrderAddressVATINFilter
object
2 properties
SortOrder
string
CalculateRefundOrderResponse
object
6 properties
Int64Pagination
object
Paginates resources with int64 primary key.
3 properties
OrderItemIdentifierType
string
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…
UploadOrderCommercialInvoiceRequest.Meta
object
2 properties 2 required
OrderItemIdentifier
object
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…
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.
ListShippingLabelsRequest
object
1 property 1 required
OrderAddressPhoneNumberFilter
object
2 properties
UploadOrderCommercialInvoiceResponse
object
3 properties
RefundEligibility
string
- ELIGIBLE: Refunds are allowed. - INELIGIBLEUNKNOWN: Refunds are not allowed for an unspecified reason. - INELIGIBLEPERIODEXPIRED: Refunds are not allowed bec…
MerchantAddressType
string
OrderItem
object
An order item.
40 properties
BatteryCondition
string
ListShippingLabelsResponse
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…
DeleteOrderInvoiceRequest
object
1 property 1 required
UpdateShippingLabelAddressRequest
object
2 properties 1 required
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…
OrderAddressFilter
object
1 property
CountryCode
string
Alpha-2 country codes as specified in ISO 3166-1.
TimestampRangeFilter
object
6 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
OfferSKUFilter
object
3 properties
ShippingLabel
object
ShippingLabel represents a shipping label for parcel.
6 properties
Int64Filter
object
2 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
v1.Address
object
13 properties
BoolFilter
object
1 property
OrderStateFilter
object
2 properties
ListOrdersRequest.Sort.By
string
CreateShippingLabelRequest
object
4 properties 3 required
ListOrdersRequest.Sort
object
2 properties
PaymentMethod
string
ListOrdersRequest.Filter
object
28 properties
CurrencyCode
string
Currency codes as specified in ISO 4217. - AED: XTS = 963; // Code reserved for testing purposes.
Order
object
An order.
27 properties
ListOrdersResponse
object
2 properties
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/…
CalculateRefundOrderRequest
object
1 property 1 required

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.